"Il vostro gestionale ha le API?" - domanda che il consulente IT della tua impresa edile riceve sempre più spesso. Le API REST sono il linguaggio standard con cui i software moderni "parlano" tra loro. Per un'impresa edile che cresce, le API permettono di evitare la duplicazione di lavoro tra sistemi (CRM, paghe, contabilità, BIM, ecc.). Vediamo cosa sono e cosa cercare.
Cosa sono le API REST
Una API (Application Programming Interface) è un insieme di "porte di accesso" del software che permettono ad altri software di:
- Leggere i dati (es. lista cantieri).
- Creare nuovi record (es. nuovo cantiere).
- Modificare dati esistenti (es. aggiornare data fine).
- Cancellare record (es. eliminare cantiere).
REST è uno standard di progettazione delle API basato su HTTP, ampiamente diffuso e semplice da integrare.
Perché un'impresa edile dovrebbe interessarsi
Eviti la duplicazione manuale
Senza API:
- Cliente nuovo → inserito 3 volte (CRM, gestionale cantiere, contabilità).
- Errori di trascrizione: 3-5% del totale.
- Tempo amministrativo: 15-30 min per cliente.
Con API: cliente inserito una volta → propagato automaticamente.
Decisioni data-driven
Aggregando dati di più sistemi via API:
- Margine reale di un cliente: ricavi (CRM) − costi cantiere (Edilgestya) − costi struttura (contabilità).
- Performance commerciale + operativa.
- Trend di lungo periodo cross-system.
Automazione workflow
Eventi in un sistema attivano azioni in altri:
- Cantiere chiuso → fattura emessa nel software contabile.
- Pratica approvata → cantiere creato.
- Operaio assunto → utente creato in tutti i sistemi.
Gli endpoint chiave per impresa edile
Una buona API per gestionale edile dovrebbe esporre:
Cantieri
POST /cantiere/crea: crea nuovo cantiere.GET /cantieri: lista cantieri (con filtri).GET /cantiere/{id}: dettaglio cantiere.PUT /cantiere/{id}: aggiorna cantiere.DELETE /cantiere/{id}: elimina cantiere.
Attività
POST /api/sopralluogo/creaPOST /api/installazione/creaPOST /api/connessione/creaPOST /api/collaudo/crea
Utenti
POST /api/utenti/sincronizza: sincronizzazione utenti dal sistema HR/payroll.GET /api/utenti: lista utenti.
Anagrafiche
POST /api/clienti: crea cliente.GET /api/clienti: lista clienti.POST /api/fornitori: crea fornitore.
Presenze
GET /api/presenze: lista presenze (per export verso paghe).GET /api/presenze/dipendente/{id}: presenze per dipendente.
Magazzino
GET /api/articoli: lista articoli con giacenze.POST /api/movimenti: registra movimento magazzino.
Vedi modulo Integrazione API Edilgestya.
Sicurezza dell'API
Autenticazione
Token Bearer:
- Token generato dal pannello admin.
- Inviato in header
Authorization: Bearer xxx. - Validato server-side.
- Multi-tenant: ogni token legato a un'azienda.
HTTPS obbligatorio
Tutte le chiamate via TLS 1.2+. Niente HTTP plain.
Rate limiting
Limite di chiamate per minuto/ora per token. Protezione contro abusi.
Validazione input
Ogni campo validato:
- Tipi di dato.
- Range valori.
- Formati (data, IBAN, P.IVA).
- Lunghezze stringhe.
Audit log
Ogni chiamata loggata: chi, quando, da dove, cosa, esito. Per troubleshooting e sicurezza.
Casi d'uso reali
Caso 1: integrazione CRM → Edilgestya
Pratica chiusa nel CRM → cantiere creato in Edilgestya. Vedi articolo dedicato.
Caso 2: Edilgestya → software paghe
A fine mese:
- Software paghe chiama
GET /api/presenzecon filtro mese. - Riceve dati strutturati ore lavorate per dipendente.
- Importa per generare cedolini.
Niente più export Excel manuale.
Caso 3: Edilgestya → contabilità
Cantiere chiuso → fattura cliente:
- Edilgestya invia dati cantiere.
- Software contabile genera fattura SDI.
- Tracciabilità bidirezionale.
Caso 4: Edilgestya → BIM
Software BIM (Building Information Modeling) gestisce il modello tridimensionale del progetto:
- Dati cantiere sincronizzati con BIM.
- Avanzamento lavori riflesso nel modello.
- Computi metrici incrociati.
Caso 5: Edilgestya → Power BI / Tableau
Per analytics avanzate:
- Power BI/Tableau si connette via API.
- Pull dati per dashboard analitiche.
- Cross-analysis con altri data source.
Documentazione tecnica
Una buona API deve avere documentazione completa:
- Lista endpoint con metodi HTTP.
- Schema body request/response.
- Esempi in vari linguaggi (PHP, JavaScript, Python).
- Codici di errore documentati.
- Sandbox per test.
Standard di documentazione: OpenAPI/Swagger.
Cosa chiedere al fornitore del gestionale
Prima di acquistare un gestionale edile, verifica:
- Esistenza di API REST documentate.
- Quali endpoint sono disponibili.
- Documentazione tecnica con esempi.
- Sandbox per test.
- Costi: API incluse o a parte?
- Rate limit standard.
- Supporto tecnico per integrazioni.
I moduli Edilgestya correlati
Scopri Edilgestya e API pronte per integrazioni.
