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?
In tutti i piani, per ogni comune: denominazione, anche nella seconda lingua dove c'è; codice ISTAT attuale e storico, con la tabella di raccordo dal 1991; codice catastale, codice fiscale e codice IPA; CAP, PEC, email, telefono, sito e sede; prefisso, santo patrono e nome degli abitanti; comuni confinanti, coordinate, altitudine, superficie e popolazione; codici NUTS, sistema locale del lavoro e area urbana funzionale. C'è anche lo storico dei comuni soppressi dal 1861. I piani Pro e Full aggiungono il territorio e gli enti: frazioni e località, zone climatiche, sismiche e altimetriche, aree interne, comuni montani, rischio idrogeologico, confini in GeoJSON, uffici dei comuni con i loro contatti e codici univoci di fatturazione. Il piano Full aggiunge i dati per l'energia: irraggiamento solare mensile dal 2014, coefficiente C del gas, ambiti tariffari, zone di mercato elettrico, carichi da neve e vento. Regioni, province e comuni sono già collegati fra loro.
Quanti comuni, province e regioni copre?
Il database copre tutti i 7.894 comuni italiani attualmente attivi, le 110 province e città metropolitane 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. Serve a riconoscere un comune che non esiste più perché è stato fuso con altri, ma che un archivio o un utente indica ancora con il vecchio nome: ogni comune soppresso ha il comune che oggi ne ha il territorio e il suo codice catastale, per il codice fiscale di chi ci è nato.
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.
Il database include i comuni confinanti?
Sì, in tutti i piani: per ogni comune trovi i comuni con cui confina, legati dal codice ISTAT e con ogni confine nei due versi, così i vicini di un comune si leggono con un solo filtro. La fonte è Wikidata; i comuni nati da una fusione ereditano i confini dei comuni da cui sono nati.
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 sei flag di territorio: litoraneo, isolano, zona costiera, zona montana, vincoli naturali e vincoli specifici, dalla classificazione ISTAT.
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?
Soprattutto le grandi città, come Roma, Milano, Napoli e Torino, dove il codice di avviamento postale cambia per zona; poi i comuni con frazioni che hanno un CAP proprio e alcuni comuni nati da una fusione. Nel database ogni abbinamento comune-CAP è una riga a sé, sempre legata allo stesso codice ISTAT: puoi raggruppare le righe o tenerle separate, 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 una provincia intera 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 database non accetta nessuno dei due, restano CSV e JSON, che si importano ovunque.
Gli zeri iniziali di CAP e codici ISTAT si perdono aprendo il file in Excel?
Non nei file Excel del pacchetto: quelle colonne sono scritte come testo, quindi un CAP come 00118 resta 00118 e non diventa 118. Nei CSV lo zero c'è, ma Excel lo toglie se apri il file con un doppio clic: importalo da Dati › Da testo/CSV e imposta quelle colonne come testo.
Posso usare il database con Laravel, WordPress, Python o Power BI?
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 Power BI, 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 clienti: con la licenza a vita per tutta la vita del prodotto, con l'abbonamento finché resta attivo.
Come ricevo gli aggiornamenti dopo l'acquisto?
Dalla tua area clienti. Con un abbonamento attivo o una licenza a vita scarichi tutte le release nel pacchetto del tuo piano, anche quelle uscite prima del tuo acquisto; per ogni release vedi cosa è cambiato tabella per tabella; dalla stessa area gestisci rinnovo, passaggio alla licenza a vita e fatture. L'email ti avvisa quando esce un rilascio, l'area lo conserva: niente allegati da cercare nella posta.
Posso provare prima di acquistare?
Sì. La demo è gratuita: contiene tutti i dati di una provincia, con cui verificare struttura, formati 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. Le release uscite mentre l'abbonamento era attivo restano scaricabili; alla scadenza si interrompono gli aggiornamenti e le notifiche dei nuovi rilasci. Il prezzo di rinnovo agevolato vale finché l'abbonamento resta attivo: circa due settimane prima della scadenza ti avvisiamo per email, e dopo la scadenza si riparte con un nuovo acquisto al prezzo del primo anno.
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.
Da dove vengono i dati? Contengono dati personali?
I dati vengono da fonti pubbliche con licenze che ne consentono il riuso, anche commerciale: quasi sempre enti ufficiali come ISTAT, ministeri, IndicePA e ISPRA, e per alcuni campi fonti aperte come Wikidata. Ogni fonte è citata nel file LICENSE del pacchetto. Riguardano comuni ed enti, non persone: degli uffici pubblichiamo i contatti istituzionali, mai i nomi dei responsabili. Il nostro lavoro è riunire, normalizzare e collegare queste informazioni in un formato pronto all'uso.
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?
Sì, quando vuoi, dalla pagina «Il mio piano» dell'area clienti: dall'annuale a un annuale superiore o a un piano a vita, e da un piano a vita a uno superiore. Paghi il nuovo piano meno la parte di quello attuale che non hai ancora usato: per un annuale, la parte dell'ultimo pagamento che copre i giorni rimasti; per un piano a vita, quanto l'hai pagato. Se passi a un annuale, il nuovo abbonamento parte quel giorno; il piano precedente non si rinnova più. Un piano a vita non scade e non si rinnova. Prima di pagare vedi il conto esatto. Non è previsto il passaggio a un piano inferiore.
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 lo correggiamo solo con una prova documentale, come il testo della Gazzetta Ufficiale, e te lo diciamo.
Rimane un dubbio?
Scarica la demo e guarda i dati con i tuoi occhi, oppure scrivici: ti risponde il nostro team.