Collegare WooCommerce al gestionale: come funziona e gli errori da evitare

Sviluppatore web al lavoro

Indice dell'articolo

Collegare WooCommerce al gestionale significa far passare in automatico, nei due sensi, quattro cose: gli ordini, le giacenze, i prezzi e le anagrafiche dei clienti. Il negozio online vende, il gestionale fattura e tiene il magazzino, e nessuno in ufficio ricopia niente a mano. Detto così sembra un lavoro di un pomeriggio. Nei progetti che seguiamo, invece, la parte tecnica del collegamento è quasi sempre la più semplice: i problemi nascono dai dati, da come sono stati tenuti fino a quel giorno e da regole che nessuno aveva mai scritto.

Qui raccontiamo come funziona un’integrazione tra WooCommerce e gestionale e quali errori vediamo più spesso, così da riconoscerli prima di pagarli.

Come funziona il collegamento tra WooCommerce e gestionale

Prima di scegliere un plugin o chiedere un preventivo conviene rispondere a una domanda: per ogni dato, chi comanda? In un’integrazione ben fatta ogni informazione ha una sola fonte, e l’altro sistema si limita a riceverla.

  • Ordini: nascono su WooCommerce e scendono nel gestionale, dove diventano documenti (ordine cliente, DDT, fattura).
  • Giacenze: comanda il gestionale, perché lì passano anche le vendite al banco, gli ordini degli agenti e i carichi dai fornitori. Il sito riceve la quantità disponibile.
  • Prezzi e listini: di solito comanda il gestionale, soprattutto se esistono listini diversi per categoria di cliente.
  • Anagrafiche: il cliente si registra sul sito, ma la sua scheda fiscale vive nel gestionale. Qui bisogna decidere cosa succede quando lo stesso cliente esiste già.

Il “come” tecnico dipende da cosa espone il gestionale. Se ha delle API, i due sistemi si parlano direttamente. Se lavora per importazione ed esportazione di file, come fanno molti gestionali diffusi tra le piccole aziende, Danea Easyfatt compreso, il collegamento passa da un file che il gestionale scarica dal sito a intervalli regolari. Se nessuna delle due strade è disponibile, a volte si può leggere il database del gestionale, con tutte le cautele del caso. È la prima cosa che verifichiamo in analisi, perché cambia tempi e costi del progetto.

Errore 1: la sincronizzazione solo di notte

È la soluzione più comune ed è comoda: una volta al giorno, alle tre di notte, il gestionale manda al sito le giacenze aggiornate. Funziona finché vendi poco. Il guaio arriva con l’articolo che ha due pezzi in magazzino: alle dieci ne vendi uno al banco, alle undici un cliente lo compra online, nel pomeriggio un agente ne prende un altro per un suo cliente. Il sito continua a mostrare due pezzi fino alla notte successiva, e il giorno dopo qualcuno deve telefonare per scusarsi e rimborsare.

La frequenza giusta dipende da quanto ruota il magazzino. Per un catalogo con poche referenze e scorte ampie può bastare qualche aggiornamento al giorno. Per chi vende pezzi singoli o con scorte basse serve un aggiornamento quasi in tempo reale, almeno sugli articoli che si muovono. Una via di mezzo che usiamo spesso: aggiornamento immediato quando la giacenza scende sotto una soglia, aggiornamento periodico per tutto il resto.

Errore 2: codici articolo (SKU) non allineati

Il collegamento tra un prodotto del sito e un articolo del gestionale passa quasi sempre dal codice. Se sul sito il codice è “TV-55-NERO” e nel gestionale “TV55N”, per il software sono due articoli diversi e la giacenza non si aggiorna. Nessun errore a video: semplicemente, quel prodotto resta fermo.

Nei progetti che abbiamo seguito i casi tipici sono sempre gli stessi: codici inseriti a mano con spazi finali, maiuscole e minuscole mescolate, prodotti caricati sul sito prima che esistessero nel gestionale, codici con caratteri speciali che alcuni formati di scambio non digeriscono. Una volta ci è capitato un intero file di esportazione rifiutato dal gestionale per una “&” dentro un codice articolo. Per questo il primo lavoro di un’integrazione è quasi sempre una bonifica: si confrontano i due cataloghi, si stila l’elenco degli articoli che non trovano corrispondenza e si decide caso per caso. Ci vogliono giorni, e conviene metterli in conto.

