Integrazioni
Collegare e-commerce e gestionale: come sincronizzare i dati.
Quando prodotti, prezzi e giacenze vivono nel gestionale e vanno ricopiati a mano nel negozio online, prima o poi un prezzo sbagliato arriva al cliente. Un connettore automatico tiene allineati i due sistemi e toglie questo lavoro alle persone.
Di Alessandro Negru · Sviluppatore software · · 4 min di lettura
01 / Lavoro doppio
Il problema dei dati doppi
In molte aziende il catalogo nasce nel gestionale o nel database interno: codici articolo, descrizioni, listini, disponibilità. Il negozio online, però, ha un suo database. Se nessuno li collega, qualcuno deve aggiornare a mano entrambi.
Finché i prodotti sono pochi funziona. Con centinaia di articoli e prezzi che cambiano spesso, il lavoro manuale diventa lento e porta a errori concreti: prezzi vecchi online, prodotti esauriti ancora acquistabili, articoli duplicati con codici diversi.
02 / Le informazioni
Cosa sincronizzare
Non tutti i dati devono viaggiare nello stesso verso. Prima di scrivere codice conviene decidere, per ogni informazione, quale sistema è la fonte ufficiale:
| Dato | Fonte ufficiale | Direzione |
|---|---|---|
| Anagrafica prodotti | Gestionale | Gestionale → e-commerce |
| Prezzi e listini | Gestionale | Gestionale → e-commerce |
| Giacenze | Magazzino o gestionale | Gestionale → e-commerce, spesso frequente |
| Ordini | E-commerce | E-commerce → gestionale |
| Clienti | Dipende dall’azienda | Da decidere caso per caso |
Avere una sola fonte ufficiale per ogni dato è la regola più importante. Se prezzi e descrizioni si possono modificare in entrambi i sistemi, prima o poi una modifica sovrascrive l’altra.
03 / Dietro le quinte
Come funziona un connettore
Un connettore è un piccolo programma che fa da ponte tra i due sistemi. Il ciclo tipico è questo:
Legge la fonte
Estrae dal gestionale o dal database aziendale i prodotti nuovi o modificati.
Trasforma i dati
Adatta formati, categorie e prezzi a quello che si aspetta il negozio online.
Riconosce cosa esiste già
Confronta i codici articolo per aggiornare i prodotti esistenti invece di crearne di nuovi.
Scrive e registra
Crea o aggiorna i prodotti nell’e-commerce e tiene traccia di cosa è andato a buon fine e cosa no.
Il connettore può girare a orari fissi, per esempio ogni notte o ogni ora, oppure partire quando un dato cambia. La frequenza dipende da quanto spesso cambiano prezzi e giacenze e da quanto è grave mostrare un dato non aggiornato.
API, database o file: i metodi
Ci sono tre modi principali per far comunicare i sistemi, e spesso si combinano:
- API. È il metodo più pulito. Piattaforme come WooCommerce, Shopify o PrestaShop offrono interfacce documentate per leggere e scrivere prodotti e ordini. Rispettano le regole della piattaforma e sopravvivono meglio agli aggiornamenti.
- Accesso al database. Quando il gestionale non ha API, si leggono i dati direttamente dal suo database, per esempio MySQL, con un utente in sola lettura.
- File di esportazione. CSV o XML generati dal gestionale e importati nel negozio. È il metodo più semplice e il più fragile: basta una colonna spostata per rompere l’import.
Per la logica di trasformazione uso spesso Python, adatto a leggere database, lavorare sui dati e chiamare API.
05 / Attenzione
Gli errori da evitare
- Riconoscere i prodotti dal nome. I nomi cambiano. Serve un codice univoco condiviso, come il codice articolo o lo SKU.
- Nessun registro. Se un aggiornamento fallisce in silenzio, te ne accorgi solo quando un cliente segnala un prezzo sbagliato. Ogni esecuzione deve lasciare traccia.
- Testare sul negozio vero. Le prime prove vanno fatte su una copia del sito, mai direttamente sul catalogo online.
- Dimenticare i casi particolari. Prezzi per categoria di cliente, varianti, IVA e prodotti fuori produzione vanno gestiti in modo esplicito.
06 / Esperienza sul campo
Un caso reale: MySQL e WooCommerce
Per un’azienda ho sviluppato in Python un connettore tra il database MySQL aziendale e il sito e-commerce. Importa automaticamente prodotti e prezzi, riconosce gli articoli già presenti e li aggiorna senza creare duplicati.
Lo stesso connettore è servito nel refactoring dell’e-commerce di Toscana Stampaggi, su WordPress e WooCommerce. Lì i prezzi andavano adattati al formato richiesto da un plugin di prezzi per ruolo cliente, e il risultato ha permesso di attivare gli acquisti online, prima non disponibili.
Il progetto del connettoreDa dove partire
Per valutare un’integrazione servono poche informazioni:
- quale gestionale o database usate e se offre API o esportazioni;
- quale piattaforma e-commerce avete, e con quali plugin per prezzi e varianti;
- quanti prodotti gestite e quanto spesso cambiano prezzi e giacenze;
- quali errori capitano oggi più spesso.
Serve rifare il sito?
Di solito no. Un connettore lavora accanto al sito esistente. Il rifacimento serve solo se la piattaforma attuale non permette di gestire i dati necessari, come è successo nel caso degli acquisti online di Toscana Stampaggi.