Integrare CRM e gestionale con API REST significa far sì che un anagrafica, un ordine o uno stato di pagamento esista una volta sola e arrivi dove serve, senza copia-incolla. Non è un “collegamento” magico: è un contratto tra due sistemi su quali dati si muovono, in che direzione e cosa succede quando uno dei due è fermo o incoerente.

La maggior parte delle PMI parte da un CRM per il commerciale e da un gestionale (o da Excel più fatturazione) per il resto. I due mondi si parlano a voce, via mail o con export. Funziona finché i volumi sono bassi. Poi arrivano doppie anagrafiche, offerte non registrate, fatture staccate dal deal e nessuno sa quale lista è vera.

Cosa allineare per primi (e cosa lasciare stare)

Non integrate “tutto”. Integrate il minimo che toglie lavoro ripetuto e errori visibili.

  • Anagrafiche cliente. Una chiave condivisa (partita IVA, codice interno) è più importante del nome visualizzato. Senza di essa ogni sync crea duplicati.
  • Opportunità / ordini. Quando un deal diventa ordine, il gestionale deve saperlo senza che qualcuno lo ribatta. Il CRM non deve diventare il magazzino.
  • Stati. “Vinto”, “fatturato”, “pagato”, “spedito” vanno mappati. Se i vocabolari non coincidono, l’API trasporta confusione più velocemente della mail.
  • Prodotti e listini. Solo se il commerciale vende da catalogo reale. Altrimenti il CRM può restare descrittivo e il gestionale resta il padrone dei prezzi.

Email, note di call, allegati di trattativa: di solito possono restare nel CRM. Inventario, contabilità, scadenze: restano nel gestionale.

REST non è la strategia, è il mezzo

Un’API REST espone risorse (clienti, ordini) con operazioni chiare e autenticazione. Serve documentazione, versionamento e limiti. Se il gestionale non ha API, a volte si passa da un middleware, da un database in sola lettura o da file — sapendo che è più fragile.

Decide la direzione: il CRM è master dei lead e il gestionale master della fattura, oppure un sistema è la fonte per ogni oggetto. Il “doppio master” è la causa più comune di progetti che non finiscono.

Sincronizzazione in tempo reale ha senso per scorte o stati di pagamento. Per anagrafiche, un job ogni pochi minuti è spesso sufficiente e più semplice da diagnosticare. Gli webhook (il sistema avvisa quando qualcosa cambia) riducono i polling inutili, ma richiedono che l’altro capo sia raggiungibile e che gestiate i retry.

Errori che fanno esplodere tempi e costi

Mappare campi “perché magari servono”. Ignorare i duplicati già presenti. Non definire chi corregge un conflitto. Non avere un ambiente di test con dati finti. Non loggare le chiamate. Chiedere all’integrazione di “sistemare anche i processi”: se il commerciale non chiude i deal e l’amministrazione non usa gli stati, l’API replica il disordine.

Un’integrazione seria include: inventario dei sistemi e dei campi, regole di master, gestione errori e replay, collaudo su casi reali (stesso cliente con due sedi, ordine parzialmente evaso, nota di credito).

Come partire in modo contenuto

Scegliete un flusso unico: ad esempio “cliente vinto nel CRM → anagrafica e ordine nel gestionale”. Misuratelo (quante copie manuali a settimana). Solo dopo aggiungete fatture verso il CRM o aggiornamenti di stato. È lo stesso approccio di un MVP: valore visibile prima della piattaforma universale.

DPH progetta integrazioni API tra CRM, gestionali e software esistenti. Se volete capire se il vostro caso è un connettore mirato o un progetto più ampio, chiedete un preventivo con i nomi dei sistemi e il flusso che oggi fate a mano.