facturapi-2.0 0.0.9.11

Facturapi API Client V2

FacturAPI – Python Client Library

Español

This is a Python library for FacturAPI

⚠️Warning: This is still an unofficial library and it is still under development. This is not a final product.⚠️

FacturAPI makes it easy for developers to generate valid Invoices in Mexico (known as Factura Electrónica or CFDI).

This library is based on facturapi-python.

💻 Installation

Just use pip to install de library:

pip  install  facturapi-2.0

🚀 Getting started

Authenticate with your API Key

Be sure to create a free account on FacturAPI and have access to your test or live API keys.

There are two ways to configure your API Key to use the library:

1. Environment variable: Just set an environment variable and the library will automatically use it:

export  FACTURAPI_KEY=YOUR_API_KEY

2. Using the configure method: If you want to set it in the code, you can import and use the configure method:

from facturapi import configure

configure(api_key='YOUR_API_KEY')

Create a customer

After configuring the API Key, you can use the client to perform many actions on the resources, for example to create a Customer:

import facturapi
from facturapi.resources.customers import CustomerRequest, CustomerUpdateRequest

customer = facturapi.Customer.create(data=CustomerRequest(
legal_name='Frida Kahlo',
tax_id='ABCD111111CBA',
email='[e-mail]',
))

For more details on the data used to create a Customer and other resources, be sure to check out the docs.

More examples can be found on the examples directory.

📚 Documentation

You can checkout Facturapi's docs for more info on the API and its resources.

Or checkout the library's docs for usage and more technical details.

Package and distribution

In order to publish the library you must follow the next steps to upload the library to pypi.org

1. Upgrade the library version in setup file: facturapi-python/setup.py
2. Run next command to generate package file: python setup.py sdist
3. Upload tar.gz file: twine upload dist/facturapi_2_0-[version].tar.gz --verbose

💡 Contribute

Found a bug?

Please create an issue addressing the bug and how to replicate it.

Want to contribute?

Be sure to fork the repo and send your PR! Any and all help is appreciated. Also don't forget to keep the coverage above 98%, we love tested code!

Contacts:

• Facturapi: [e-mail]
• Cuenca: [e-mail]
• Kea: [e-mail]