# Integrazione gestionale con gli altri software

> Integrazione API del gestionale con e-commerce, fatture, banca, CRM e WhatsApp, o via file: cosa si collega, come si evitano ordini doppi, chi la mantiene.

URL: https://automatia.it/servizi/integrazioni-api
Sezione: Home › Servizi › Integrazioni tra software
Aggiornato: 2026-10-25
Autore: Automatia S.r.l., software house (https://automatia.it/)

Un'integrazione gestionale fa passare ordini, clienti, fatture e pagamenti tra il gestionale e gli altri programmi che usi, senza che nessuno li ricopi. Serve quando li sposta ancora una persona.

- Si collegano: E-commerce, fatture, banca, CRM, WhatsApp
- Come: Con le API dei programmi, altrimenti con file
- Tempi tipici: Alcune settimane per due sistemi
- Formula: A corpo, a canone o mista

Con un'integrazione API il gestionale scambia dati con e-commerce, fatturazione, banca e CRM; dove le API mancano si usano file. Automatia la costruisce e la segue nel tempo: se un passaggio si blocca, avvisa chi deve intervenire. Tra due sistemi servono di solito alcune settimane.

## Cosa colleghiamo al gestionale

I collegamenti tra sistemi che ci chiedono più spesso portano ordini, fatture e incassi dentro e fuori dal gestionale, anche per aziende con sede o clienti in Svizzera. I nomi sono esempi di programmi collegabili, non accordi con i produttori.

- **Negozio online e gestionale.** Ordini e clienti entrano nel gestionale; giacenze, prezzi e numero di spedizione tornano al negozio. Tipico nel [commercio e nella distribuzione](https://automatia.it/settori/commercio-distribuzione); dettagli nella [guida su e-commerce e gestionale](https://automatia.it/guide/integrare-ecommerce-e-gestionale).
- **Dall'ordine alla fattura.** L'ordine diventa fattura nel [programma che già la manda allo SdI](https://automatia.it/guide/collegare-il-software-di-fatturazione). Vedi [fatturazione elettronica e incassi](https://automatia.it/servizi/fatturazione-elettronica-e-incassi) e la guida sulla [fatturazione automatica](https://automatia.it/guide/fatturazione-automatica).
- **Incassi abbinati alle fatture.** I movimenti di banca, Stripe, PayPal o POS si abbinano alle fatture aperte; quello che non torna finisce in un elenco da controllare. Come funziona: [riconciliazione bancaria automatica](https://automatia.it/guide/riconciliazione-bancaria-automatica).
- **Clienti e ritardi di pagamento.** Il commerciale vede nel CRM ordini, fatture e pagamenti in ritardo senza aprire il gestionale. Vale anche per un [CRM su misura](https://automatia.it/servizi/crm-su-misura).
- **WhatsApp.** Con l'integrazione WhatsApp API gli avvisi partono dal gestionale e le risposte finiscono nella scheda del cliente, invece che nel telefono di un collega.
- **Posta, calendari e file.** L'allegato arrivato in una casella si archivia nella pratica giusta, con Google Workspace come con [Microsoft 365](https://automatia.it/guide/scan-to-email-smtp-microsoft-365).

## Quando serve un'integrazione

Un'integrazione tra software serve quando i programmi ci sono già, ma tra l'uno e l'altro c'è una persona che copia.

- Gli ordini del sito si ricopiano nel gestionale per fare DDT e fattura.
- La giacenza online si aggiorna la sera, e ogni tanto si vende un articolo finito.
- L'estratto conto si spunta contro le fatture aperte, riga per riga.
- Il commerciale scopre da una telefonata che il cliente non ha pagato.

Quando non conviene

Collegare di solito costa meno che sostituire, e ognuno resta nel programma che conosce. Se un programma non sa dialogare o è a fine corsa, meglio [migrare a un gestionale nuovo](https://automatia.it/servizi/migrazione-gestionali) e collegare il resto lì. Con dieci ordini al mese, ricopiarli costa meno dell'integrazione: te lo diciamo nella prima chiamata.

### Come automatizzare i processi con le integrazioni

Con le integrazioni tra software aziendali un processo si automatizza un passaggio alla volta:

1. si parte da quello che pesa di più, dove una persona ricopia dati da un programma all'altro;
2. si verifica se i programmi coinvolti hanno un'API o almeno importano ed esportano file;
3. per ogni dato si decide quale programma comanda, per esempio i prezzi nel gestionale;
4. si collega quel passaggio con controlli e avvisi, e quando gira senza intoppi si passa al successivo.

Quando oltre a spostare i dati servono regole, scadenze e documenti, il lavoro si allarga all'[automazione dei processi aziendali](https://automatia.it/servizi/automazione-processi-aziendali).

## Integrazione API: cos'è, in pratica

Un'integrazione API collega due programmi attraverso le porte che ognuno apre agli altri: le API, o interfacce di programmazione. Ogni API è un elenco di richieste permesse, come "dammi gli ordini pagati oggi" o "registra questa fattura", con un controllo su chi chiede. Le basi sono nella guida [cosa sono le API](https://automatia.it/guide/api-cosa-sono-integrazione-software).

- L'integrazione tramite API fa solo ciò che le è permesso: leggere gli ordini, per esempio, ma non cambiare i prezzi.
- Ogni scambio lascia una traccia: si sa sempre cosa è passato, quando e da quale programma.
- Anche alcuni sistemi pubblici hanno API ufficiali: con quelle del RENTRI il formulario dei rifiuti nasce nel gestionale (vedi [FIR digitale e RENTRI](https://automatia.it/guide/fir-digitale-rentri-gestionale)).

## Se il programma non ha API

Se l'API non c'è, le strade sono tre, in ordine di preferenza. Prima della proposta verifichiamo se un programma permette l'integrazione via API, perché ne dipendono tempi e costi.

1. **Scambio di file.** Il programma esporta o importa file Excel, CSV o XML in una cartella condivisa, a orari fissi. Meno immediato di un'API, ma con molti programmi installati in ufficio è la strada più stabile.
2. **Lettura del database.** Se il database è raggiungibile, i dati si leggono direttamente. Scriverci lo facciamo solo con il consenso del produttore, perché si saltano i controlli del programma.
3. **Automazione dell'interfaccia.** L'ultima risorsa: un robot software (RPA) clicca al posto di una persona, e si ferma appena cambia una schermata. Vedi [cos'è la RPA](https://automatia.it/guide/rpa-cos-e-automazione-robotica-processi) e l'[automazione dei processi](https://automatia.it/servizi/automazione-processi-aziendali).

**Per il vostro tecnico.** API REST, webhook, OAuth2, idempotenza, i gestionali più diffusi

**Come si parlano i programmi.** Con i programmi in cloud la strada più comune è un'integrazione API REST, con richieste e risposte in JSON. Il webhook fa il percorso inverso: è il negozio ad avvisare il gestionale appena un ordine viene pagato, invece di essere interrogato ogni cinque minuti. Senza webhook si interroga a intervalli fissi.

**Accessi.** Dove il programma lo prevede usiamo OAuth2: il titolare dell'account autorizza l'integrazione senza consegnare la password e la revoca quando vuole. Altrimenti una chiave API o un utente dedicato con i soli permessi necessari.

**Doppioni e ritentativi.** I webhook entrano solo con la firma verificata; ogni evento ha un codice e, se è già registrato, si scarta (idempotenza). Anche le piattaforme ritentano, ma con un limite: [Shopify](https://shopify.dev/docs/apps/build/webhooks/subscribe/https) ritenta un webhook senza risposta 8 volte nelle 4 ore successive, poi smette; [Stripe](https://docs.stripe.com/webhooks) insiste per un massimo di tre giorni e avverte che lo stesso evento può arrivare più di una volta.

**Senza API.** Lo scambio di file usa anche tracciati EDI, su una cartella condivisa o su un server SFTP. Le sigle sono spiegate nel [glossario](https://automatia.it/glossario).

| Programma | Come si collega | Da sapere |
| --- | --- | --- |
| [Fatture in Cloud](https://automatia.it/guide/integrazione-fatture-in-cloud) | API REST, versione 2 | Accesso con OAuth2 o con un token, [documentazione pubblica](https://developers.fattureincloud.it/). |
| [Danea Easyfatt](https://automatia.it/guide/integrazione-danea-easyfatt) | File XML nel formato di Danea | Solo nelle edizioni Enterprise ed Enterprise One. Il catalogo va al sito e gli ordini tornano al gestionale, secondo le [specifiche tecniche di Danea](https://www.danea.it/software/easyfatt/ecommerce/integrazione/). |
| Odoo | XML-RPC, JSON-RPC e la nuova JSON-2 | Con i piani One App Free e Standard l'API esterna non è disponibile: serve il piano Custom. |
| TeamSystem, [Zucchetti](https://automatia.it/guide/integrazione-zucchetti), Passepartout (Mexal) | Dipende dal prodotto e dalla versione | Verifichiamo nella documentazione, o con il tuo rivenditore, cosa prevede la tua licenza. |

*Come si collegano alcuni gestionali, dalla documentazione dei produttori verificata a ottobre 2026.*

**Odoo, un cambio annunciato.** Le integrazioni che usano XML-RPC o JSON-RPC vanno portate sulla nuova interfaccia JSON-2, già disponibile: le due vecchie interfacce vengono rimosse con Odoo Online 21.1, nell'inverno 2027, e con Odoo 22, nell'autunno 2028, come indica la [documentazione delle API di Odoo](https://www.odoo.com/documentation/19.0/developer/reference/external_rpc_api.html). Il portale di produzione raccontato più sotto chiama proprio un ERP Odoo, via JSON-RPC; la rete di imprese offre invece ai negozi un'API REST, con accesso OAuth2, idempotenza e webhook firmati con ritentativi.

## Ordini persi o doppi: come si evitano

Un'integrazione fatta bene non perde ordini e non li raddoppia, anche quando il gestionale è spento per un aggiornamento o lo stesso avviso arriva due volte.

- **Solo messaggi veri.** Un avviso che non viene davvero dal negozio non entra.
- **Nessun doppione.** Se lo stesso ordine arriva due volte, il secondo si scarta.
- **Una coda.** Se il gestionale è fermo, gli ordini aspettano e ripartono da soli.
- **Un sistema comanda su ogni dato.** I prezzi nascono nel gestionale, gli ordini nel negozio.
- **Avvisi leggibili.** A chi deve intervenire arriva il problema in italiano, con il numero d'ordine.
- **Una quadratura.** Un controllo periodico confronta gli ordini dei due lati e trova quello che è sfuggito.

## Quando un programma si aggiorna

Un'integrazione si rompe più spesso quando uno dei due programmi cambia versione, e va adeguata. A volte il cambio è annunciato per tempo; qui sotto, un esempio di come lo seguiamo.

1. **Annuncio del produttore.** Mesi prima Il produttore pubblica la data in cui la vecchia porta del programma smetterà di funzionare.
2. **Prova in un ambiente separato.** Settimane prima Proviamo l'integrazione sulla versione nuova, senza toccare i vostri dati.
3. **Integrazione adeguata.** Prima della data Il collegamento passa alla porta nuova; per chi lavora non cambia niente.
4. **Vecchia porta chiusa.** La data annunciata Gli ordini continuano ad arrivare come prima.

Altre volte il guasto è silenzioso

[WooCommerce smette da solo di mandare gli avvisi](https://woocommerce.com/document/webhooks/) dopo più di cinque consegne fallite di fila, e gli ordini non arrivano più senza un errore sullo schermo di nessuno.

- Seguiamo gli annunci dei produttori, proviamo le nuove versioni in un ambiente di prova e riceviamo anche noi gli avvisi.
- Se un passaggio si ferma, lo segnali al referente del progetto: non tocca a te capire se il guasto sta nel negozio o nel gestionale.
- Gli aggiornamenti rientrano nell'[assistenza](https://automatia.it/servizi/assistenza-e-manutenzione-software); un cambio profondo si concorda prima. L'accordo si fa su misura: [formule e costi](https://automatia.it/formule).

## Esperienze dei nostri team con le API

Nel primo caso è il portale a chiamare l'ERP; nel secondo sono i negozi online a chiamare la rete.

**Dal portale all'ERP con un clic.** Il portale di produzione chiama l'ERP dell'azienda attraverso la sua API.

- Si parte da un lavoro registrato nel portale di produzione
- Un clic, e la richiesta va all'ERP
- Nell'ERP nasce la bozza di fattura o di ordine

**Un'API per i negozi online.** I negozi online degli iscritti si collegano al sistema di pagamento interno della rete.

- Accesso autorizzato, senza scambiarsi password
- Nessun pagamento registrato due volte
- Avvisi ai negozi firmati e ripetuti se non arrivano
- Una pagina di pagamento pronta, un ambiente di prova e una libreria PHP per chi sviluppa il collegamento

## Domande frequenti

**Quanto costa un'integrazione tra due programmi?**

Dipende da quanti programmi si collegano, in quante direzioni passano i dati e da com'è fatta l'API dall'altra parte. Dopo l'analisi ricevi una proposta scritta con costi, tempi e formula: a corpo, a canone o mista (le trovi in [formule e costi](https://automatia.it/formule)). I costi dei fornitori sono a parte e la proposta li indica separatamente: per esempio il piano Custom che Odoo chiede per usare l'API esterna, o i messaggi WhatsApp a modello.

**Conviene integrare i programmi che ho o cambiare gestionale?**

Se ogni programma fa bene il suo lavoro e manca solo il passaggio dei dati, conviene integrare. Se il gestionale non ha modo di dialogare, non regge i volumi o vi costringe a tenere fogli Excel paralleli, conviene cambiarlo e collegare il resto a quello nuovo. Nell'analisi scriviamo quale strada consigliamo e perché; per la seconda vedi i [gestionali su misura](https://automatia.it/servizi/gestionali-su-misura).

**Gli ordini arrivano nel gestionale in tempo reale?**

Quando il negozio avvisa il gestionale appena un ordine viene pagato, sì: di solito l'ordine arriva pochi secondi dopo. Se il programma non lo prevede, l'integrazione controlla a intervalli fissi, per esempio ogni quarto d'ora; con lo scambio di file, a volte una volta al giorno.

**Posso collegare WhatsApp Business al gestionale o al CRM?**

Sì, con la WhatsApp Business Platform, il prodotto di Meta con le API, distinto dall'app WhatsApp Business del telefono. Oltre le 24 ore dall'ultimo messaggio del cliente si mandano solo modelli approvati da Meta, che si pagano a messaggio consegnato. Le risposte libere dentro quelle 24 ore sono gratuite fino a 1.000 al mese per numero; dal 1° ottobre 2026, oltre questa quota, si pagano anche loro. I passaggi sono nella guida sulla [WhatsApp Business API](https://automatia.it/guide/whatsapp-business-api).

**Si può collegare il POS al gestionale?**

Dipende dal fornitore del terminale. Alcuni offrono un'API che elenca le transazioni, come SumUp; con altri si parte dall'esportazione dei movimenti. In entrambi i casi gli incassi del giorno si abbinano alle vendite nel gestionale.

**Dovete conoscere le password dei nostri programmi?**

No. Quando il programma lo prevede, entri tu nel tuo account, autorizzi l'integrazione e puoi revocarla quando vuoi. Negli altri casi usiamo una chiave d'accesso o un utente dedicato con i soli permessi necessari, mai l'account personale di qualcuno.


## Pagine collegate

- [Cosa sono le API](https://automatia.it/guide/api-cosa-sono-integrazione-software): Cosa sono le API e come collegano negozio online, gestionale e fatturazione: API REST, webhook, chiavi, limiti, alternative senza API, manutenzione e costi.
- [Automazioni su misura](https://automatia.it/servizi/automazione-processi-aziendali): Automazioni che tolgono il lavoro ripetitivo: ordini, fatture passive, solleciti, documenti e report, con un registro di ogni esecuzione.
- [Collegare e-commerce e gestionale](https://automatia.it/guide/integrare-ecommerce-e-gestionale): Cosa sincronizzare tra e-commerce e gestionale, quando basta un plugin, come evitare giacenze sfasate e ordini doppi, e cosa serve per un portale B2B.
- [RPA e automazione robotica](https://automatia.it/guide/rpa-cos-e-automazione-robotica-processi): Cos'è la RPA e come lavora un robot software: quando preferire le API, perché si rompe, cosa cambia con l'AI, quanto costano licenze e manutenzione.

---

Automatia S.r.l. · info@automatia.it · Italia +39 375 669 3055 (WhatsApp sempre attivo, 24 ore su 24, 7 giorni su 7) · Svizzera +41 76 511 26 10 (telefono e WhatsApp) · operativi 24 ore su 24, 7 giorni su 7 · https://automatia.it/contatti
Indice del sito per le AI: https://automatia.it/llms.txt · testo integrale: https://automatia.it/llms-full.txt
