integrazioni

Integrare e-commerce e gestionale: ordini, magazzino e spedizioni

9 min di lettura

Come integrare e-commerce e gestionale: quali dati far viaggiare, come collegare i sistemi, cosa può andare storto e come preparare il preventivo.

Il lunedì mattina, in un'azienda che vende online, c'è spesso la stessa scena. Qualcuno apre il pannello del negozio, copia gli ordini del weekend nel gestionale, poi scarica il file delle giacenze e lo ricarica sul sito. Più tardi incolla i numeri di tracking dal sito del corriere.

Funziona finché gli ordini sono dieci al giorno. Quando diventano cinquanta, o quando si aggiunge un marketplace, arrivano gli errori: un articolo venduto due volte, un cliente senza tracking, una fattura emessa con l'indirizzo vecchio.

Questa guida spiega come progettare il collegamento tra e-commerce e gestionale, senza gergo inutile. Ci interessa il metodo, non lo strumento: lo stesso ragionamento vale per un negozio proprio, per i marketplace e per un mix dei due.

Quali dati devono muoversi, e chi comanda

Prima di parlare di tecnologia, serve una mappa. Per ogni tipo di dato si decidono tre cose: quale sistema è il «master», cioè quello che ha ragione quando due versioni non coincidono; in che direzione viaggia il dato; ogni quanto si aggiorna.

DatoMaster (di solito)DirezioneFrequenza tipica
OrdiniE-commerce o marketplaceVerso il gestionalePochi minuti o in tempo reale
ClientiDipende dal canaleIn entrambe le direzioniAlla creazione dell'ordine
Anagrafica prodottiGestionaleVerso l'e-commerceUna o più volte al giorno
Prezzi e listiniGestionaleVerso l'e-commerceOgni ora o di notte
GiacenzeGestionale o magazzinoVerso e-commerce e marketplacePochi minuti
Spedizioni e trackingCorriere o gestionaleVerso l'e-commerceQuando la spedizione parte
Resi e annullamentiGestionaleIn entrambe le direzioniQuando avvengono
Esempio indicativo: le scelte giuste dipendono dalla tua azienda. Il gestionale è spesso il master, ma non sempre.

La parte più utile è la colonna del master. Se prezzi e giacenze si possono modificare sia dal negozio sia dal gestionale, prima o poi qualcuno sovrascrive il lavoro di qualcun altro. Meglio scegliere un solo posto dove si cambia e far seguire gli altri.

Fatture e documenti fiscali

Anche la parte fiscale entra nella mappa. Chi vende ai consumatori deve comunque emettere i documenti previsti dalla normativa, e chi vende ad aziende ha altri obblighi legati alla fatturazione elettronica. Le regole esatte dipendono dal tipo di vendita e dal tuo regime.

Per questo, prima di progettare, fai confermare al tuo commercialista quale documento serve per ogni canale. L'integrazione poi si limita a far arrivare al gestionale i dati giusti: dati fiscali del cliente, aliquote, indirizzo di fatturazione.

Quattro modi per collegare i sistemi

Non esiste una soluzione migliore in assoluto. Esistono quattro strade, e la scelta dipende da quanto sono standard i tuoi processi.

Le API sono il «canale ufficiale» con cui un programma accetta di parlare con un altro. I webhook sono avvisi automatici: quando arriva un ordine, il negozio bussa alla porta dell'altro sistema invece di aspettare che qualcuno vada a chiedere.

Connettore o piattaforma pronta

  • Si attiva in poco tempo
  • Costo e manutenzione prevedibili
  • Ottimo se i flussi sono standard
  • Poco adattabile a regole particolari
  • Un aggiornamento del fornitore può cambiare il comportamento

Integrazione su misura

  • Segue le tue regole: listini, magazzini, eccezioni
  • Gestisce più canali con una logica unica
  • Errori e avvisi decisi insieme a te
  • Richiede analisi e collaudo iniziali
  • Va mantenuta quando cambiano i sistemi collegati