Errore 3: IVA, varianti e i dettagli che non si vedono in vetrina

Sul sito una maglietta è un prodotto con sei taglie e tre colori. Nel gestionale possono essere diciotto articoli distinti, oppure uno solo con le varianti gestite in un altro modo. Se la corrispondenza tra varianti WooCommerce e articoli del gestionale non è stabilita prima, la giacenza della “M blu” finisce sulla “L nera”, o su nessuna delle due.

L’IVA è l’altro punto delicato. WooCommerce ragiona per classi di imposta, il gestionale per codici IVA. Se la corrispondenza non è mappata, l’ordine arriva con un codice che il gestionale non riconosce e viene scartato, oppure importato in modo sbagliato. Lo stesso vale per spese di spedizione, sconti e coupon: WooCommerce applica uno sconto al carrello intero, mentre molti gestionali accettano solo sconti riga per riga. Va deciso come tradurlo, altrimenti i totali del sito e quelli della fattura non tornano al centesimo. Su come trattare fiscalmente i singoli casi decide il commercialista: il nostro lavoro è far arrivare il dato giusto nel posto giusto.

Errore 4: anagrafiche e dati fiscali incompleti

Per fatturare a un’azienda servono partita IVA, codice SDI o PEC. Se il checkout del sito non li chiede, o li salva in campi che l’integrazione non legge, gli ordini arrivano nel gestionale senza dati fiscali e qualcuno li deve completare a mano. Ci è capitato anche il caso opposto e più subdolo: un indirizzo di consegna compilato male dal cliente, con la ragione sociale al posto della città, che ha prodotto un documento importato vuoto e a importo zero, senza nessun messaggio di errore.

Qui il rimedio sta prima dell’integrazione: un checkout che controlla i campi mentre il cliente li compila (la partita IVA ha una cifra di controllo, il codice SDI ha una lunghezza fissa) evita metà dei problemi a valle.

Errore 5: nessuno si accorge quando si ferma

Un’integrazione che si interrompe non fa rumore. Scade una password, un aggiornamento cambia il formato di un campo, il server del gestionale resta spento per un weekend: gli ordini smettono di scendere, e te ne accorgi quando un cliente chiama per chiedere la fattura. Per questo ogni collegamento che realizziamo ha un controllo che avvisa quando la sincronizzazione non gira da troppo tempo o quando un documento viene rifiutato. È la parte meno visibile del progetto e quella che fa risparmiare più telefonate.

Plugin pronto o integrazione su misura?

Per molti gestionali esistono plugin già fatti, e quando il caso è standard sono la scelta giusta: costano poco e fanno il loro lavoro. Il limite arriva con le regole specifiche dell’azienda: listini per cliente, agenti che inseriscono ordini per conto terzi, magazzini multipli, articoli a peso. Lì un plugin generico va adattato, oppure affiancato da uno sviluppo dedicato. Va tenuto presente anche che le modifiche fatte dentro un plugin di terzi spariscono al primo aggiornamento, se non sono state messe nel posto giusto.

Non serve partire da zero. Su e-commerce B2B e B2C collegati al gestionale spesso lavoriamo su un’installazione WooCommerce già esistente, come è successo con Star Elettronics. Quando invece il gestionale attuale non espone nulla di utilizzabile, o è diventato il vero collo di bottiglia, la strada può essere un gestionale su misura pensato fin dall’inizio per parlare con il sito.

Da dove cominciare

Prima di qualsiasi preventivo, tre verifiche che puoi fare da solo: controlla se i codici articolo del sito e del gestionale coincidono su un campione di venti prodotti; chiedi al fornitore del gestionale se esistono API o un formato di importazione documentato; segnati quante volte al mese capita di vendere online qualcosa che non c’era. Le risposte dicono già molto su quanto lavoro serve.

Se vuoi un parere su come collegare il tuo negozio online al gestionale che usi oggi, scrivici e fissiamo un’analisi: guardiamo insieme cosa espone il tuo gestionale e ti diciamo se il collegamento ha senso, e con quale approccio.

Condividi questo articolo

Hai un progetto in mente?

Raccontacelo: lo trasformiamo in una soluzione digitale su misura.

Lascia un messaggio!