Le software house che integrano il catasto partono quasi tutte dalla stessa esigenza: il cliente vuole vedere la particella, la rendita e la zona OMI senza uscire dal gestionale. Da lì in poi ogni progetto diverge, e i tempi dipendono da quanto si spinge l'integrazione.
I tre casi d'uso più frequenti
Il primo è il gestionale immobiliare: scheda immobile arricchita con dati censuari, mappa della particella e valore OMI. Il secondo è il portale di annunci: validazione dell'indirizzo al volo e verifica della consistenza catastale dichiarata. Il terzo è l'app per professionisti, geometri e periti: ricerca su mappa, download del poligono, confronto con i layer di rischio.
Nei nostri 315 token attivi i tre casi pesano in quest'ordine, e il gestionale immobiliare da solo genera più della metà delle 59.564 richieste degli ultimi 30 giorni.
I tempi reali di integrazione
Una prima integrazione di sola lettura, con ricerca particella e geocoding, si chiude in 2-5 giorni lavorativi: autenticazione, due endpoint, gestione errori. L'arricchimento completo della scheda immobile richiede una-due settimane perché entrano in gioco OMI, rischi e demografia, e ognuno ha le sue eccezioni da trattare.
Il collo di bottiglia sta quasi sempre nel modello dati del gestionale. Se il cliente vuole storici, confronti e aggregazioni, serve decidere cosa si salva in locale e cosa si interroga al volo. Noi consigliamo di salvare la geometria e i dati censuari, interrogare i layer di rischio e le quotazioni, che cambiano a semestre.
Quello che nessuno mette in conto
Tre costi nascosti. La normalizzazione degli indirizzi importati dai vecchi archivi: un gestionale con 40.000 immobili ne ha una quota con indirizzi scritti a mano che il geocoding non risolve al primo colpo, e vanno ripuliti. La gestione dei duplicati di particella tra comuni diversi. Il versionamento: quando l'Agenzia aggiorna i dati, il gestionale deve sapere cosa è cambiato rispetto alla sua copia.
Sul lato nostro, la latenza media di 414 ms e il p95 di 730 ms permettono di interrogare in tempo reale senza cache in quasi tutti i flussi. Il 98,8% delle richieste risponde 200: il restante 1,2% è quasi tutto 401 e 429, che il client deve trattare.
Come scegliamo l'architettura
Per volumi sotto le 100.000 chiamate al mese, chiamate dirette con cache leggera. Sopra, una coda di arricchimento asincrona che popola il database locale di notte. Il piano gratuito delle nostre API (1.000 richieste all'ora per token) copre lo sviluppo e i primi clienti, il passaggio a pagamento arriva col volume.
FAQ
Quanto costa integrare il catasto in un gestionale?
Se il gestionale è già strutturato, 2-5 giorni di sviluppo per la parte API. L'arricchimento completo arriva a una-due settimane con i test. I costi dati partono da zero sul piano gratuito.
Posso usare le API per più clienti finali?
Sì, un token per applicazione, con tutti i clienti finali dietro. La licenza commerciale serve se rivendi il dato come servizio autonomo.
Come gestisco gli indirizzi che il geocoding non risolve?
Il geocoding accetta via, civico e comune. Per gli indirizzi storici sporchi conviene un passaggio di pulizia prima, poi il match sul database indirizzi con la ricerca per prefisso.
Le API funzionano anche per i comuni piccoli?
La copertura è nazionale: 85,2 milioni di particelle su 7.899 comuni, dai capoluoghi ai comuni di 200 abitanti.
Vi accompagniamo dal primo endpoint al rilascio, scriveteci quando il progetto parte.
Foto di copertina: Drigo Diniz su Pexels