pyrentri 0.1.0__tar.gz

pyrentri-0.1.0/.gitignore

@@ -0,0 +1,236 @@
+
+# Created by https://www.toptal.com/developers/gitignore/api/python,pycharm+all
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,pycharm+all
+
+### PyCharm+all ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### PyCharm+all Patch ###
+# Ignores the whole .idea folder and all .iml files
+# See https://github.com/joeblau/gitignore.io/issues/186 and https://github.com/joeblau/gitignore.io/issues/360
+
+.idea/
+
+# Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-249601023
+
+*.iml
+modules.xml
+.idea/misc.xml
+*.ipr
+
+# Sonarlint plugin
+.idea/sonarlint
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+pytestdebug.log
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+doc/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# End of https://www.toptal.com/developers/gitignore/api/python,pycharm+all
+
+config.ini
+main2.py
+*.p12
+*.cer
+.pypirc

pyrentri-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Antonio Porcelli (Progressify)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyrentri-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: pyrentri
+Version: 0.1.0
+Summary: Simple API Wrapper for RENTRI (Registro Elettronico Nazionale per la Tracciabilità dei Rifiuti)
+Home-page: https://github.com/progressify/pyrentri
+Author: Progressify
+Author-email: antonio@progressify.dev
+License: MIT
+Keywords: rentri,api,sdk
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: configparser
+Requires-Dist: requests
+Requires-Dist: cryptography
+Requires-Dist: PyJWT
+Dynamic: license-file
+
+<img src="https://progressify.dev/img/progressify-logo.png" alt="logo" height="120" align="right" />
+
+# pyrentri
+
+**A lightweight Python wrapper for the Italian RENTRI API (Registro Elettronico Nazionale per la Tracciabilità dei Rifiuti).**
+
+[![PyPI version](https://img.shields.io/pypi/v/pyrentri.svg)](https://pypi.org/project/pyrentri/)
+[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/progressify/pyrentri/graphs/commit-activity)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Paypal Donate](https://img.shields.io/badge/PayPal-Donate%20to%20Author-blue.svg)](https://www.paypal.me/progressify) 
+[![Satispay Donate](https://img.shields.io/badge/Satispay-Donate%20to%20Author-red.svg)](https://tag.satispay.com/progressify) 
+[![Ask Me Anything !](https://img.shields.io/badge/Ask%20me-anything-1abc9c.svg)](https://github.com/progressify/pyrentri/issues)
+
+---
+
+🌐 **Languages / Lingue**: **🇬🇧 English** | [🇮🇹 Leggi in Italiano](https://github.com/progressify/pyrentri/blob/master/README.it.md)
+
+---
+
+## ⚠️ Important Disclaimer & Library Scope
+
+> **`pyrentri` is an authentication and transport bridge, NOT a replacement for the official RENTRI platform or its data specifications.**
+>
+> - **What this library DOES**: It automates the complex security and cryptographic workflow required by RENTRI. It handles `.p12` (PKCS#12) certificate parsing (RSA and Elliptic Curve), generates signed JWT tokens with certificate chains (`x5c`), computes SHA-256 payload digests for `signed_headers`, and simplifies HTTP communication.
+> - **What this library DOES NOT do**: It does **not** validate, construct, or alter business payloads (e.g., FIR forms, waste registry movements). As a developer, you must consult the [official RENTRI documentation](https://demoapi.rentri.gov.it/docs?page=home#lista-dei-servizi-di-interoperabilit-resi-disponibili-tramite-api) and build the request JSON payloads and process responses according to official regulatory standards.
+
+---
+
+## 💡 Background & Origin
+
+This project originated from the practical need to explore, test, and validate the technical specifications and interoperability flows of the RENTRI APIs while supporting a client in designing their internal corporate SDK.
+
+This wrapper was developed independently as a personal sandbox and testing tool to verify API behaviors and the proper interpretation of the official documentation. The open-sourced code is 100% original, served solely for personal aid until its public release, and does not violate any non-disclosure agreements or existing contractual obligations. It is shared with the community to help other developers bypass the initial complexity of RENTRI's cryptographic and authentication layer.
+
+---
+
+## Features
+
+- 🔐 **Automated PKCS#12 Handling**: Reads private keys and X.509 certificates from `.p12` files.
+- ⚡ **Auto-detect Signature Algorithm**: Supports both RSA (`RS256`) and Elliptic Curve (`ES256`) keys.
+- 🛡️ **JWT & Digest Generation**: Formats tokens with the certificate chain (`x5c`) and automatically hashes payload bodies (`SHA-256` digest).
+- 🔄 **Multi-Environment**: Seamlessly switch between Demo/Sandbox (`demoapi.rentri.gov.it`) and Production (`api.rentri.gov.it`).
+- 🔒 **Secure Configuration**: Supports `config.ini` and environment variables (`P12_PASSWORD`) for Docker and cloud deployments.
+
+---
+
+## Installation
+
+Install using `pip`:
+
+```bash
+pip install pyrentri
+```
+
+Or add it to your `requirements.txt`:
+
+```txt
+pyrentri>=0.1.0
+```
+
+You can also install the latest development version directly from GitHub:
+
+```bash
+pip install git+https://github.com/progressify/pyrentri.git
+```
+
+---
+
+## Configuration
+
+`pyrentri` reads its configuration from a `config.ini` file located in your project directory (or a custom path passed to the constructor).
+
+### 1. `config.ini`
+
+Create a `config.ini` file based on the provided template:
+
+```ini
+[RENTRI]
+sandbox = True
+p12_path = ./your_certificate.p12
+p12_password = your_p12_password
+vat_number = 12345678901
+```
+
+- **`sandbox`**: Set to `True` for the demo/testing environment (`demoapi.rentri.gov.it`) or `False` for production (`api.rentri.gov.it`).
+- **`p12_path`**: Path to your PKCS#12 certificate file (`.p12`).
+- **`p12_password`**: Password for your `.p12` file.
+- **`vat_number`**: Fiscal code / VAT number associated with the RENTRI accreditation.
+
+### 2. Environment Variables (Recommended for Production & Docker)
+
+To avoid storing passwords in plain text inside `config.ini`, you can set the `P12_PASSWORD` environment variable. If set, it will override the password defined in the INI file:
+
+```bash
+export P12_PASSWORD="your_secure_password"
+```
+
+---
+
+## Usage
+
+### 1. Initialize the Wrapper
+
+```python
+from pyrentri import RentriWrapper
+
+# Reads config.ini from the current directory
+rentri = RentriWrapper()
+```
+
+### 2. Check Service Status
+
+Verify connection and operational status of a specific RENTRI API service (e.g. `formulari`, `anagrafiche`, `dati-registri`):
+
+```python
+from pyrentri.rentri_enum import RENTRIStatus
+
+status, response = rentri.status_api("formulari")
+
+if status == RENTRIStatus.OK:
+    print("Service is operational:", response)
+elif status == RENTRIStatus.WARNING:
+    print("Service warning:", response)
+else:
+    print("Service error or unavailable:", response)
+```
+
+### 3. Send Authenticated Requests (with JWT & Payload Digest)
+
+When sending requests with a JSON body, RENTRI requires a signed JWT containing a SHA-256 digest of the payload. Use `create_jwt_token` to generate the token and digest, then send the request:
+
+```python
+# 1. Define your business payload according to the official RENTRI specifications
+payload = {
+    "num_iscr_sito": "OP2501KCJ031133-NA0001",
+    "dati_partenza": {
+        # Your form/movement fields here...
+    }
+}
+
+# 2. Generate signed JWT token and SHA-256 digest
+token, digest = rentri.create_jwt_token(content=payload, content_type="application/json")
+
+# 3. Prepare headers
+headers = {
+    "Authorization": f"Bearer {token}",
+    "Agid-JWT-Signature": token,
+    "Digest": digest,
+    "Content-Type": "application/json",
+    "Accept": "application/json, application/problem+json"
+}
+
+# 4. Perform the POST request
+response = rentri.post("/formulari/v1.0/creazione", data=payload, headers=headers)
+print("Response:", response)
+```
+
+Similarly, for `GET` requests:
+
+```python
+# GET request without payload
+token, _ = rentri.create_jwt_token()
+
+headers = {
+    "Authorization": f"Bearer {token}",
+    "Accept": "application/json, application/problem+json"
+}
+
+response = rentri.get("/codifiche/v1.0/lookup/nazioni?lang=it", headers=headers)
+print("Nazioni:", response)
+```
+
+---
+
+## Documentation & Official Resources
+
+- **Official RENTRI API Docs**: [demoapi.rentri.gov.it/docs](https://demoapi.rentri.gov.it/docs?page=home#lista-dei-servizi-di-interoperabilit-resi-disponibili-tramite-api)
+- **Official RENTRI Portal**: [www.rentri.gov.it](https://www.rentri.gov.it)
+
+---
+
+## 💼 Commercial Support & Consulting
+
+Need to integrate the RENTRI APIs into your corporate ERP, custom software, or cloud infrastructure?
+
+I offer specialized technical consulting and tailored development services:
+- Robust architectures for asynchronous batch transmissions and status polling.
+- Secure certificate management and digital signature pipelines in cloud and on-premise environments.
+
+📩 **Get in touch**: send an email to antonio@progressify.dev or visit **[progressify.dev](https://progressify.dev)** to discuss your integration needs.
+
+---
+
+## Author & Support
+
+Developed with ❤️ by **[Antonio Porcelli (Progressify)](https://progressify.dev)**.
+
+If this project helps you or saves you time, please consider supporting its maintenance:
+
+- ☕ [Donate via PayPal](https://www.paypal.me/progressify)
+- 💳 [Donate via Satispay](https://tag.satispay.com/progressify)
+- 💬 [Open an Issue / Ask a Question](https://github.com/progressify/pyrentri/issues)
+
+---
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+

pyrentri-0.1.0/README.it.md

@@ -0,0 +1,211 @@
+<img src="https://progressify.dev/img/progressify-logo.png" alt="logo" height="120" align="right" />
+
+# pyrentri
+
+**Un wrapper Python per l'interoperabilità con le API di RENTRI (Registro Elettronico Nazionale per la Tracciabilità dei Rifiuti).**
+
+[![PyPI version](https://img.shields.io/pypi/v/pyrentri.svg)](https://pypi.org/project/pyrentri/)
+[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/progressify/pyrentri/graphs/commit-activity)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Paypal Donate](https://img.shields.io/badge/PayPal-Donate%20to%20Author-blue.svg)](https://www.paypal.me/progressify) 
+[![Satispay Donate](https://img.shields.io/badge/Satispay-Donate%20to%20Author-red.svg)](https://tag.satispay.com/progressify) 
+[![Ask Me Anything !](https://img.shields.io/badge/Ask%20me-anything-1abc9c.svg)](https://github.com/progressify/pyrentri/issues)
+
+---
+
+🌐 **Lingue / Languages**: [🇬🇧 Read in English](https://github.com/progressify/pyrentri/blob/master/README.md) | **🇮🇹 Italiano**
+
+---
+
+## ⚠️ Disclaimer Importante & Scopo della Libreria
+
+> **`pyrentri` è uno strumento per la gestione dell'autenticazione e del trasporto HTTP, NON un sostituto della piattaforma ufficiale RENTRI né delle sue specifiche sui dati.**
+>
+> - **Cosa FA questa libreria**: Automatizza interamente il complesso flusso di sicurezza e crittografia richiesto dalle specifiche RENTRI. Gestisce l'estrazione e il parsing dei certificati `.p12` (PKCS#12) con supporto per chiavi RSA ed Elliptic Curve, la generazione dei token JWT firmati con la catena di certificati (`x5c`), il calcolo del digest SHA-256 dei payload per gli `signed_headers`, e semplifica le chiamate HTTP verso gli endpoint governativi.
+> - **Cosa NON FA questa libreria**: Non valida, non costruisce e non altera i payload (es. formulari FIR, movimentazioni del registro cronologico). In qualità di sviluppatore, è tuo compito consultare la [documentazione ufficiale di RENTRI](https://demoapi.rentri.gov.it/docs?page=home#lista-dei-servizi-di-interoperabilit-resi-disponibili-tramite-api) e strutturare i payload JSON delle richieste e processare le relative risposte in piena conformità con gli standard normativi.
+
+---
+
+## 💡 Contesto & Origine del Progetto
+
+Questo progetto nasce dall'esigenza pratica di approfondire e testare sul campo le specifiche tecniche e i flussi di interoperabilità delle API di RENTRI, a supporto delle attività di studio e progettazione di un SDK interno per un cliente.
+
+Il presente wrapper è stato realizzato in totale autonomia come strumento personale di ausilio, prototipazione e collaudo per verificare il funzionamento dei servizi e la corretta interpretazione della documentazione ufficiale. Il codice pubblicato è originale al 100%, è stato ad esclusivo uso personale fino al momento della pubblicazione e non viola alcun accordo di riservatezza o vincolo contrattuale in essere. Viene condiviso con la community open source per semplificare a sviluppatori e aziende la gestione del livello crittografico e di autenticazione governativa.
+
+---
+
+## Caratteristiche
+
+- 🔐 **Gestione Automatica PKCS#12**: Estrazione sicura di chiave privata e certificato X.509 da file `.p12`.
+- ⚡ **Riconoscimento Automatico dell'Algoritmo di Firma**: Supporto per chiavi RSA (`RS256`) ed Elliptic Curve (`ES256`).
+- 🛡️ **Generazione Token JWT & Digest**: Composizione automatica dell'header `x5c` con il certificato in Base64 e hashing del body con `SHA-256` per l'integrità dei dati.
+- 🔄 **Supporto Multi-Ambiente**: Passaggio immediato tra ambiente Demo/Sandbox (`demoapi.rentri.gov.it`) e Produzione (`api.rentri.gov.it`).
+- 🔒 **Configurazione Flessibile e Sicura**: Supporto a file `config.ini` e variabile d'ambiente (`P12_PASSWORD`) per l'impiego in container Docker e ambienti cloud.
+
+---
+
+## Installazione
+
+Installazione tramite `pip`:
+
+```bash
+pip install pyrentri
+```
+
+Oppure aggiungendolo al file `requirements.txt`:
+
+```txt
+pyrentri>=0.1.0
+```
+
+È inoltre possibile installare l'ultima versione di sviluppo direttamente da GitHub:
+
+```bash
+pip install git+https://github.com/progressify/pyrentri.git
+```
+
+---
+
+## Configurazione
+
+`pyrentri` legge le credenziali di accesso da un file `config.ini` presente nella cartella di lavoro (o a un percorso personalizzato passato come parametro).
+
+### 1. `config.ini`
+
+Crea un file `config.ini` basandoti sul modello fornito:
+
+```ini
+[RENTRI]
+sandbox = True
+p12_path = ./tuo_certificato.p12
+p12_password = tua_password_p12
+vat_number = 12345678901
+```
+
+- **`sandbox`**: Imposta su `True` per l'ambiente di test/demo (`demoapi.rentri.gov.it`) oppure `False` per l'ambiente di produzione (`api.rentri.gov.it`).
+- **`p12_path`**: Percorso al file del certificato PKCS#12 (`.p12`).
+- **`p12_password`**: Password di protezione del certificato `.p12`.
+- **`vat_number`**: Partita IVA o Codice Fiscale dell'ente/azienda accreditata su RENTRI.
+
+### 2. Variabili d'Ambiente (Consigliato in Produzione e con Docker)
+
+Per evitare di inserire la password in chiaro nel file `config.ini`, puoi impostare la variabile d'ambiente `P12_PASSWORD`. Se presente, avrà la precedenza rispetto alla password indicata nel file INI:
+
+```bash
+export P12_PASSWORD="tua_password_sicura"
+```
+
+---
+
+## Utilizzo
+
+### 1. Inizializzazione del Client
+
+```python
+from pyrentri import RentriWrapper
+
+# Inizializza leggendo config.ini dalla directory corrente
+rentri = RentriWrapper()
+
+# È possibile specificare un percorso alternativo:
+# rentri = RentriWrapper(config_path="/path/to/config/")
+```
+
+### 2. Verifica Stato dei Servizi
+
+Verifica lo stato operativo e la connettività di un servizio RENTRI specifico (es. `formulari`, `anagrafiche`, `dati-registri`):
+
+```python
+from pyrentri.rentri_enum import RENTRIStatus
+
+status, response = rentri.status_api("formulari")
+
+if status == RENTRIStatus.OK:
+    print("Servizio operativo:", response)
+elif status == RENTRIStatus.WARNING:
+    print("Avviso sul servizio:", response)
+else:
+    print("Errore o servizio non disponibile:", response)
+```
+
+### 3. Invio Richieste Autenticate (con JWT e Digest del Payload)
+
+Per le richieste che inviano un payload JSON (es. `POST` o `PUT`), le specifiche RENTRI richiedono un JWT firmato contenente il digest SHA-256 del corpo. Usa `create_jwt_token` per generare token e digest, quindi effettua la chiamata:
+
+```python
+# 1. Definisci il payload secondo le specifiche ufficiali RENTRI
+payload = {
+    "num_iscr_sito": "OP2501KCJ031133-NA0001",
+    "dati_partenza": {
+        # Campi del formulario / movimentazione...
+    }
+}
+
+# 2. Genera il token JWT firmato e il relativo digest SHA-256
+token, digest = rentri.create_jwt_token(content=payload, content_type="application/json")
+
+# 3. Prepara gli header HTTP richiesti
+headers = {
+    "Authorization": f"Bearer {token}",
+    "Agid-JWT-Signature": token,
+    "Digest": digest,
+    "Content-Type": "application/json",
+    "Accept": "application/json, application/problem+json"
+}
+
+# 4. Esegui la richiesta POST
+response = rentri.post("/formulari/v1.0/creazione", data=payload, headers=headers)
+print("Risposta:", response)
+```
+
+Allo stesso modo, per richieste `GET` (senza payload):
+
+```python
+# Richiesta GET senza payload
+token, _ = rentri.create_jwt_token()
+
+headers = {
+    "Authorization": f"Bearer {token}",
+    "Accept": "application/json, application/problem+json"
+}
+
+response = rentri.get("/codifiche/v1.0/lookup/nazioni?lang=it", headers=headers)
+print("Nazioni:", response)
+```
+
+---
+
+## Documentazione & Risorse Ufficiali
+
+- **Documentazione Ufficiale API RENTRI**: [demoapi.rentri.gov.it/docs](https://demoapi.rentri.gov.it/docs?page=home#lista-dei-servizi-di-interoperabilit-resi-disponibili-tramite-api)
+- **Portale Ufficiale RENTRI**: [www.rentri.gov.it](https://www.rentri.gov.it)
+
+---
+
+## 💼 Consulenza & Sviluppo Personalizzato
+
+Hai bisogno di integrare le API di RENTRI all'interno del tuo software gestionale, ERP o nella tua infrastruttura aziendale?
+
+Offro supporto tecnico specializzato e servizi di sviluppo su misura:
+- Architetture per la gestione asincrona delle trasmissioni massive e monitoraggio degli esiti.
+- Gestione della firma digitale e dei certificati in ambienti di produzione e cloud.
+
+📩 **Contattami**: invia un'email a antonio@progressify.dev o visita il sito **[progressify.dev](https://progressify.dev)** per valutare insieme le tue esigenze di integrazione.
+
+---
+
+## Autore & Supporto
+
+Sviluppato con ❤️ da **[Antonio Porcelli (Progressify)](https://progressify.dev)**.
+
+Se questo progetto ti è stato utile o ti ha fatto risparmiare tempo, valuta una donazione per supportarne la manutenzione:
+
+- ☕ [Dona con PayPal](https://www.paypal.me/progressify)
+- 💳 [Dona con Satispay](https://tag.satispay.com/progressify)
+- 💬 [Apri una Segnalazione / Fai una Domanda](https://github.com/progressify/pyrentri/issues)
+
+---
+
+## Licenza
+
+Questo progetto è rilasciato sotto licenza MIT - consulta il file [LICENSE](LICENSE) per i dettagli.