Integrazione API tra software aziendali: come funziona, cosa serve, cosa influenza il costo

Cos’è un’API, in parole semplici

Un’API (Application Programming Interface) è lo sportello attraverso cui un software permette ad altri software di chiedergli dati o di dargli istruzioni, senza passare dall’interfaccia che usano le persone. Quando l’e-commerce chiede al gestionale «quanti pezzi dell’articolo X hai a magazzino?» e riceve una risposta in un decimo di secondo, sta usando un’API. Se un software ha API documentate, integrarlo è un lavoro prevedibile; se non le ha, servono altre strade.

Come funziona un’integrazione tra due software

1. Si definisce cosa deve passare, in che direzione e quando: ordini dall’e-commerce al gestionale ogni minuto; giacenze dal gestionale all’e-commerce a ogni movimento; tracking dal corriere al cliente a ogni cambio di stato.
2. Si mappano i dati: il «cliente» dell’e-commerce e il «cliente» del gestionale hanno campi diversi, codici diversi, regole diverse. La mappatura è la parte più delicata.
3. Si decide chi è il padrone di ogni dato: l’anagrafica articoli vive nel gestionale, gli ordini nascono nell’e-commerce. Due padroni dello stesso dato producono conflitti.
4. Si costruisce il connettore: un piccolo software che legge da una parte, trasforma, scrive dall’altra, gestisce gli errori e tiene un registro.
5. Si gestiscono le eccezioni: cosa succede se un articolo non esiste nel gestionale, se il cliente ha due codici, se il gestionale è spento di notte.
6. Si monitora: un’integrazione senza avvisi quando si rompe è una bomba a orologeria.

I tipi di integrazione più comuni nelle PMI

E se il software non ha API?

Succede spesso con gestionali datati o verticali. Le strade, in ordine di preferenza:

• Accesso al database: lettura (e con cautela scrittura) diretta sulle tabelle, con l’accordo del fornitore.
• File di scambio: export e import programmati (CSV, XML, Excel) su una cartella condivisa o via SFTP. Meno elegante, molto affidabile.
• Automazione dell’interfaccia: un robot software che usa il programma come farebbe una persona. Ultima risorsa, ma funziona anche con sistemi che non hanno nient’altro.
• Intelligenza artificiale per i documenti: se l’unico output è un PDF o una stampa, la lettura automatica dei documenti trasforma carta in dati.

Esempio pratico: e-commerce e gestionale, passo per passo

Il caso più frequente nelle PMI. Il negozio online riceve un ordine; il connettore lo legge dalle API dell’e-commerce ogni minuto, cerca il cliente nel gestionale per partita IVA o e-mail (se non esiste lo crea), traduce i codici articolo dell’e-commerce in quelli del gestionale, crea l’ordine con prezzi e sconti già applicati e lo mette nello stato «da evadere». Quando il magazzino spedisce, il gestionale emette il DDT e il connettore riporta all’e-commerce lo stato «spedito» e il tracking del corriere; il cliente riceve la notifica. Nel frattempo, a ogni movimento di magazzino, la giacenza aggiornata viene scritta nell’e-commerce, così non si vende ciò che non c’è. Tre flussi (ordini, spedizioni, giacenze), tre direzioni chiare, un padrone per ogni dato.

In tempo reale o a lotti?

Non tutto deve passare in tempo reale. Le giacenze sì, perché una vendita su un articolo esaurito costa un cliente. Gli ordini quasi: ogni minuto basta. Le fatture e gli incassi possono passare una volta al giorno. Scegliere la frequenza giusta per ogni flusso evita di sovraccaricare sistemi lenti e di pagare complessità inutile. Una regola pratica: in tempo reale ciò che il cliente vede, a lotti ciò che serve all’amministrazione.

Sicurezza e dati personali

Un’integrazione sposta dati di clienti e fornitori tra sistemi: va fatta con credenziali dedicate e con i permessi minimi necessari (il connettore che legge le giacenze non deve poter cancellare clienti), con connessioni cifrate, con un registro di cosa è passato e quando, e con un accordo scritto sul trattamento dei dati se il connettore è ospitato da terzi. Sono accorgimenti semplici che vanno messi a preventivo dal primo giorno, non aggiunti dopo un problema.

Gli errori che costano di più

• Integrare prima di aver pulito le anagrafiche: codici doppi e descrizioni diverse si propagano in tutti i sistemi.
• Nessun padrone del dato: due sistemi che si sovrascrivono a vicenda.
• Nessun registro e nessun avviso: l’integrazione si ferma e lo si scopre dal cliente, settimane dopo.
• Sincronizzazioni troppo frequenti su sistemi lenti, o troppo rare su dati critici come le giacenze.
• Integrazioni «a mano» dentro il gestionale dal fornitore del gestionale: funzionano finché non cambi fornitore.

Cosa influenza costi e tempi di un’integrazione

Per questo un preventivo serio per un’integrazione arriva dopo aver visto i due sistemi, le API disponibili e un campione di dati, non prima. Come lavoriamo noi su questi progetti è descritto in integrazione software e API su misura; se l’integrazione è il primo passo verso un sistema più ampio, il quadro è su gestionale su misura.

Dopo il rilascio: un’integrazione va mantenuta

Le API cambiano: l’e-commerce aggiorna la versione, il gestionale cambia un campo, il corriere modifica il formato delle etichette. Un’integrazione senza manutenzione smette di funzionare entro un anno, di solito nel momento peggiore. Nel preventivo e nel contratto vanno previsti il monitoraggio con avvisi, un canale per le segnalazioni e un tempo di intervento scritto. È una voce piccola rispetto allo sviluppo, ed è quella che fa la differenza tra un’integrazione che dura e una che diventa il problema di qualcun altro.

Integrazione o sostituzione?

A volte la domanda giusta non è «come li collego» ma «perché ho due sistemi». Se due software fanno in parte la stessa cosa e nessuno dei due copre il processo, l’integrazione cura il sintomo. Se invece ciascuno fa bene la sua parte, integrarli è quasi sempre più rapido ed economico che sostituirli, e non interrompe il lavoro di nessuno.

Le domande più comuni