Ogni anno, per motivi amministrativi e demografici, la pubblica amministrazione italiana effettua dei piccoli miglioramenti alle sue strutture "N.U.T.S.". Da un po' di tempo vengono modificate anche le strutture dei comuni. In alcuni casi un comune viene assegnato ad un'altra provincia, in altri la modifica viene fatta sul CAP (codice avviamento postale), per adattarsi alle nuove strutture o in risposta ad una specifica esigenza organizzativa postale. Ad esempio nel 2020 sono state effettuate 6 fusioni di comuni per un totale di 14 comuni aboliti ed è nato un nuovo comune chiamato "Borgo d'Anaunia". Nello stesso anno, a maggio, solo in provincia di Milano (MI) sono state effettuate 40 modifiche ai CAP e, tra le altre città coinvolte, figurano Bari, Cagliari, Catania, Catania, Cesena, Firenze, Livorno, Messina, Milano, Palermo, Parma, Pescara, Reggio Calabria, Rimini, Roma e Trento.

Le modifiche apportate consentono agli utenti un margine di 6 mesi, ma - superato questo periodo - una lettera inviata ad un vecchio codice di avviamento postale o ad un comune ormai non esistente non verrà più recapitata.

Non essendoci un vero e proprio database aperto per questo numero, nasce il nuovo servizio "CAP": https://console.openapi.com/it/apis/cap/documentation
Si tratta di un servizio molto veloce che permette di eseguire una query per Provincia, Regione, Codice Istat, CAP e di ottenere una struttura dettagliata dei comuni italiani e dei relativi codici di avviamento postale associati.

L'utilizzo è semplice come sembra.

Supponendo di cercare tutti i comuni sotto uno specifico CAP (05100 per esempio), è possibile eseguire una query sul servizio in un'unica chiamata GET (una volta ottenuto il gettone al portatore) a https://cap.openapi.it/cap/05100 e si otterrà una risposta come segue:

{
"dati": {
"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": [
"Terni"
],
"dettaglio_comuni": [
{
"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117"
}
]
},
"successo": vero,
"messaggio": "",
"errore": nullo
}

Come si può vedere, sono riportati dati aggiuntivi come "popolazione" e "codice catastale" (aka codice ISTAT).

Ma non finisce qua. Sono diverse le tipologie di servizi di verifica e aggiornamento dati Comuni messi a disposizione da Openapi. Ecco l'elenco completo:

• Cerca Comuni (GET /cerca_comuni) per ottenere il codice ISTAT di qualsiasi città italiana
• Cerca Comuni Base (GET /comuni_base/{istat_code}) per ricavare, a partire dal codice ISTAT, le informazioni base di una città come regione, provincia, CAP
• Cerca Comuni Advance (GET /comuni_advance/{istat_code}) per ottenere, sempre a partire dal codice ISTAT, informazioni più dettagliate rispetto ad una città (es. prefisso, codice fisco, superificie, numero residenti etc)
• Cerca CAP  (GET /cap/{cap}) per ricavare, a partire dal CAP, i seguenti dati corrispondenti: codice ISTAT, Comune, eventuale frazione, provincia, sigla provincia, regione
• Cerca Comuni Soppressi (GET /comuni_soppressi) per accedere all'elenco dei comuni soppressi in una determinate provincia ed informazioni come codice ISTAT, Codice Fiscale, Regione, nome provincia in maniera estesa
• Cerca Città Metropolitane (GET /comuni_metropolitane) che consente di ottenere la lista di tutte le città metropolitane con informazioni quali popolazione, superficie, densità, numero comuni
• Cerca Regioni (GET /regioni) per poter ricavare la lista di tutte le regioni con informazioni quali numero capoluogo, residenti, numero comuni, presidente, codice fiscale, PEC, sito, Sede
• Cerca Province (GET /province) che permette di avere la lista di tutte le province con informazioni come sigla, superficie, residenti, numero comuni e codici istat
• Cerca Province (GET /province/{code} che consente di ottenere informazioni come sigla, superficie, residenti, numero comuni e codici istat di una determinata provincia

I metodi province, regioni, comuni soppressi e metropolitani prevedono 10.000 chiamate / mese gratuite. 

Il miglior utilizzo di questa semplice ma efficace tecnologia è nelle integrazioni di e-commerce, nell'autocompletamento, nella correzione dei dati delle liste di indirizzi, nella postalizzazione e ogni volta che si vuole aggiornare la struttura del database geografico della propria applicazione.

Provate a pensare se un'azienda proprietaria di più e-commerce deve affrontare una semplice modifica del codice di avviamento postale.

I clienti chiamano perché il loro ordine non è mai arrivato, gli incontri con uno sviluppatore sono programmati, diverse applicazioni devono essere aggiornate, sciami di possibili bug si levano all'orizzonte!

Questo non sarà un problema vostro, perché avete capito l'importanza di delegare per tempo, e potete contare sul fatto che le vostre applicazioni sono sempre sincronizzate e aggiornate automaticamente.