Se vendi su un solo negozio, usi un gestionale diffuso e non hai regole strane, un connettore può bastare, e te lo diremmo. Ha senso valutare una soluzione su misura quando hai più canali, listini per cliente, più magazzini, oppure un gestionale vecchio che nessun connettore supporta. Trovi altri casi nella guida con esempi di software su misura.

Cosa di solito va storto

Gli errori ricorrono sempre negli stessi punti. Conoscerli in anticipo permette di scrivere le regole prima di avere un cliente arrabbiato.

67 miliardi
stima del valore degli acquisti online degli italiani nel 2026 (+7% sul 2025)Fonte: Osservatorio eCommerce B2c Netcomm - Politecnico di Milano
44,3 milioni
pacchi stimati nei 13 giorni del Black Friday 2026 (+6,6% sul 2025)Fonte: Osservatorio eCommerce B2c Netcomm - Politecnico di Milano

Quando l'online cresce e i picchi si concentrano in pochi giorni, un sistema che regge il martedì qualunque può andare in difficoltà nei giorni di offerte. Ecco i punti dove di solito si inceppa.

Codici articolo che non coincidono

Lo SKU è il codice con cui identifichi un articolo. Nel negozio può essere «MAGL-BLU-M», nel gestionale «001234». Se la corrispondenza non è scritta da qualche parte, un ordine arriva e il sistema non sa a cosa si riferisce. Serve una tabella di raccordo, tenuta in un solo posto.

IVA e arrotondamenti

Il negozio calcola l'IVA sul totale, il gestionale sulla singola riga. Su un ordine con cinque articoli la differenza può essere di un centesimo, e quel centesimo basta a far rifiutare un documento o a non far quadrare un incasso. Si decide una regola di calcolo e la si applica ovunque.

Spedizioni parziali, annullamenti e resi

Un ordine di quattro articoli parte in due colli, uno oggi e uno la settimana prossima. Oppure il cliente annulla quando l'ordine è già nel gestionale. Il collegamento deve prevedere questi casi: più tracking per lo stesso ordine, annullamento che si propaga, reso che rimette la merce in giacenza.

Vendere due volte lo stesso pezzo

Se la giacenza si aggiorna ogni notte, nel pomeriggio il sito continua a offrire l'ultimo pezzo che hai già venduto su un marketplace. Più veloce è l'aggiornamento, meno ordini da annullare. Si può anche tenere una piccola scorta di sicurezza, non pubblicata, sugli articoli più richiesti.

Limiti di chiamate (rate limit)

Molte API accettano solo un certo numero di richieste al minuto. Se ricarichi tutto il catalogo di colpo, il sistema ti blocca. L'integrazione deve procedere a ondate e riprovare con calma, aggiornando solo ciò che è cambiato.

L'integrazione che si rompe senza dirlo

Il guasto peggiore non è quello che si vede. È un ordine che non arriva nel gestionale e di cui ti accorgi dopo tre giorni, quando il cliente scrive. Un'integrazione fatta bene prevede che qualcosa vada storto e sa cosa fare.

Decidi in anticipo anche chi gestisce le eccezioni. Un ordine con un codice sconosciuto non deve fermare tutti gli altri: va messo da parte, segnalato a una persona precisa e ripreso quando è risolto. Quando le eccezioni si moltiplicano, vale la pena guardare l'intero processo da automatizzare, non solo il singolo collegamento.

Cosa preparare prima di chiedere un preventivo

Un preventivo preciso si fa con informazioni precise. Più materiale porti, meno ipotesi servono e meno sorprese ci saranno a metà lavoro.

Da raccogliere prima del primo incontro

  • Elenco dei sistemi coinvolti: negozio, marketplace, gestionale, magazzino, corrieri, programma di fatturazione
  • Versione dei programmi e, se esiste, la documentazione delle loro API
  • Un ambiente di prova (sandbox): una copia dove fare test senza toccare ordini veri
  • Qualche esempio reale di ordini, clienti e articoli, anche solo esportati da Excel
  • Volumi: ordini al giorno, articoli a catalogo, picchi stagionali
  • Chi gestisce le eccezioni oggi: resi, annullamenti, indirizzi sbagliati
  • Cosa deve restare invariato: listini, regole di sconto, codifiche
  • Il nome del commercialista o di chi cura la parte fiscale, per i documenti da emettere

