Skip to main content

Facturapi API Client V2

Project description

Facturapi Logo

FacturAPI – Python Client Library

test codecov PyPI version Code style: black

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='frida_kahlo@test.com',
))

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.

💡 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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

facturapi-2.0-0.0.7.tar.gz (16.4 kB view details)

Uploaded Source

File details

Details for the file facturapi-2.0-0.0.7.tar.gz.

File metadata

  • Download URL: facturapi-2.0-0.0.7.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.10

File hashes

Hashes for facturapi-2.0-0.0.7.tar.gz
Algorithm Hash digest
SHA256 d5850d6d1ec9771a03aba7a22bfcc9bcd91c44bc1faaddc22131c91e657c28f4
MD5 fe1a75e312e5ea2ed916dc86cbc63130
BLAKE2b-256 69ee29e8166b0146e164ad63aa5bb3a07e9ad67f0313a9df979c68de90c2a05e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page