Perché il tuo gestionale ha bisogno di un'API aperta

Dell’API non chiede mai nessuno all’inizio. La domanda arriva nel momento in cui il commercialista vuole un prospetto che non esiste. O quando il negozio online dovrebbe scrivere gli ordini direttamente in magazzino. O quando qualcuno si accorge che due persone passano ogni lunedì mattina a ricopiare numeri da uno schermo all’altro.

Fino a quel giorno «interfaccia aperta» suona come una voce per i tecnici. Da quel giorno in poi è la domanda che conta: il programma cresce con l’azienda o le sta fra i piedi?

Senza interfaccia ogni programma diventa un’isola

Un gestionale senza API non è sbagliato. È solo. E la solitudine ha tre prezzi che non compaiono su nessuna fattura.

Ricopiare. I dati che stanno in un sistema e servono in un altro passano da una persona. Ogni passaggio costa tempo e porta con sé una percentuale di errori che nessuno misura, perché l’errore salta fuori dopo — di solito dal cliente.

Export che invecchiano. Il file CSV è il premio di consolazione per l’interfaccia che manca. Funziona esattamente una volta: nell’istante in cui viene creato. Da lì in poi è una fotografia che non sa più niente di quello che è cambiato.

L’uscita cara. Chi non riesce a uscire, resta. Non per convinzione, ma perché tirare fuori i propri dati diventa un progetto. Un’API è anche un’assicurazione: tiene aperta la porta, e questo cambia il rapporto con il fornitore.

Cosa ci si fa davvero

Gli esempi che capitano per davvero non sono spettacolari e fanno risparmiare parecchio:

• Il negozio scrive nel gestionale. Un ordine sul sito diventa un ordine nel programma senza che nessuno lo ribatta. Errori: zero.
• Il magazzino si fa vivo. Un sistema esterno comunica carichi e scarichi, e la giacenza è giusta senza allineamenti notturni.
• La contabilità prende quello che le serve. Le fatture di vendita arrivano al programma dello studio, con la frequenza che decide lui.
• L’archivio si riempie da solo. Ogni documento prodotto finisce nella gestione documentale con i dati giusti.
• Report senza giro largo. Uno strumento di analisi legge i numeri direttamente, invece di aspettare l’export della settimana.

Nessuno di questi casi richiede una squadra di sviluppo. Richiede un’interfaccia documentata e qualcuno che la colleghi una volta sola.

Come si riconosce un’API fatta sul serio

Non tutti i programmi che scrivono «API» nel listino ne hanno una con cui si possa lavorare. Cinque domande da fare prima di firmare:

1. Esiste una documentazione leggibile senza passare dal commerciale? Se la descrizione dell’interfaccia arriva solo dopo una telefonata, quell’interfaccia non è un prodotto: è un progetto.

2. Copre quello che fa il programma o solo la lettura? Molte API restituiscono dati e non ne accettano. Per il negozio che deve creare ordini, è esattamente la metà che manca.

3. Come si gestiscono le chiavi? Una chiave va revocabile, limitabile a determinati ambiti e non più visibile in chiaro dopo la creazione. Se il fornitore può rimostrartela quando vuole, vuol dire che la conserva in chiaro — e allora può leggerla anche qualcun altro.

4. Ci sono i webhook o bisogna chiedere? Senza webhook il tuo sistema domanda «è cambiato qualcosa?» ogni pochi minuti: consuma chiamate e le notizie arrivano lo stesso in ritardo.

5. Cosa succede ai limiti? Un’interfaccia seria dichiara i propri limiti (chiamate al minuto, al giorno) e, quando li superi, dice quando puoi riprovare. Chi non dichiara limiti o non ne ha, o te li fa scoprire al primo blocco.

E il prezzo?

L’accesso all’interfaccia si paga quasi sempre a parte, ed è giusto: genera carico e assistenza. Il conto resta semplice. Se due persone dedicano due ore a settimana a spostare dati, fanno circa 17 ore al mese. Contro quel numero, un modulo da qualche euro al mese non è una spesa: è il punto meno caro di tutto il processo.

In Blina Desk l’accesso API è un modulo aggiuntivo da 29 €/mese, fisso per azienda e non per persona. Comprende la gestione delle chiavi, i webhook firmati e il ponte verso Blina Space. La documentazione si legge senza registrarsi — che era il primo punto di questo elenco.

La domanda che resta

Al prossimo incontro con un fornitore non chiedere se c’è un’API. Chiedi dove sta la documentazione e leggila per dieci minuti. Dieci minuti di lettura dicono sui prossimi cinque anni con quel programma più di qualsiasi dimostrazione.