Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/20tab/python-fattureincloud
https://github.com/20tab/python-fattureincloud
Last synced: 21 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/20tab/python-fattureincloud
- Owner: 20tab
- License: mit
- Created: 2021-04-09T22:10:34.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-04-14T21:23:18.000Z (over 3 years ago)
- Last Synced: 2024-11-16T10:06:15.001Z (about 1 month ago)
- Language: Python
- Size: 53.7 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# python-fattureincloud
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)
[![Python package](https://github.com/20tab/python-fattureincloud/actions/workflows/python-package.yml/badge.svg)](https://github.com/20tab/python-fattureincloud/actions/workflows/python-package.yml)
[![codecov](https://codecov.io/gh/20tab/python-fattureincloud/branch/main/graph/badge.svg?token=A229TF8PLG)](https://codecov.io/gh/20tab/python-fattureincloud)> A python wrapper for the [FattureInCloud REST API](https://api.fattureincloud.it/v1/documentation/dist/).
## 📦 Installation
Change directory and create a new project as in this example:
```console
$ pip install python-fattureincloud
```## 🔑 API Credentials
The `FattureInCloudAPI` needs `api_uid` and `api_key` parameters to make requests.
```python
from fattureincloud.client import FattureInCloudAPIclient = 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
```python
# Get all customers
customers = client.clienti().lista()# Get all suppliers
suppliers = client.fornitori().lista()
```### ⚫ Prodotti
```python
# 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`.
```python
# 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
```python
# Get all purchases
acquisti = client.acquisti.lista()acquisti_details = client.acquisti.dettagli(
_id="acquisti_id"
)
```### ⚫ Corrispettivi
```python
# Get all payments
corrispettivi = client.corrispettivi.lista()
```### ⚫ Magazzino
```python
# Get all merchandise
arrivimerce = client.arrivimerce.lista()arrivimerce_details = client.arrivimerce.dettagli(
_id="arrivimerce_id"
)
``````python
# Get all mails
mail = client.mail.lista()
```