Il vero problema di molti eCommerce non è la grafica. È tutto il lavoro manuale nascosto dietro le quinte. Prezzi aggiornati a mano, stock diversi tra sito e magazzino, ordini copiati nel gestionale, feed Google Shopping non allineati, clienti B2B gestiti fuori piattaforma e report che non tornano con la contabilità.
All'inizio sembra gestibile. Due ordini al giorno, qualche prodotto, un foglio Excel, una persona che controlla. Poi il catalogo cresce, arrivano campagne Google Ads, aumentano canali e marketplace, si aggiungono corrieri, sconti, listini, varianti e clienti aziendali. A quel punto ogni processo manuale diventa un rischio.
Un eCommerce integrato con gestionale, ERP, CRM e magazzino non serve solo a "passare dati". Serve a evitare errori che costano soldi: vendere prodotti non disponibili, mostrare prezzi sbagliati, duplicare ordini, spedire in ritardo, mandare feed incoerenti a Merchant Center e far lavorare marketing e amministrazione su numeri diversi.
Quando l'integrazione diventa necessaria
Non tutti gli eCommerce hanno bisogno di una integrazione complessa dal primo giorno. Ma ci sono segnali molto chiari.
- Lo stock sul sito non coincide con quello del gestionale.
- Gli ordini vengono copiati a mano.
- I prezzi cambiano in gestionale ma arrivano tardi online.
- Il team deve correggere spesso disponibilità, varianti o listini.
- Il feed Google Merchant Center ha prodotti non approvati o dati incoerenti.
- I clienti B2B hanno prezzi, sconti o condizioni diverse.
- Ci sono più magazzini o punti vendita.
- I corrieri vengono gestiti fuori dal flusso ordine.
- Il CRM non sa cosa il cliente ha comprato davvero.
- I report di Ads, sito e gestionale non raccontano la stessa storia.
Quando questi problemi si ripetono, non serve un altro foglio Excel. Serve progettare il flusso dati.
La prima domanda: chi comanda il dato?
Ogni integrazione seria parte da una domanda semplice: qual è il sistema autorevole per ogni informazione?
Esempio:
- il gestionale comanda prezzi, listini e fatture;
- il magazzino comanda disponibilità e ubicazioni;
- l'eCommerce comanda contenuti SEO, immagini, filtri e pagine prodotto;
- il CRM comanda stati cliente, segmenti e storico commerciale;
- il sistema spedizioni comanda tracking, etichette e stati consegna;
- il feed comanda come i dati prodotto arrivano a Google Merchant Center.
Se non decidi chi comanda, ogni sistema prova a correggere l'altro. E quando due sistemi si correggono a vicenda senza regole, nasce il caos: prezzi che tornano indietro, disponibilità sovrascritte, ordini doppi, prodotti disattivati per errore.
API, file, database o middleware?
Una integrazione può avvenire in modi diversi. Non esiste un metodo giusto per tutti.
- API: ideali quando i sistemi espongono endpoint affidabili e serve scambio dati controllato.
- Webhook: utili quando vuoi reagire a eventi, per esempio nuovo ordine, pagamento, aggiornamento stock.
- File CSV/XML: ancora validi quando il gestionale è vecchio o non offre API moderne, purché il flusso sia controllato.
- Database: possibile in alcuni contesti, ma da usare con prudenza per sicurezza, consistenza e responsabilità.
- Middleware: utile quando ci sono molti sistemi da collegare e serve un punto centrale di trasformazione, log e controllo.
La scelta dipende da volume, frequenza, rischio, qualità dei dati, sistemi disponibili e competenze del fornitore. Un plugin installato in fretta può bastare per un flusso semplice. Non basta quando devi governare ordini, resi, scorte, listini, feed, clienti e automazioni.
Magazzino: lo stock sbagliato rovina vendite e fiducia
La disponibilità è uno dei dati più delicati di un eCommerce.
Se mostri disponibile un prodotto finito, vendi qualcosa che non puoi consegnare. Se mostri esaurito un prodotto disponibile, perdi vendite. Se il feed Google Shopping manda a Google una disponibilità diversa dal sito, rischi disapprovazioni, annunci incoerenti e budget sprecato.
Lo stock non è solo un numero. Può includere:
- disponibilità vendibile;
- quantità impegnata in ordini non evasi;
- scorta di sicurezza;
- merce in arrivo;
- merce riservata;
- merce danneggiata o in controllo qualità;
- magazzini diversi;
- punti vendita fisici;
- fornitori dropshipping;
- tempi di riassortimento.
Shopify, ad esempio, nella sua documentazione distingue stati di inventario come disponibile, impegnato, riservato, danneggiato, safety stock e controllo qualità. Il punto non è usare per forza Shopify: il punto è capire che "giacenza" è una parola troppo semplice per un processo che può essere molto più articolato.
Prezzi e listini: il problema non è solo aggiornare il prezzo
Molti pensano all'integrazione prezzi come a una sincronizzazione banale: il gestionale invia il prezzo, il sito lo mostra. Nella realtà spesso entrano in gioco molte regole.
- prezzi IVA inclusa o esclusa;
- listini B2B e B2C;
- prezzi per cliente o gruppo cliente;
- sconti quantità;
- promozioni temporanee;
- prezzi netti e lordi;
- valute diverse;
- margini minimi;
- prodotti esclusi da coupon;
- prezzi da mostrare in feed Merchant Center.
Se questi dati non sono coerenti, il danno arriva ovunque: cliente confuso, ordine contestato, margine bruciato, campagne Ads che promuovono prodotti sbagliati e team interno costretto a controllare tutto a mano.
Ordini: il flusso deve essere progettato prima degli errori
Un ordine non è solo "nome, prodotti e totale". Può attraversare molti stati:
- creato;
- pagato;
- in attesa di bonifico;
- da verificare;
- in preparazione;
- spedito;
- parzialmente spedito;
- annullato;
- reso;
- rimborsato;
- fatturato.
L'integrazione deve decidere cosa succede in ogni stato. Quando l'ordine entra nel gestionale? Quando scala lo stock? Quando si genera la fattura? Cosa succede se il pagamento fallisce? Come si gestisce un rimborso parziale? Chi aggiorna il cliente? Quale sistema invia il tracking?
Se queste regole non sono scritte, vengono decise dagli errori. E gli errori, nell'eCommerce, diventano recensioni negative, ticket e margine perso.
Feed Merchant Center: se i dati sono sporchi, Google Ads lavora peggio
Google Merchant Center richiede dati prodotto accurati e formattati correttamente. Titolo, descrizione, ID, prezzo, disponibilità, immagini, GTIN, varianti e categorie devono essere coerenti con il sito.
Se il feed pesca dati vecchi o incompleti dal gestionale, anche Shopping e Performance Max partono male.
Esempi:
- prodotto disponibile nel feed ma esaurito sul sito;
- prezzo diverso tra annuncio e pagina;
- varianti senza
item_group_idcorretto; - immagini non aggiornate;
- categorie Google errate;
- custom label non allineate a margine, stock o stagionalità;
- prodotti sospesi per dati non coerenti.
Abbiamo approfondito questi problemi nell'articolo sugli errori del feed Google Merchant Center e in quello sulle custom label Google Shopping. Il punto è sempre lo stesso: il marketing funziona meglio quando il dato operativo è affidabile.
Realtime o batch? Non tutto deve aggiornarsi nello stesso modo
Una integrazione matura non manda tutto in tempo reale solo perché suona moderno.
Alcuni dati hanno bisogno di aggiornamenti rapidi:
- stock critico;
- ordini pagati;
- stati spedizione;
- prezzi in promozione;
- prodotti appena esauriti;
- errori di pagamento o evasione.
Altri dati possono essere aggiornati a batch controllati:
- descrizioni lunghe;
- immagini aggiuntive;
- contenuti SEO;
- attributi non critici;
- report storici;
- segmenti marketing non urgenti.
La domanda giusta non è "realtime sì o no?". La domanda è: quanto costa un dato sbagliato per cinque minuti, un'ora o un giorno?
Log, retry e alert: l'integrazione deve dire quando sbaglia
Un'integrazione senza log è una scatola nera. Finché funziona, nessuno la guarda. Quando sbaglia, nessuno sa cosa è successo.
Un sistema serio deve avere:
- log leggibili;
- ID degli eventi sincronizzati;
- retry automatici per errori temporanei;
- alert per errori critici;
- dashboard di stato;
- storico delle modifiche;
- controllo duplicati;
- procedure per riallineare i dati;
- documentazione per il team.
La vera differenza non è solo far passare un ordine. È sapere cosa succede quando un ordine non passa.
Quando il plugin non basta più
Un plugin può essere perfetto per una integrazione semplice. Ma diventa fragile quando l'azienda ha regole proprie.
Segnali tipici:
- il plugin copre l'80% del flusso e il restante 20% viene gestito a mano;
- ogni aggiornamento del plugin crea paura;
- i log sono difficili da leggere;
- non puoi modificare le regole di sincronizzazione;
- il gestionale usa campi o logiche non standard;
- ci sono più magazzini, listini, agenti o canali;
- serve collegare anche Ads, CRM, newsletter o customer care;
- l'azienda cresce più velocemente del connettore.
È lo stesso ragionamento dell'articolo su Shopify, PrestaShop o custom: una soluzione standard è utile finché i suoi vincoli non diventano il costo principale.
Cosa chiedere alla tua agenzia o al tuo sviluppatore
Prima di integrare eCommerce e gestionale, chiedi risposte precise.
- Quale sistema comanda prodotti, prezzi, stock, clienti e ordini?
- Quali dati devono essere real time e quali possono essere batch?
- Come gestiamo errori, retry e notifiche?
- Come evitiamo ordini duplicati?
- Come trattiamo resi, rimborsi e annullamenti?
- Come vengono sincronizzati listini B2B e sconti?
- Come gestiamo più magazzini o scorta di sicurezza?
- Il feed Merchant Center usa dati coerenti con sito e gestionale?
- Come documentiamo i flussi?
- Chi può leggere i log quando qualcosa non torna?
- Esiste una procedura di riallineamento?
- Cosa succede se il gestionale o l'API non risponde?
Se la risposta è "ci pensa il plugin", chiedi di vedere log, casi limite e responsabilità dei dati. È lì che si capisce se l'integrazione è un progetto o solo una promessa.
Come lo gestiamo noi in BitHub
In BitHub trattiamo l'integrazione come parte dell'architettura commerciale dell'eCommerce.
Il nostro lavoro può includere:
- mappatura dei sistemi esistenti;
- analisi di API, file, webservice, database o middleware disponibili;
- definizione del sistema autorevole per ogni dato;
- progettazione flussi per prodotti, stock, prezzi, ordini, clienti e spedizioni;
- log, alert, retry e controllo duplicati;
- feed Merchant Center collegato a dati affidabili;
- integrazione con CRM, newsletter, Google Ads e report;
- sviluppo custom quando plugin e connettori non bastano;
- documentazione per chi gestisce il sistema.
Questo si collega direttamente alle nostre pagine su eCommerce integrato con gestionale, sviluppo eCommerce custom e sviluppo eCommerce su misura.
L'obiettivo non è collegare sistemi perché "fa moderno". È togliere errori, ridurre lavoro manuale e dare a SEO, Ads, customer care e amministrazione gli stessi dati affidabili.
Fonti utili
Per approfondire la parte tecnica, abbiamo verificato la documentazione Google sulla specifica dei dati di prodotto Merchant Center, la documentazione Shopify sulle app di inventory management, la GraphQL Admin API Shopify per gli inventory item, e la documentazione PrestaShop sul Webservice API.
FAQ
Serve per forza un'API per integrare eCommerce e gestionale?
No. Le API sono spesso la strada migliore, ma non sempre disponibili. Si può lavorare anche con file CSV/XML, database, webservice o middleware, purché ci siano controlli, log e regole chiare.
La sincronizzazione deve essere sempre in tempo reale?
No. Stock critico, ordini e stati importanti possono richiedere aggiornamenti rapidi. Altri dati, come contenuti descrittivi o report, possono essere aggiornati a batch. Dipende dal costo dell'errore.
Un plugin basta per collegare il gestionale?
Può bastare per flussi semplici. Se ci sono listini B2B, più magazzini, regole di prezzo, feed Ads, CRM o casi limite, spesso serve progettare un'integrazione più solida.
Perché il gestionale è importante per Google Ads?
Perché prezzi, stock, margini, disponibilità e ordini reali influenzano feed Merchant Center, campagne Shopping, Performance Max e report. Se il dato operativo è sbagliato, il marketing prende decisioni peggiori.
Come si evitano ordini duplicati?
Servono ID univoci, controllo degli stati, log di sincronizzazione, retry progettati bene e regole su cosa succede quando una chiamata API fallisce o viene ripetuta.
Si può integrare un eCommerce già online?
Sì. Prima si analizzano flussi attuali, dati disponibili, errori ricorrenti e limiti della piattaforma. Poi si decide se integrare l'esistente o se conviene ripensare l'architettura.
Vuoi capire se il tuo eCommerce sta lavorando troppo a mano?
Possiamo analizzare gestionale, magazzino, ordini, feed, CRM e piattaforma eCommerce. Il primo passo è capire dove i dati si rompono e quanto ti costa ogni mese correggerli.