E-commerce e gestionale: sincronizzare il magazzino

Ci sono due modi di gestire un e-commerce che vende gli stessi prodotti del negozio o del magazzino fisico. Il primo è aprire due schede del browser e correggere le quantità a mano ogni sera. Il secondo è far parlare i due sistemi tra loro. Il primo funziona finché gli ordini sono pochi; poi arriva il giorno in cui vendi online l’ultimo pezzo che hai appena venduto al banco, e passi la mattinata a scrivere un’email di scuse.

Questa guida è il ragionamento che faccio con i clienti prima di scrivere una riga di codice: cosa vuol dire integrare, quali strade esistono, dove si rompono le cose e da cosa dipende il conto finale.

Integrare non è “collegare”, è decidere chi comanda

La parte tecnica di un’integrazione è quasi sempre la meno complicata. La parte difficile è mettersi d’accordo su chi detiene la verità per ogni singola informazione: le giacenze, i prezzi, le schede prodotto, gli ordini, i clienti.

Finché questa scelta resta implicita, l’integrazione diventa un tiro alla fune: il sito aggiorna una quantità, il gestionale la riscrive un minuto dopo, e nessuno capisce quale dei due abbia ragione. Per questo la prima cosa che faccio è disegnare una tabella brutta e utilissima — un flusso per riga, una freccia per colonna — e farla approvare a chi in azienda usa il gestionale tutti i giorni.

Chi comanda sul magazzino, il gestionale o il sito?

Il gestionale. Nella quasi totalità dei progetti che seguo la fonte di verità delle giacenze è il gestionale, perché è lì che finiscono i carichi da fornitore, i resi, le rotture, le vendite in negozio e gli aggiustamenti dopo l’inventario. Il sito vede solo una fetta della realtà: quello che ha venduto online. Se lascio decidere al sito, la prima vendita fatta al banco manda fuori sincrono tutto. Quindi imposto un flusso a senso unico per le quantità: il gestionale scrive, l’e-commerce legge e si adegua. In direzione opposta viaggiano gli ordini: il sito li spinge nel gestionale, che genera documenti e spedizioni. L’unica eccezione che concedo sono i prodotti gestiti solo online — bundle, preordini, digitale puro — che nel gestionale non esistono: quelli li tengo fuori dalla sincronizzazione con una regola esplicita, non per dimenticanza.

Le tre strade tecniche (e quando scelgo quale)

API dirette. Se il gestionale è moderno — cloud o con un modulo API attivabile — è la strada migliore. Parlo direttamente con lui, leggo le giacenze, scrivo gli ordini, gestisco gli errori in modo pulito. Richiede quasi sempre una licenza o un modulo aggiuntivo del fornitore del gestionale: va verificato prima, non dopo aver fatto il preventivo.

File pianificati. Molti gestionali installati in sede non hanno API, ma sanno esportare CSV o XML su una cartella condivisa o un FTP. Si costruisce allora un piccolo servizio che legge quei file a intervalli regolari e li traduce in aggiornamenti sull’e-commerce. È meno elegante, ma è robusto e costa molto meno che sostituire il gestionale.

Middleware. Quando i sistemi da collegare sono più di due (e-commerce, gestionale, marketplace, corriere) conviene mettere in mezzo uno strato che orchestra tutto, invece di creare collegamenti uno-a-uno che diventano ingestibili. È lo stesso principio con cui costruisco i flussi automatici che tolgono lavoro ripetitivo dalle mani delle persone: un punto solo dove guardare quando qualcosa non torna.

I quattro errori che vedo costare di più

Sincronizzare tutto il catalogo ogni volta. Con qualche migliaio di articoli è uno spreco che rallenta tutto. Meglio aggiornare solo ciò che è cambiato dall’ultimo giro, tenendo un pieno allineamento notturno come rete di sicurezza.

Non prevedere una scorta di sicurezza. Tra il momento della vendita e quello della sincronizzazione passa sempre del tempo. Tenere uno o due pezzi “invisibili” al sito sui prodotti critici evita quasi tutti gli oversell.

Ignorare il caso in cui il collegamento cade. Il gestionale sarà spento, la rete dell’ufficio ballerà, l’API restituirà un errore: succede. Un’integrazione seria riprova, mette in coda ciò che non è passato e — soprattutto — avvisa qualcuno. Il silenzio è la modalità di guasto peggiore.

Fare corrispondere i prodotti per nome. Serve un codice univoco condiviso, di solito lo SKU. Se sui due sistemi i codici non coincidono, il lavoro vero è la bonifica delle anagrafiche, e va messo in conto prima di partire.

Da cosa dipendono tempi e costi

Non esiste un listino onesto per questo tipo di lavoro, perché la stessa frase — “collegare il sito al gestionale” — può voler dire due settimane o due mesi. Quello che sposta davvero il preventivo è:

• quanti flussi servono: solo le giacenze è un progetto piccolo; giacenze, prezzi, anagrafiche, ordini, documenti e tracking è un progetto strutturato;
• la qualità dei dati di partenza: anagrafiche pulite e codici coerenti accorciano tutto, il disordine è la voce di costo nascosta più frequente;
• il tipo di accesso al gestionale: API documentate, esportazioni, o reverse engineering su un formato proprietario sono tre mondi diversi;
• le varianti: taglie, colori e kit moltiplicano le righe da allineare e le regole da scrivere;
• la manutenzione: un’integrazione non è un lavoro che finisce. I fornitori aggiornano le API, cambiano i formati, si aggiungono canali.

Il mio consiglio, se stai valutando: parti dal flusso che ti fa perdere più tempo o che ti crea più figuracce con i clienti — quasi sempre sono le giacenze — falla funzionare bene, e aggiungi il resto dopo. Un’integrazione piccola che gira da mesi vale molto più di un progetto completo che nessuno si fida di accendere.