Integrazioni API: come collegare i sistemi aziendali in modo definitivo

"Inserisci l'ordine sul gestionale, poi anche sul magazzino, poi mandalo via email all'agente". Se hai mai sentito una frase del genere in azienda, hai un problema di integrazione. Le API la risolvono. In modo definitivo, non con un cerotto.

Cosa è un'API (in 30 secondi)

Una API è un linguaggio standard che permette a due software di parlarsi automaticamente. Quando paghi con PayPal, è una API che dialoga tra il sito e PayPal. Quando arriva un ordine sull'e-commerce e magicamente compare nel gestionale, è una API.

I 5 scenari di integrazione più richiesti

1. E-commerce → Gestionale

Ogni ordine sull'e-commerce viene creato automaticamente come ordine cliente nel gestionale. Anagrafica creata se nuova, magazzino aggiornato, fattura generata.
Tempi: 5-10 giorni di sviluppo.

2. Gestionale → E-commerce

Stock e prezzi del gestionale si sincronizzano sull'e-commerce ogni X minuti. Mai più "venduto e poi non c'è".
Tempi: 3-7 giorni.

3. Sito web → CRM

Form di contatto, richieste preventivo, iscrizioni newsletter generano automaticamente lead nel CRM con assegnazione al commerciale giusto.
Tempi: 2-5 giorni.

4. Gestionale → Sistema di Interscambio (SDI)

Fatture elettroniche generate e inviate in automatico, notifiche di scarto/accettazione gestite, archivio sostitutivo.
Tempi: 3-8 giorni (a seconda del provider SDI).

5. Banca → Gestionale

Estratto conto bancario importato automaticamente (CBI), riconciliazione automatica con fatture e pagamenti.
Tempi: 4-7 giorni.

I 3 modi sbagliati di integrare

Esportazione/importazione manuale

"Esporto il CSV dal gestionale, lo importo sull'e-commerce ogni mattina". Funziona finché qualcuno se ne ricorda. Dopo 2 mesi qualcuno se ne dimenticherà.

"Connettori" generici a pagamento

Esistono piattaforme come Zapier o Make che promettono "integrazione drag-and-drop". Funzionano per casi semplici. Per logiche italiane (IVA, SDI, listini multi-prezzo) tipicamente non bastano e accumulano costi mensili crescenti.

Integrazione "spaghetti" punto-punto

Ogni sistema parla con tutti gli altri. Quando hai 5 sistemi servono 10 integrazioni. Quando ne aggiungi un sesto, ne servono 15. Diventa ingestibile.

Il modo giusto: l'integration layer

Si crea un livello centrale che parla con tutti i sistemi. Ogni nuovo sistema si connette a UN solo punto. È quello che facciamo per i nostri clienti più strutturati: un middleware in Laravel/Node.js che orchestra tutto.

Cosa cercare in un partner di integrazioni

• Documentazione tecnica: deve consegnare schemi delle integrazioni, non solo codice funzionante.
• Logging e monitoring: ogni chiamata API deve essere tracciata. Quando qualcosa non funziona, devi sapere dove.
• Retry automatico: le API a volte falliscono per motivi temporanei. Il sistema deve riprovare da solo, non perdere dati.
• Gestione degli errori: non bastano log, servono alert email/Slack quando qualcosa si rompe.
• Test e ambiente di staging: integrazioni testate prima di andare in produzione, non testate sui clienti.

Quanto costano davvero

Una singola integrazione punto-punto: 1.500-4.000 €. Un middleware completo che orchestra 4-6 sistemi: 8.000-20.000 €. La manutenzione annuale è tipicamente il 15-20% del costo iniziale, perché le API esterne cambiano (Amazon, Shopify, banche, SDI rilasciano nuove versioni).

I casi in cui NON conviene integrare

• Quando il volume è basso (sotto i 100 movimenti al mese conviene ancora il manuale)
• Quando uno dei due sistemi è in dismissione tra meno di 12 mesi
• Quando uno dei sistemi non ha API documentate (alcuni gestionali italiani molto vecchi)

Conclusione

Un'azienda integrata è un'azienda che fa il doppio col 30% di tempo in meno. Non è un'esagerazione, è quello che vediamo nei nostri clienti dopo un buon progetto di integrazione. Se hai 3+ sistemi che oggi non si parlano, il primo passo è una mappatura: che dato vive dove, quali sono i flussi critici. La facciamo gratuitamente sui nuovi progetti.