«Ha le API»: cosa significa davvero, e perché cambia il preventivo

    È la domanda che decide se due sistemi possono parlarsi in giorni o in mesi. Vale la pena capirla senza essere tecnici.

    8 minDirezione, responsabili di funzione, chi valuta fornitori

    Cosa portare a casa

    Risposta breve

    Un'interfaccia applicativa è il modo in cui un programma permette ad altri programmi di leggere e scrivere i suoi dati, in modo previsto e documentato. Un sistema che la espone può essere collegato ad altri con lavoro contenuto; uno che non la espone richiede soluzioni indirette, più fragili e più costose da mantenere.

    Un sistema senza interfaccia documentata rende ogni integrazione più cara e più fragile.

    «Esportiamo in Excel» non è un'integrazione: è un trasferimento manuale.

    La domanda va posta prima di comprare il software, non dopo.

    Web App

    CONSOO

    Torna alle guide

    Spiegato senza termini tecnici

    Immaginate un ufficio con uno sportello. Chi ha bisogno di un documento va allo sportello, compila un modulo previsto e riceve la risposta. Un'interfaccia applicativa è quello sportello: un punto di accesso dichiarato, con regole scritte su cosa si può chiedere e in che formato arriva la risposta.

    Un sistema senza sportello non è impenetrabile: si può passare dalla finestra, leggendo il video, automatizzando i clic o estraendo file. Funziona, ma si rompe ogni volta che cambia qualcosa, e nessuno vi garantisce che continui a funzionare dopo il prossimo aggiornamento.

    Modo di collegare due sistemiAffidabilitàCosto nel tempo
    Interfaccia documentata dal fornitoreAltaBasso
    Accesso diretto alla base datiMediaMedio: dipende da chi la mantiene
    Scambio di file automatizzatoMediaMedio, e con ritardi tra i due sistemi
    Estrazione da schermateBassaAlto: si rompe a ogni aggiornamento
    Copia e incolla manualeDipende dalle personeIl più alto, e invisibile in bilancio

    Perché cambia il preventivo

    • Con un'interfaccia documentata, chi sviluppa sa in anticipo cosa può fare: il lavoro è stimabile.
    • Senza, metà del progetto è scoperta: si prova, si trova un ostacolo, si cambia strada.
    • Le soluzioni indirette vanno rifatte quando il fornitore aggiorna il suo software, e succede.
    • Il collaudo è molto più lungo, perché i casi imprevisti emergono solo provando.
    • La responsabilità diventa ambigua: se il collegamento si rompe dopo un aggiornamento, di chi è il problema?

    Le domande da fare al fornitore

    Sei domande, prima di comprare

    • Esiste una documentazione pubblica dell'interfaccia? Posso vederla?
    • Cosa si può leggere e cosa si può scrivere: solo consultazione o anche modifica?
    • L'accesso è incluso nel canone o costa a parte?
    • Ci sono limiti al numero di richieste giornaliere?
    • Quando cambiate l'interfaccia, con quanto preavviso lo comunicate?
    • Se cambio fornitore, posso esportare tutti i miei dati e in quale formato?

    La terza domanda sorprende spesso: alcuni fornitori includono l'accesso, altri lo vendono come opzione a canone. È un costo che va conosciuto prima, perché rende l'integrazione una spesa ricorrente e non una tantum.

    Se il sistema non ha nulla

    1. 01

      Verificare se esiste un accesso alla base dati

      Molti gestionali installati in azienda permettono la lettura diretta dei dati. È meno elegante ma spesso sufficiente, soprattutto per alimentare portali e cruscotti.

    2. 02

      Valutare lo scambio di file programmato

      Il sistema esporta a orari fissi, l'altro legge. Introduce un ritardo, ma per molti casi — listini, anagrafiche, giacenze — il ritardo è accettabile.

    3. 03

      Considerare l'automazione delle operazioni ripetitive

      Un programma che compie le azioni che farebbe una persona. Funziona, ma va considerato una soluzione temporanea, perché è fragile per costruzione.

    4. 04

      Mettere la domanda nel prossimo acquisto

      Se state valutando la sostituzione di quel sistema, la capacità di dialogare con altri software dovrebbe pesare quanto le funzioni che offre.

    Risorse collegate utili

    Domande frequenti

    Cosa significa che un software ha le API?

    Che espone un punto di accesso documentato attraverso cui altri programmi possono leggere e scrivere i suoi dati in modo previsto. È come uno sportello con regole scritte, invece di dover entrare dalla finestra ogni volta.

    Perché cambia il costo di un'integrazione?

    Perché con un'interfaccia documentata il lavoro è stimabile, mentre senza metà del progetto è scoperta. Le soluzioni indirette inoltre vanno rifatte a ogni aggiornamento del fornitore, trasformando un costo una tantum in uno ricorrente.

    «Esportiamo in Excel» è un'integrazione?

    No: è un trasferimento manuale con un formato di scambio. Può bastare per casi semplici, ma richiede che qualcuno lo faccia ogni volta, e va chiamato con il suo nome quando si confrontano due offerte.

    Cosa chiedere al fornitore prima di comprare?

    Se esiste documentazione pubblica dell'interfaccia, cosa si può leggere e scrivere, se l'accesso è incluso nel canone o costa a parte, quali limiti ci sono, con quanto preavviso vengono comunicate le modifiche, e come si esportano tutti i dati se si cambia.

    Cosa faccio se il mio gestionale non ha nulla?

    Si verifica se è possibile leggere direttamente la base dati, oppure si imposta uno scambio di file programmato, accettando un ritardo che per anagrafiche, listini e giacenze è di solito tollerabile. L'automazione dei clic funziona ma va considerata temporanea.

    Dicci quali sistemi vorresti far parlare: in mezz'ora ti diciamo se hanno lo sportello o serve un'altra strada.

    CONSOO trasforma idee su software, AI e integrazioni in un percorso tecnico chiaro per PMI.

    • 30 minuti, online
    • Nessun impegno
    • Analisi del tuo caso reale
    • Risposta entro 24 ore