Metadata-Version: 2.1
Name: facturapi-2.0
Version: 0.0.8
Summary: Facturapi API Client V2
Home-page: UNKNOWN
Author: Daniel Hernandez
Author-email: itservices@kea.mx
License: MIT
Description: <p align="center">
            <a href="https://facturapi.io">
                <img alt="Facturapi Logo" src="./docs/images/facturapi-logo.svg" width="200" />
            </a>
        </p>
        <h1 align="center">
            FacturAPI – Python Client Library
        </h1>
        
        ![test](https://github.com/cuenca-mx/facturapi-python/workflows/test/badge.svg)
        [![codecov](https://codecov.io/gh/cuenca-mx/facturapi-python/branch/main/graph/badge.svg?token=U89Q4PR339)](https://codecov.io/gh/cuenca-mx/facturapi-python)
        [![PyPI version](https://badge.fury.io/py/facturapi.svg)](https://badge.fury.io/py/facturapi)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        
        [Español](./README.es-MX.md)
        
        This is a Python library for [FacturAPI](https://www.facturapi.io)
        
        **⚠️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`](https://github.com/cuenca-mx/facturapi-python).
        
        ## 💻 Installation
        
        Just use `pip` to install de library:
        
        ```bash
        pip install facturapi-2.0
        ```
        
        ## 🚀 Getting started
        
        ### Authenticate with your API Key
        Be sure to create a free account on [FacturAPI](https://www.facturapi.io) 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:
           
           ```bash
           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:
        
            ```python
            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:
        
        ```python
        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](http://docs.facturapi.io).
        
        More examples can be found on the [examples](./examples/) directory.
        
        ## 📚 Documentation
        
        You can checkout Facturapi's [docs](http://docs.facturapi.io) for more info on the API and its resources.
        
        Or checkout the library's [docs](https://cuenca-mx.github.io/facturapi-python/) 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:
        - **Facturapi:** contacto@facturapi.io
        
        - **Cuenca:** dev@cuenca.com
        
        - **Kea:** hola@fixat.com
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
