Domande frequenti sul database dei comuni italiani
Tutto quello che conviene sapere prima di acquistare: cosa c'è dentro, in che formati arriva, ogni quanto si aggiorna e come funzionano licenze e fatturazione. Se resta un dubbio, scrivici.
Contenuto e copertura
Quali dati sono inclusi nel database dei comuni italiani?
Per ogni comune trovi: denominazione, codice ISTAT (attuale e storico), codice catastale Belfiore, CAP, prefisso telefonico, sito web istituzionale, contatti (PEC, email, telefono), santo patrono e festa patronale, coordinate geografiche, altitudine e superficie, popolazione (con densità e grado di urbanizzazione), zona climatica, sismica e altimetrica. Nei piani Pro e Full trovi anche le frazioni e località abitate; nel piano Full anche l'irraggiamento solare mensile dal 2014 al 2023. I dati sono organizzati su tre livelli relazionati: regioni, province e comuni.
Quanti comuni, province e regioni copre?
Il database copre tutti i comuni italiani attualmente attivi, le 107 province e le 20 regioni, oltre allo storico dei comuni soppressi a partire dal 1861 e a più di 69.000 frazioni e località abitate (piani Pro e Full).
Troverò anche lo storico dei comuni soppressi?
Sì, lo storico delle variazioni territoriali a partire dal 1861 è incluso a partire dal piano Standard. È fondamentale per la retrocompatibilità: ad esempio, per riconoscere un comune che oggi è stato fuso in una nuova entità ma che un utente potrebbe ancora indicare con il vecchio nome.
Il database include le frazioni e le località abitate?
Sì, nei piani Pro e Full: oltre alle frazioni trovi nuclei abitati e località produttive, ciascuna legata al proprio comune con popolazione, altitudine e coordinate. Il piano Standard si ferma al livello comunale.
Ci sono la zona climatica e la zona sismica di ogni comune?
Sì, nei piani Pro e Full. Per ogni comune trovi la fascia climatica da A a F con i gradi giorno, la classificazione sismica da 1 a 4, la zona altimetrica e i flag di territorio litoraneo, isolano e montano.
Sono inclusi i codici degli stati esteri per il codice fiscale?
Sì, una tabella dedicata contiene i codici degli stati esteri usati nel codice fiscale di chi è nato fuori dall'Italia, con denominazione italiana e inglese e i codici ISO.
Quali sono i comuni italiani con più di un CAP?
Sono le città grandi, dove il codice di avviamento postale cambia per zona. Nel database ogni abbinamento comune-CAP è una riga a sé, sempre legata allo stesso codice ISTAT: puoi raggrupparle o espanderle come preferisci, senza dover interpretare un campo con più valori dentro.
Formati e integrazione
In che formato ricevo i dati e con quali database è compatibile?
Il pacchetto include 5 formati: dump SQL nativi per MySQL/MariaDB e in dialetto ANSI standard per PostgreSQL e SQL Server, un file SQLite pronto all'uso per app embedded e mobile, fogli Excel (.xlsx), JSON con documenti annidati per comune, provincia e regione, e CSV con un file per tabella. La Demo gratuita contiene un estratto in Excel, CSV e JSON; i formati SQL e SQLite sono disponibili nei piani a pagamento. Ogni dump è pulito e standard, con chiavi e relazioni già configurate: ti basta importarlo.
Posso integrare il database nel mio software o e-commerce?
Sì, con un piano a licenza commerciale (Pro o Full) puoi integrare i dati in applicazioni, e-commerce, gestionali e servizi destinati alla tua attività o ai tuoi clienti. Non è invece consentito rivendere o ridistribuire il database come prodotto autonomo.
Come importo il database in MySQL?
Il pacchetto contiene un dump SQL con schema e dati: lo importi con un comando mysql o con qualunque client grafico, e ti ritrovi le tabelle già in relazione fra loro, con le chiavi esterne dichiarate.
Posso usarlo con PostgreSQL, SQL Server o un altro database?
Oltre al dump per MySQL trovi una versione in dialetto ANSI, pensata per essere importata in database diversi con modifiche minime, e un file SQLite già pronto all'uso. Se il tuo motore non digerisce nessuno dei due, restano CSV e JSON, che importa qualunque cosa.
Gli zeri iniziali di CAP e codici ISTAT si perdono aprendo il file in Excel?
No. Nei file Excel quelle colonne sono scritte come testo, quindi un CAP come 00118 resta 00118 e non diventa 118. Nei CSV il dato è racchiuso fra virgolette per lo stesso motivo.
Posso usare il database con Laravel, WordPress, Python o PowerBI?
Sì: il pacchetto non contiene codice né dipendenze, solo dati in formati standard. Un dump SQL entra in qualunque applicazione PHP o Python, il CSV si importa in WordPress con i plugin di importazione, e CSV e JSON sono sorgenti native per PowerBI, Tableau e pandas.
Aggiornamenti
Ogni quanto viene aggiornato il database?
Monitoriamo costantemente le pubblicazioni ufficiali di ISTAT, Agenzia delle Entrate e Poste Italiane e puntiamo a un rilascio settimanale, per recepire fusioni, soppressioni e variazioni di CAP nel minor tempo possibile. Ogni rilascio è disponibile nella tua area riservata: con la licenza perpetua per tutta la vita del prodotto, con l'abbonamento finché resta attivo.
Posso provare prima di acquistare?
Sì. La versione Demo è gratuita e ti permette di scaricare un estratto reale del database per verificarne struttura, formato e qualità prima di scegliere un piano.
Come faccio a sapere cosa è cambiato rispetto alla versione precedente?
Ogni pacchetto contiene un file CHANGELOG.md che elenca, tabella per tabella, quanti record sono stati aggiunti, modificati o rimossi rispetto al rilascio precedente. Serve a capire in un colpo d'occhio se un aggiornamento tocca la parte di dati che usi.
Come verifico che i file scaricati siano integri?
Dentro ogni pacchetto c'è un manifest.json con l'impronta SHA-256 di ogni file e la dimensione attesa. Confrontarle ti dice se il download è arrivato completo, prima ancora di importare qualcosa.
Licenze e fatturazione
Cosa succede quando scade l'abbonamento?
I file che hai già scaricato restano tuoi e puoi continuare a usarli senza limiti di tempo. Alla scadenza si interrompono solo gli aggiornamenti settimanali e le notifiche dei nuovi rilasci: puoi rinnovare in qualsiasi momento a una tariffa agevolata per riprendere a ricevere le versioni aggiornate.
Che differenza c'è tra licenza personale e commerciale?
La licenza personale (piano Standard) copre l'uso in progetti personali, di studio o interni non commerciali. La licenza commerciale (piani Pro e Full) ti autorizza a usare i dati all'interno di prodotti, servizi o software destinati alla tua attività o ai tuoi clienti.
I dati sono legali? Contengono dati personali?
Tutti i dati provengono da fonti pubbliche ufficiali (ISTAT, Agenzia delle Entrate, Poste Italiane) e riguardano enti territoriali, non persone fisiche. Il nostro lavoro consiste nell'aggregare, normalizzare e mettere in relazione queste informazioni in un formato pronto all'uso. Nessun dato personale di cittadini è incluso.
Come funziona la fatturazione?
La fattura è emessa da Lemon Squeezy in qualità di Merchant of Record, non da Evolvify. I prezzi sono indicati IVA esclusa; l'IVA applicabile viene calcolata da Lemon Squeezy in base alla tua residenza fiscale. Al checkout puoi inserire i dati di fatturazione (ragione sociale, indirizzo, partita IVA o codice fiscale) per ricevere una fattura intestata correttamente.
Posso passare a un piano superiore durante l'abbonamento?
Dipende dal tipo di licenza: Se hai un abbonamento ricorrente (mensile o annuale), puoi eseguire l'upgrade dal pannello "Le mie licenze" in qualsiasi momento: Lemon Squeezy calcola automaticamente il credito proporzionale (proration) dei giorni non utilizzati e lo detrae dalla prima fattura del nuovo piano. Se hai acquistato una licenza perpetua (pagamento una tantum), l'upgrade non è automatizzato: contattaci indicando l'ordine corrente e il piano desiderato. In entrambi i casi il downgrade (passaggio a un piano inferiore) non è consentito.
Posso rivendere o ridistribuire il database?
No. La licenza permette di usare i dati dentro i tuoi prodotti, servizi e analisi, anche commerciali con i piani che la includono, ma non di rivendere o ridistribuire il database come prodotto autonomo.
Serve la partita IVA per acquistare? Posso avere la fattura intestata all'azienda?
La partita IVA non è obbligatoria. Al momento del pagamento puoi inserire i dati di fatturazione, partita IVA compresa: la fattura la emette Lemon Squeezy, che agisce come Merchant of Record e applica il regime IVA corretto per il tuo Paese.
Cosa succede se trovo un errore nei dati?
Scrivici indicando il comune e il campo: se l'errore è nostro lo correggiamo nel rilascio successivo, se invece è nella pubblicazione ufficiale te lo diciamo, perché il database riporta le fonti senza correggerle di iniziativa propria.
Rimane un dubbio?
Scarica la demo e guarda i dati con i tuoi occhi, oppure scrivici: rispondiamo noi, non un modulo.