Collegare WooCommerce al gestionale senza perdere ordini né giacenze

Magazzino con scaffali pieni di scatole e cassette lungo corsie ordinate

Quando un’attività vende sia in negozio o all’ingrosso sia online, prima o poi arriva la richiesta di collegare WooCommerce al gestionale. L’idea è semplice: prodotti, prezzi e giacenze si gestiscono in un posto solo, e gli ordini del sito entrano nel gestionale senza ricopiarli a mano. Nella pratica i flussi sono tre, con direzioni e tempi diversi, e conviene ragionarci separatamente.

Schema del collegamento: catalogo, prezzi e giacenze vanno dal gestionale a WooCommerce, gli ordini vanno da WooCommerce al gestionale, ogni passaggio scrive in un logGestionaleWooCommerceCatalogo e prezzidi notte, solo i campi del gestionaleGiacenzespesso, solo i prodotti cambiatiOrdiniin coda, con esito e numero ordineLog di ogni passaggio · stop e avviso se un file arriva incompleto

Catalogo e prezzi

Di solito è il gestionale a comandare: codici, descrizioni, prezzi, categorie, varianti. Il sito li riceve e li aggiorna. Il catalogo cambia poco durante la giornata, quindi la sincronizzazione completa la faccio girare di notte; i prezzi possono avere un aggiornamento più frequente se il cliente li cambia spesso.

Il punto delicato è decidere quali dati comandano dove. Le descrizioni scritte per il sito, le immagini e i testi per i motori di ricerca nel gestionale spesso non ci sono, o ci sono in una forma pensata per la fattura. Se la sincronizzazione sovrascrive tutto, ogni notte sparisce il lavoro fatto sul sito. Per questo stabilisco campo per campo cosa arriva dal gestionale e cosa resta del sito, e il codice di importazione tocca solo i primi. Ho scritto di più su questa parte negli articoli sulle importazioni automatiche di cataloghi e su come fare un importer personalizzato per WooCommerce.

Giacenze

Le giacenze sono il flusso più delicato, perché cambiano da due parti: il gestionale le scala quando si vende in negozio, WooCommerce le scala quando si vende online. Se le due vendite avvengono a poca distanza, c’è un intervallo in cui entrambi i sistemi pensano di avere ancora l’ultimo pezzo.

Quell’intervallo non si può eliminare del tutto, ma si può ridurre. Le giacenze le aggiorno spesso e solo per i prodotti che sono cambiati, invece di rileggere tutto il catalogo ogni volta, così l’aggiornamento è leggero e può girare a intervalli brevi. Per i prodotti con pochi pezzi a volte conviene tenere un piccolo margine, cioè mostrare sul sito qualche pezzo in meno di quelli reali; è una scelta commerciale, quindi la decide il cliente.

Ordini

Gli ordini fanno il percorso opposto: nascono su WooCommerce e devono arrivare al gestionale con cliente, righe, spedizione e pagamento. Qui la regola è che nessun ordine si deve perdere e nessun ordine deve entrare due volte. Ogni ordine inviato viene segnato sul sito con l’esito dell’invio e, quando il gestionale lo restituisce, con il numero che ha nel gestionale. Gli ordini non ancora confermati restano in coda e vengono ritentati.

Quando un passaggio si interrompe

Prima o poi succede: il gestionale è spento per manutenzione, la connessione cade, il file del catalogo arriva tagliato a metà. Il collegamento va scritto pensando a questi casi fin dall’inizio.

Le regole che seguo sono poche. Ogni operazione deve poter essere ripetuta senza fare danni: se reinvio lo stesso ordine, il gestionale lo deve riconoscere e non crearne un secondo; se rielaboro lo stesso file delle giacenze, il risultato deve essere identico. Un file incompleto non deve mai essere interpretato come “i prodotti che mancano sono esauriti”: se mi aspetto qualche migliaio di righe e ne arrivano poche decine, l’importazione si ferma e manda un avviso invece di mettere fuori stock mezzo catalogo. E ogni passaggio scrive in un log cosa ha fatto, così quando qualcosa non torna si può ricostruire cosa è successo e da dove ripartire.

Connettore pronto o sviluppo su misura

Alcuni gestionali molto diffusi hanno già un connettore per WooCommerce, fatto dal produttore del gestionale o da terzi. Quando esiste ed è mantenuto lo valuto per primo: costa meno e viene aggiornato da chi conosce il gestionale. Va comunque provato su una copia del sito con i dati veri, perché è lì che si vede se gestisce varianti, listini e spedizioni nel modo che serve al cliente.

Altri gestionali non hanno un connettore, oppure hanno API limitate, oppure permettono solo di esportare file CSV o XML in una cartella o su un FTP. In questi casi serve sviluppo su misura: un plugin che legge i dati nel formato che il gestionale riesce a produrre, li porta su WooCommerce e per gli ordini fa il percorso inverso. È lo stesso tipo di lavoro che ho descritto per importare cataloghi in WooCommerce, con in più il ritorno degli ordini.

Se stai valutando un collegamento di questo tipo, nella pagina dei servizi trovi come lavoro.

← Torna al blog