Integrazione API REST

Integrazione con il tuo CRM o gestionale esistente

Il modulo Integrazione API REST di Edilgestya permette a software esterni (CRM, gestionali, software di pratica come Processi.cloud) di interagire con Edilgestya in modo programmatico. Senza copiare-incollare dati tra sistemi, senza esportazioni Excel, senza mai dover toccare due posti.

Endpoint API disponibili

Cantieri

POST /cantiere/crea

Crea un cantiere automaticamente quando una pratica viene chiusa nel CRM esterno. Body:

{
  "titolo": "Installazione fotovoltaico Rossi",
  "cliente": {
    "nome": "Mario Rossi",
    "telefono": "...",
    "indirizzo": "..."
  },
  "data_inizio": "2026-06-01",
  "valore_stimato": 12500,
  "pratica_id": "PR-2026-1234",
  "azienda_origine": "azienda_xyz",
  "sistema_origine": "processi.cloud"
}

Pianificazione attività

Quattro endpoint per pianificare attività:

• POST /api/sopralluogo/crea — sopralluogo preliminare.
• POST /api/installazione/crea — installazione principale.
• POST /api/connessione/crea — connessione/allacciamento.
• POST /api/collaudo/crea — collaudo finale.

Ognuno accetta:

{
  "cantiere_id": 123,
  "data": "2026-06-15",
  "ora_inizio": "08:00",
  "ora_fine": "17:00",
  "operai": [
    {"email": "marco@azienda.it"},
    {"nome": "Anna", "cognome": "Bianchi"}
  ],
  "note": "Portare gru per piano alto"
}

Sincronizzazione utenti

POST /api/utenti/sincronizza

Aggiorna anagrafica operai quando il CRM esterno modifica i dati personali.

Funzionalità automatiche

Tracciamento origine

Ogni cantiere creato via API mantiene riferimento alla sorgente:

• pratica_id: identificativo nella pratica originale.
• azienda_id: azienda mittente.
• sistema_origine: nome sistema (es. "processi.cloud", "salesforce").

Permette in futuro modifiche bidirezionali coerenti.

Riconoscimento utenti

Quando un'attività viene assegnata via API, il sistema cerca gli operai per:

1. Email (più affidabile).
2. Nome + cognome (fallback).

Se non trova match, NON crea automaticamente l'utente (sicurezza). Restituisce nella risposta:

{
  "ok": true,
  "attivita_id": 456,
  "operai_assegnati": [123, 124],
  "operai_non_trovati": ["Luca Verdi"]
}

Calcolo automatico costi

Quando l'attività viene assegnata via API e gli operai vengono identificati, il calcolo del costo cantiere parte automaticamente. Niente intervento umano.

Sicurezza dell'API

• Bearer Token per autenticazione.
• Validazione input: type-check, regex, ranges.
• Transazioni database: o tutto va a buon fine, o nulla.
• Logging: ogni chiamata loggata con IP, payload, risposta.
• Rate limiting: protezione contro abusi.
• Multi-tenant: ogni token è legato a un'azienda specifica.
• CORS: configurabile per domini autorizzati.

Casi d'uso tipici

CRM → Edilgestya

Quando una pratica viene "vinta" (cliente firma il contratto), il CRM crea automaticamente il cantiere su Edilgestya con tutti i dati del cliente. Niente più "perdita" di clienti tra sistemi.

Software di pratica → Edilgestya

Quando il consulente che gestisce le pratiche edilizie ottiene il permesso, l'attività di installazione viene pianificata automaticamente nel planning operai.

HR/payroll → Edilgestya

Aggiornamento utenti: nuovo dipendente assunto → si attiva automaticamente in Edilgestya con i suoi dati. Dipendente in uscita → disabilitazione automatica.

Documentazione tecnica

Per i fornitori che vogliono integrare:

• OpenAPI/Swagger spec (in roadmap).
• Esempi di chiamata in PHP, Node.js, Python.
• Sandbox di test.
• Supporto tecnico via email.

I moduli Edilgestya correlati

• Cantieri creati da API.
• Dipendenti sincronizzati.
• Planning pianificato.

Scopri Edilgestya e integra con i tuoi sistemi.