Cos'è OpenTabacchi e a chi serve
Un archivio tecnico, aggiornato a ogni nuova tariffa, con i prezzi di vendita al pubblico dei tabacchi lavorati e gli abbinamenti tra codici a barre e codici AAMS. Nessuna interfaccia di consultazione: solo dati per il software.
Il problema che risolve
I prezzi di vendita al pubblico dei tabacchi lavorati sono fissati con tariffa pubblicata dall'Agenzia delle Dogane e dei Monopoli (ADM). Ogni prodotto è identificato da un codice AAMS (detto anche codice ADM), un numero intero; la tariffa non riporta i codici a barre stampati sulle confezioni.
Chi sviluppa un software di cassa o di magazzino deve quindi tenere allineato un listino di alcune migliaia di righe a ogni variazione di tariffa e, in più, ricostruire da sé l'abbinamento tra codice a barre e codice AAMS per poter vendere leggendo la confezione. OpenTabacchi fa queste due cose una volta per tutti e le distribuisce in un formato pronto da importare.
Cosa pubblica
- Prodotti in tariffa: codice AAMS, denominazione, categoria, descrizione della confezione, prezzo al chilogrammo e prezzo della confezione in centesimi, prezzo futuro con data di decorrenza, stato (in tariffa o uscito dalla tariffa).
- Codici a barre approvati: codice a barre, codice AAMS, tipo di confezione (pacchetto o stecca/cartone) e numero di pezzi per codice.
- Manifest di versione: la versione corrente, la data della tariffa, i conteggi e gli URL dei file con impronta SHA-256.
Lo schema completo è in Formati e schema dei dati.
A chi serve
- Software di cassa
- Prezzo di vendita corretto alla lettura del codice a barre, con la variazione futura già nota e applicabile dalla data di decorrenza.
- Gestionali e magazzino
- Il codice AAMS come chiave stabile: i prodotti usciti dalla tariffa restano nel dataset con stato
delisted, così le giacenze non perdono il riferimento. - Fatturazione
- Denominazione e prezzo ufficiali per i documenti, senza mantenere a mano un listino.
- Produttori
- Un canale per pubblicare i codici a barre dei propri prodotti in blocco, con approvazione immediata entro il perimetro verificato. Vedi Registrarsi come produttore.
- Integrazioni con più punti vendita
- Un software che serve molti negozi può usare un solo account, scaricare il dataset una volta e inviare i codici a barre raccolti dai suoi clienti.
Come sono distribuiti i dati
Tramite un'API HTTP con chiave, in tre formati equivalenti compressi con gzip: JSON (universale), SQLite (un database pronto da interrogare) e BLite (per chi usa questo database embedded in .NET). Il modello d'uso è il download periodico: si controlla la versione e si scarica il file solo quando cambia. I limiti sono volutamente stretti, 10 letture al giorno per account, perché l'archivio è fatto per essere conservato in locale e non interrogato in tempo reale.
Cosa non fa
- Non mostra un elenco di prodotti sfogliabile, né una ricerca pubblica.
- Non pubblica immagini, loghi o descrizioni commerciali.
- Non promuove prodotti del tabacco in alcuna forma; i termini d'uso vietano di usare i dati a questo scopo.
- Non sostituisce la tariffa ufficiale: per ogni uso fiscale o commerciale fa fede la pubblicazione dell'ADM.
Indipendenza
Fonte dei prezzi: Agenzia delle Dogane e dei Monopoli (ADM). OpenTabacchi è un servizio indipendente, non affiliato né approvato dall'ADM. I dati del gestore sono nella pagina Chi siamo.