Domande frequenti
Risposte brevi. Per i dettagli tecnici c'è la documentazione.
Cos'è OpenTabacchi?
Un servizio indipendente che pubblica come dati aperti, per il software gestionale, le tariffe di vendita al pubblico dei tabacchi lavorati (codice AAMS, denominazione, prezzo) e gli abbinamenti tra codici a barre e codici AAMS. Fonte dei prezzi: Agenzia delle Dogane e dei Monopoli (ADM). Non è affiliato né approvato dall'ADM.
Quanto costa?
L'accesso è gratuito: basta registrarsi con un indirizzo email aziendale e creare una chiave API. Valgono i limiti d'uso e i termini d'uso del servizio.
Serve una password?
No. Si accede con un link inviato per email, valido per pochi minuti e utilizzabile una sola volta. Al primo accesso l'account viene creato.
Posso registrarmi con una casella personale (gmail, outlook, libero)?
No. Per l'accesso serve un indirizzo email aziendale: le caselle personali e gli indirizzi usa e getta non sono ammessi, e chi ne ha già una non può più accedere. Usa l'indirizzo del dominio della tua azienda.
Perché solo 10 letture al giorno?
Perché il dataset è fatto per essere scaricato e conservato nel proprio sistema, non interrogato a ogni vendita. Due chiamate al giorno bastano: una a /v1/version per sapere se c'è una versione nuova e, solo se serve, il download del file.
Le risposte 304 contano come letture?
Sì. Il controllo di cambiamento va fatto confrontando il campo version del manifest, non affidandosi all'ETag.
Quale formato conviene?
JSON se devi importare in un tuo database; SQLite se vuoi un database pronto da interrogare; BLite solo se usi quel database embedded in .NET, e solo dopo aver verificato bliteVersion e schemaVersion nel manifest.
Il prezzo cambia: come lo gestisco?
Ogni prodotto ha priceCents (in vigore oggi) e, se una tariffa futura è già nota, nextPriceCents con nextEffectiveFrom. Alla data di decorrenza viene comunque pubblicata una release con il prezzo già in vigore.
Un prodotto è sparito dalla tariffa: sparisce anche dal dataset?
No. Dopo due tariffari completi consecutivi senza quel codice il prodotto passa allo stato delisted e resta nel dataset con l'ultimo prezzo noto, così le giacenze non perdono il riferimento.
Perché il dataset non ha tutti i codici a barre?
La tariffa ufficiale non li contiene. Si costruiscono con le segnalazioni degli utenti (tre contributori indipendenti d'accordo) e con i caricamenti dei produttori verificati. Più utenti contribuiscono, più l'archivio si completa.
Ho segnalato un codice a barre ma non lo vedo nel dataset. Perché?
Finché non ci sono tre conferme indipendenti resta nello stato to_confirm, visibile solo a chi lo ha inviato tramite /v1/my-submissions. Il tuo software può comunque usarlo in locale.
Posso usare lo stesso account per molti punti vendita?
Sì, se il tuo software scarica il dataset una volta sul server e lo ridistribuisce ai client. Le singole casse non devono chiamare l'API. Per inviare i codici a barre a nome di più negozi serve un account di tipo integrazione, su accordo con il gestore.
Come diventa produttore verificato un'azienda?
Accede con un'email del dominio aziendale e scrive a suppliers@opentabacchi.org dallo stesso indirizzo con ragione sociale, domini, marchi o codici AAMS e un referente. Dopo la verifica manuale l'account viene convertito e può caricare CSV in blocco.
Posso usare i dati per promuovere prodotti?
No. I termini d'uso vietano l'uso dei dati per pubblicità, promozione o marketing di prodotti del tabacco. Il servizio stesso non mostra cataloghi, immagini o contenuti commerciali.
I dati sono ufficiali?
I prezzi provengono dalla tariffa pubblicata dall'ADM, ma il servizio è indipendente e i dati sono forniti senza garanzia: per ogni uso fiscale o commerciale fa fede la pubblicazione ufficiale.
Quali dati personali vengono trattati?
Indirizzo email, impronta delle chiavi API, contatori di utilizzo, segnalazioni di codici a barre e l'indirizzo IP delle richieste di accesso. Un solo cookie tecnico di sessione, nessun tracciamento. Dettagli nell'informativa sulla privacy.