Se qualcosa manca non è un problema. Una parte del nostro lavoro iniziale consiste proprio nel capire cosa c'è, anche quando il gestionale è vecchio e la documentazione non esiste.

Come si procede, dall'analisi al monitoraggio

Un percorso tipico

  1. 01

    Analisi

    Si raccolgono i processi reali e si guardano gli ordini veri, comprese le eccezioni. Si capisce cosa va collegato e cosa può restare com'è.

  2. 02

    Mappatura

    Si scrive la tabella dei dati: master, direzione, frequenza, raccordo tra codici. È il documento su cui ci si mette d'accordo.

  3. 03

    Ambiente di prova

    Si costruisce il collegamento su copie dei sistemi. Qui si provano ordini anomali, resi, annullamenti e cali di connessione.

  4. 04

    Pilota su una parte

    Si attiva su un canale, su una famiglia di prodotti o su un periodo ristretto, tenendo il vecchio metodo come rete di sicurezza.

  5. 05

    Passaggio in produzione

    Si estende a tutto, in un momento tranquillo e non nella settimana delle offerte.

  6. 06

    Monitoraggio

    Nelle prime settimane si guardano log e ordini bloccati, e si sistemano i casi che nessuno aveva previsto.

Come lavoriamo noi

Per tutto il percorso hai un solo referente, dall'analisi alla messa online. Prima di sviluppare ricevi una proposta scritta con ambito, tempi e fasi, e ti mostriamo i flussi prima di costruire le parti più impegnative.

Rilasciamo per gradi, consegniamo codice sorgente e documentazione essenziale, e il primo mese è coperto da garanzia sulle eventuali anomalie. Hosting e servizi restano a tuo nome. Alla prima richiesta rispondiamo entro 24 ore. Se vuoi partire dalla parte tecnica, vedi la pagina sulle integrazioni API ed ERP o i nostri lavori realizzati.

Domande frequenti

Posso integrare un e-commerce con un gestionale vecchio?

Spesso sì, ma dipende da come il gestionale espone i dati. Se ha API, il lavoro è lineare. Se non ne ha, si può lavorare su file scambiati o direttamente sul database, valutando prima rischi e supporto del produttore.

Meglio un connettore già pronto o un'integrazione su misura?

Se i tuoi flussi sono standard e vendi su un solo canale, il connettore è di solito la scelta più semplice. La strada su misura ha senso con più canali, regole di prezzo particolari o sistemi poco comuni.

Ogni quanto devono aggiornarsi le giacenze?

Dipende da quanto si vende e da quanto è grave vendere un pezzo che non c'è. Per articoli molto richiesti o venduti su più canali conviene un aggiornamento ogni pochi minuti. Per cataloghi lenti può bastare un passaggio notturno.

Cosa succede se l'integrazione si ferma?

In un progetto fatto bene gli ordini restano in coda, il sistema riprova da solo e una persona riceve un avviso. Quando il collegamento riparte, gli ordini in attesa vengono elaborati senza essere inseriti due volte.

Posso collegare anche i marketplace?

Sì, ciascun marketplace ha le sue regole e i suoi limiti. Conviene un unico punto centrale che raccolga gli ordini da tutti i canali e li passi al gestionale in formato uniforme.

Chi emette la fattura, il negozio o il gestionale?

Di solito il gestionale, che ha anagrafiche, numerazioni e collegamento alla fatturazione elettronica. Il negozio manda i dati dell'ordine. La regola esatta va concordata con il commercialista.

Fonti

  1. 01Osservatorio eCommerce B2c Netcomm - Politecnico di Milano, comunicato stampa del 4 novembre 2026 — Valore degli acquisti online 2026 e pacchi del Black Friday.

Questo approccio fa per te?

Parliamo del tuo processo: ti diciamo cosa vale la pena automatizzare, cosa no e con quali tempi.

Altre guide