Gestionale condominio con API aperta
Nelle liste di funzioni di un gestionale condominiale compare spesso la voce «API aperta». Per uno studio che non scrive codice sembra una voce da tecnici. Non lo è: decide se i tuoi dati restano chiusi dentro un programma o si possono collegare al resto di quello che usi.
Cosa permette a uno studio
Un'API aperta è un'interfaccia documentata: altri programmi possono leggere e scrivere i dati del gestionale in modo controllato, senza che qualcuno esporti e reimporti un file. In pratica permette di:
- costruire report propri, con i dati che il programma standard non mostra;
- collegare il sito dello studio o un modulo di richiesta all'archivio delle segnalazioni;
- far parlare un chatbot con i dati reali di un condominio;
- collegare dispositivi (citofono, controllo accessi, contatori) e far arrivare il loro stato dove lavora l'amministratore;
- preparare in modo ripetibile l'esportazione per il commercialista;
- ricevere un avviso quando succede qualcosa, per esempio quando cambia lo stato di un pagamento, invece di controllare ogni ora.
Con l'API si collegano gateway di pagamento, banche, dispositivi smart e chatbot; con i sistemi contabili oggi si scambiano file.
Cosa ti costringe a fare un sistema chiuso
In un sistema chiuso ogni collegamento è un'esportazione a mano o una richiesta al fornitore. Ribatti gli stessi numeri nella banca, nel foglio per il commercialista e nell'app, e ogni funzione che manca la aspetti da chi ha il programma. Con un'API ti serve ancora il fornitore per le cose che lui deve fare, ma non per ogni collegamento.
Cosa controllare nell'API di un fornitore
Prima di scegliere, chiedi queste sei cose:
- Documentazione. Esiste, è pubblica, è aggiornata? Un'API senza documentazione è un'API che dipende da una telefonata.
- Chiavi e autenticazione. Come si ottiene l'accesso, a chi lo si dà e come si revoca.
- Limiti. Quante richieste al minuto, quanti dati per volta.
- Notifiche (webhook). Se il sistema ti avvisa quando qualcosa cambia, o devi interrogarlo di continuo.
- Lettura e scrittura. Cosa puoi solo leggere e cosa puoi anche creare o aggiornare.
- Piano. Se l'API è inclusa nel prezzo o si paga a parte.
Come funziona in Unitify
L'accesso API è incluso nel piano Pro; il listino è sulla pagina prezzi. Cosa c'è, in concreto:
- GraphQL e oggetti del dominio. L'API è costruita attorno a oggetti (per esempio contatti, segnalazioni, utenti, fatture), ognuno con le stesse operazioni di base: leggere l'elenco, crearne uno, aggiornarlo. Un oggetto eliminato non sparisce: resta con una data di eliminazione.
- Notifiche sui pagamenti. Quando lo stato di pagamento di una fattura cambia, il tuo sistema può essere avvisato con un webhook firmato con un segreto. L'indirizzo va registrato in un elenco autorizzato, scrivendo all'assistenza.
- Documentazione. Fa parte del nucleo open source (licenza MIT) su cui Unitify è costruito, nel repository github.com/open-condo-software/condo. Per l'elenco esatto di oggetti e operazioni vale la documentazione, non questo articolo.
- Estensioni. Le mini-app possono parlare con l'applicazione principale attraverso gli strumenti per sviluppatori che fanno parte dello stesso nucleo.
Cosa l'API non è
Non è un'integrazione già pronta per ogni sistema. Con i programmi di contabilità oggi si scambiano file; collegare uno specifico sistema è possibile ed è un lavoro di progetto, che valutiamo guardando quale sistema è e quali dati devono passare. I dispositivi si collegano attraverso la loro interfaccia (API, SIP, ONVIF) su progetto, e le integrazioni di pagamento sono quelle già costruite. E l'interfaccia dell'app non è ancora in italiano; l'API, che parla con altri programmi, non ne dipende.
La direzione: un'API per gli edifici
Il nostro fondatore sostiene che gli edifici avranno bisogno di uno strato API aperto, con il consenso del residente, perché un assistente AI possa leggere i dati di una singola unità: saldi, letture dei contatori, stato delle segnalazioni. Oggi, per uno studio, ciò che conta è più semplice: l'API sul piano Pro e la possibilità di non restare chiusi in un programma. Il quadro per l'amministratore italiano è sulla pagina Italia; cosa deve fare un gestionale lo abbiamo messo in fila qui, e le integrazioni da chiedere nel 2026 qui.
Se vuoi capire se l'API serve al tuo studio, prenota una demo e dicci cosa vorresti collegare.
Domande frequenti
Cos'è un'API aperta in un gestionale condominiale?
Un'interfaccia documentata con cui altri programmi leggono e scrivono i dati del gestionale in modo controllato, senza esportazioni a mano. Serve a collegare banca, sito dello studio, chatbot, dispositivi e report propri a un unico archivio.
Serve saper programmare per usarla?
Per usarla direttamente sì, o serve qualcuno che lo sappia fare. Per uno studio il vantaggio è indiretto: i collegamenti con altri sistemi si possono costruire senza aspettare che il fornitore aggiunga una funzione.
L'API di Unitify è inclusa nel piano?
L'accesso API è incluso nel piano Pro. I prezzi sono sulla pagina prezzi.
Cosa devo controllare nell'API di un fornitore?
La documentazione, l'autenticazione e la revoca delle chiavi, i limiti di richieste, se ci sono notifiche (webhook) per i cambiamenti, cosa si può solo leggere e cosa anche scrivere, e se l'API è inclusa nel piano.
L'API di Unitify si collega da sola al mio programma di contabilità?
No. Con i sistemi contabili oggi si scambiano file; l'integrazione con uno specifico sistema è possibile e si valuta sistema per sistema.