Skip to content

20tab/python-fattureincloud

Repository files navigation

python-fattureincloud

Code style: black Python package codecov

A python wrapper for the FattureInCloud REST API.

📦 Installation

Change directory and create a new project as in this example:

$ pip install python-fattureincloud

🔑 API Credentials

The FattureInCloudAPI needs api_uid and api_key parameters to make requests.

from fattureincloud.client import FattureInCloudAPI


client = FattureInCloudAPI(
    api_uid="your_api_uid", 
    api_key="your_api_key"
)

🚀️ Usage

At the moment, only method to read information are implemented. Every model has list method with different parameter to filter results.

For each model there is a set of methods to get a specific element.

⚫ Anagrafica

# Get all customers 
customers = client.clienti().lista()

# Get all suppliers
suppliers = client.fornitori().lista()

⚫ Prodotti

# Get all products 
customers = client.prodotti().lista()

⚫ Documenti

The following example show how you can get all invoices. But you can use all the following document types: fatture, proforma, ordini, preventivi, ndc, ricevute, ddt.

# Get all documents 
invoices = client.fatture().lista()

invoice_details = client.fatture.dettagli(
    _id="invoice_id", 
    token="invoice_token"
)

info = clienti.fatture.info(anno_competenza=2021)

invoice_infomail = client.fatture.infomail(
    _id="invoice_id", 
    token="invoice_token"
)

⚫ Acquisti

# Get all purchases 
acquisti = client.acquisti.lista()

acquisti_details = client.acquisti.dettagli(
    _id="acquisti_id"
)

⚫ Corrispettivi

# Get all payments 
corrispettivi = client.corrispettivi.lista()

⚫ Magazzino

# Get all merchandise 
arrivimerce = client.arrivimerce.lista()

arrivimerce_details = client.arrivimerce.dettagli(
    _id="arrivimerce_id"
)

⚫ Mail

# Get all mails 
mail = client.mail.lista()