Quando un'azienda vende online, due mondi spesso coesistono: quello del negozio e-commerce (WooCommerce, PrestaShop, Shopify, Magento…) che gestisce il front-office e gli ordini web, e quello dell'ERP/CRM Dolibarr che pilota il back-office (scorte, contabilità, fatturazione, fornitori, HR). Finché questi due sistemi non comunicano, perdi tempo, moltiplichi le immissioni manuali e accumuli rischi di errore: sovrastock, rotture, fatture incoerenti, frustrazioni dei clienti.
La soluzione? Collegare Dolibarr al tuo negozio e-commerce per automatizzare la sincronizzazione di prodotti, scorte, ordini, clienti, prezzi e tasse. In questa guida funzionale completa, NEXT GESTION ti spiega come riuscire in questa integrazione con WooCommerce e PrestaShop, le due soluzioni e-commerce open source più utilizzate in Europa. Affronteremo le scelte di architettura, i flussi da implementare, le best practice di business, la sicurezza e le prestazioni, restando funzionali senza entrare nel dettaglio del codice ma con sufficiente precisione per pilotare un progetto di integrazione.
Sommario
- Perché collegare Dolibarr al tuo e-commerce?
- Panoramica funzionale dell'integrazione
- I diversi approcci di connessione
- Prerequisiti e preparazione del progetto
- Scegliere quali flussi sincronizzare
- Connessione a WooCommerce: i punti chiave
- Connessione a PrestaShop: i punti chiave
- Sincronizzazione del catalogo prodotti
- Sincronizzazione delle scorte
- Sincronizzazione degli ordini
- Sincronizzazione dei clienti
- Gestione di prezzi, promozioni e multi-valuta
- Gestione delle tasse e dell'IVA intracomunitaria
- Sincronizzazione in tempo reale o pianificata
- Mettere in sicurezza l'integrazione
- Prestazioni e scalabilità
- Pilotaggio, monitoraggio e indicatori
- Manutenzione ed evoluzioni
- Errori comuni e best practice
- Conclusione
1. Perché collegare Dolibarr al tuo e-commerce?
Prima di immergerci nell'implementazione, ricordiamo i benefici concreti di una tale integrazione:
- Eliminazione della doppia immissione: un ordine effettuato su WooCommerce risale automaticamente in Dolibarr, senza intervento umano.
- Affidabilità delle scorte: un prodotto venduto online decrementa immediatamente lo stock nell'ERP, e un riassortimento registrato in Dolibarr aggiorna la disponibilità mostrata sul sito.
- Fatturazione automatizzata: le fatture sono generate e numerate in Dolibarr secondo il tuo piano dei conti, nel rispetto degli obblighi legali.
- Visione cliente unificata: una sola anagrafica Dolibarr raggruppa gli ordini web, in negozio, telefonici e marketplace. Disponi finalmente di una visione 360° del cliente.
- Gestione contabile conforme: la contabilità è tenuta in Dolibarr, fonte di verità legale e fiscale.
- Scalabilità: lo stesso Dolibarr può pilotare più negozi (WooCommerce + PrestaShop + B2B) simultaneamente, e puoi aprire un nuovo canale senza ricostruire il tuo sistema informativo.
- Produttività dei team: i tuoi collaboratori passano meno tempo a ricopiare dati e più tempo a servire i clienti, ad analizzare le vendite o ad animare le promozioni.
L'investimento iniziale viene rapidamente ammortizzato già con qualche decina di ordini al giorno, e il ritorno sull'investimento aumenta con la crescita della tua attività.
2. Panoramica funzionale dell'integrazione
Un'integrazione robusta si basa su una visione chiara dei flussi informativi da implementare tra Dolibarr e il negozio. Schematicamente, coesistono due direzioni di flusso.
Flusso Dolibarr → e-commerce (discendente)
È la direzione in cui Dolibarr alimenta il negozio:
- Catalogo prodotti: riferimento, etichetta, descrizione, categoria, foto, attributi e schede tecniche.
- Scorte: quantità disponibili per magazzino e per variante.
- Prezzi: tariffe pubbliche, prezzi per gruppo cliente, prezzi a scaglioni, prezzi promozionali.
- Promozioni e codici sconto.
- Stati degli ordini: passaggio da «preparato» a «spedito», numero di tracking.
Flusso e-commerce → Dolibarr (ascendente)
È la direzione in cui il negozio alimenta Dolibarr:
- Nuovi ordini: righe, opzioni, spese di spedizione, tasse, totale, metodo di pagamento.
- Nuovi clienti: account, indirizzi di fatturazione e di consegna.
- Stati di pagamento: confermato, annullato, rimborsato.
- Note di credito e resi.
- Recensioni e messaggi clienti (a seconda della configurazione).
Il ruolo del connettore
Il connettore è il pezzo centrale che orchestra questi flussi. Può prendere la forma di un modulo installato in Dolibarr, di un servizio intermedio (middleware) o di uno sviluppo su misura. Quale che sia la sua forma, deve realizzare tre missioni essenziali: tradurre i concetti di ciascun sistema (un prodotto Dolibarr ≠ un prodotto WooCommerce nel suo modello dati), trasportare i dati in modo affidabile e sicuro, e riconciliare regolarmente le divergenze che inevitabilmente compariranno.
3. I diversi approcci di connessione
Tre grandi approcci si offrono a te in base al tuo volume, al tuo budget e alla complessità delle tue regole di business.
Moduli chiavi in mano
Dolibarr e i suoi partner offrono moduli connettori disponibili sul Dolistore. Esistono per WooCommerce, PrestaShop, Magento e altre piattaforme. Vantaggi: installazione rapida, prezzo accessibile (spesso meno di 200 €), manutenzione assicurata dall'editore. Limiti: copertura funzionale a volte incompleta, poca personalizzazione possibile. È l'approccio ideale per un progetto pilota o un negozio con regole standard.
Middleware d'integrazione
Strumenti come Make, n8n, Zapier o Tray.io permettono di creare scenari di sincronizzazione senza sviluppo. Centralizzano la logica di mapping e offrono un monitoraggio visuale dei flussi. Vantaggi: flessibilità, monitoraggio integrato, possibilità di collegare altri strumenti (CRM, marketing, contabilità). Limiti: costo mensile proporzionale al volume, dipendenza da un fornitore terzo. Approccio pertinente per le strutture che desiderano pilotare più integrazioni contemporaneamente.
Sviluppo su misura
Per esigenze molto specifiche (B2B con cataloghi differenziati, multi-marca, multi-valuta avanzata, regole tariffarie complesse), un connettore dedicato sviluppato per il tuo contesto resta la soluzione più flessibile. Vantaggi: copertura funzionale totale, prestazioni ottimizzate, proprietà del codice. Limiti: costo iniziale più elevato, necessità di una manutenzione continua. È l'approccio che NEXT GESTION privilegia per i progetti esigenti.
La scelta giusta dipende principalmente da tre criteri: il volume di ordini, la complessità delle tue regole di business e la tua capacità di internalizzare una parte della manutenzione.
4. Prerequisiti e preparazione del progetto
Un progetto d'integrazione riuscito comincia molto prima della prima riga di configurazione.
Audit funzionale
Poniti le domande giuste: quanti prodotti hai? quanti ordini al giorno? quali regole tariffarie applichi? hai varianti (taglia/colore)? più magazzini? più valute? un'attività B2B con inversione contabile? Elenca con precisione i casi particolari e le eccezioni: sono loro che fanno passare un progetto dal semplice al complesso.
Scelta della fonte di verità
Per ciascun tipo di dato, designa una fonte di verità unica:
- Prodotti: generalmente Dolibarr, che invia le schede al negozio.
- Scorte: Dolibarr è master, il negozio riflette ciò che dice.
- Ordini: il negozio è master, Dolibarr riceve.
- Clienti: a seconda dei casi, ma in generale, l'anagrafica Dolibarr è consolidata a partire dagli account negozio.
- Contabilità e fatture: esclusivamente Dolibarr.
Senza questa regola, vai incontro a conflitti irrisolvibili.
Versioni e compatibilità
Verifica che le tue versioni siano aggiornate e compatibili tra loro. Dolibarr 19 o 20, WooCommerce 8 o 9, PrestaShop 8 sono le combinazioni più stabili oggi. Qualsiasi versione più vecchia dovrebbe essere aggiornata prima del progetto.
Ambienti
Prepara imperativamente un ambiente di pre-produzione identico alla produzione: database copiato, dati reali anonimizzati, stesse versioni, stessi moduli. Tutti i test di integrazione si svolgeranno qui. Non testare mai un nuovo connettore direttamente in produzione.
Cartografia dei dati
Documenta con precisione la tabella di corrispondenza: quale proprietà WooCommerce/PrestaShop corrisponde a quale campo Dolibarr? quali trasformazioni applicare (conversione imponibile/IVA inclusa, raggruppamento di categorie, formato di data, valuta)? Questa cartografia è la pietra angolare del progetto.
5. Scegliere quali flussi sincronizzare
Piuttosto che sincronizzare tutto subito, è più prudente procedere per fasi. Ecco un ordine di distribuzione collaudato:
- Catalogo prodotti discendente (Dolibarr → negozio): per assicurarsi che i tuoi riferimenti, etichette e prezzi siano coerenti.
- Scorte discendenti: il negozio riflette le disponibilità reali.
- Ordini ascendenti: gli ordini web creano ordini in Dolibarr.
- Clienti ascendenti: i nuovi account web creano o arricchiscono le anagrafiche Dolibarr.
- Stati degli ordini discendenti: Dolibarr informa il negozio della spedizione.
- Fatture e note di credito: a seconda dei tuoi processi, generazione automatica in Dolibarr e invio al cliente.
Ogni fase è validata in pre-produzione prima di passare in produzione. Questo approccio incrementale riduce considerevolmente i rischi e permette ai tuoi team di acquisire competenze gradualmente.
6. Connessione a WooCommerce: i punti chiave
WooCommerce, estensione di WordPress, equipaggia circa un terzo dei siti e-commerce mondiali. È una piattaforma particolarmente ricca grazie al suo ecosistema di plugin, ma questo complica anche l'integrazione.
Punti di attenzione funzionali
- Permalink WordPress: devono essere configurati in modalità «Nome dell'articolo» perché i flussi funzionino correttamente.
- Account utente: un account applicativo dedicato, distinto dall'amministratore, deve essere creato per il connettore. Ha i permessi strettamente necessari (lettura/scrittura su prodotti, ordini, clienti).
- Gestione delle scorte: attivala in WooCommerce e scegli la modalità «per prodotto» o «per variazione» a seconda del tuo catalogo.
- Classi fiscali: crea esplicitamente le classi corrispondenti alle tue aliquote IVA e mappale verso Dolibarr.
- Stati personalizzati: se utilizzi stati di ordine specifici (preparazione, spedizione parziale…), prevedi una mappatura verso gli stati Dolibarr equivalenti.
Particolarità da anticipare
WooCommerce gestisce i prodotti variabili con variazioni collegate (taglia/colore). Il mapping con il modulo Variants di Dolibarr richiede particolare attenzione. Allo stesso modo, le spese di spedizione sono righe specifiche sull'ordine WooCommerce che bisogna tradurre correttamente (articolo di servizio o riga libera in Dolibarr).
Infine, WooCommerce espone eventi che il negozio può inviare a Dolibarr: ordine creato, ordine aggiornato, cliente creato… Questi eventi evitano di interrogare periodicamente il negozio e garantiscono un aggiornamento quasi istantaneo.
7. Connessione a PrestaShop: i punti chiave
PrestaShop è una piattaforma francese molto diffusa in Europa, particolarmente adatta a cataloghi ricchi e ad attività multi-negozio.
Punti di attenzione funzionali
- Webservice: deve essere esplicitamente attivato nei parametri avanzati, e una chiave d'accesso dedicata al connettore deve essere creata con i diritti adatti (prodotti, categorie, clienti, indirizzi, ordini, scorte, tasse, produttori).
- Multi-negozio: se gestisci più negozi sotto la stessa installazione PrestaShop, precisa a quale
id_shopsi applica ciascun flusso. - Multi-lingua: le etichette dei prodotti sono multilingue. Decidi quale lingua è master in Dolibarr e configura il mapping con gli
id_langPrestaShop corrispondenti. - Combinazioni: equivalenti delle variazioni WooCommerce, corrispondono alle declinazioni di un prodotto (taglia, colore). Il mapping verso le varianti Dolibarr è specifico.
- Carriers: i corrieri PrestaShop devono essere mappati verso le modalità di spedizione Dolibarr.
Particolarità da anticipare
PrestaShop separa rigorosamente il cliente e i suoi indirizzi: uno stesso cliente può avere più indirizzi di fatturazione e di consegna. Questa separazione si riflette bene in Dolibarr (anagrafica + contatti), ma richiede di orchestrare bene la creazione congiunta delle entità durante un nuovo ordine.
PrestaShop applica anche regole di tassa per gruppo che dipendono dal paese di consegna. Il connettore deve quindi integrare la logica OSS europea per le vendite intracomunitarie B2C.
8. Sincronizzazione del catalogo prodotti
Il catalogo è generalmente il primo flusso da implementare. Alcune regole d'oro:
Il riferimento prodotto, chiave di tutto
Il riferimento interno (SKU) deve essere univoco e identico da entrambi i lati. È quello che funge da identificatore pivot. Si raccomanda di generarlo in Dolibarr secondo una nomenclatura coerente (per esempio CAT-FAM-NUM) e poi inviarlo al negozio. Se migri da un e-commerce esistente, allinea prima i riferimenti, prima di tutto il resto.
Le informazioni arricchite
Oltre ai campi di base (nome, prezzo, descrizione), pensa agli elementi che fanno la qualità del catalogo online:
- Descrizione breve e descrizione lunga (spesso in HTML).
- Categoria principale e categorie secondarie.
- Marca o produttore.
- Caratteristiche tecniche (peso, dimensioni, materiale…).
- Parole chiave SEO.
- Foto principali e galleria di immagini.
- Documenti associati (manuale, scheda tecnica).
Tutti questi elementi possono essere gestiti in Dolibarr tramite i campi nativi e i campi supplementari (extrafield), poi inviati al negozio.
Ciclo di vita di un prodotto
Definisci chiaramente gli stati: un prodotto in bozza in Dolibarr non deve apparire in negozio. Un prodotto obsoleto deve essere disattivato sul sito ma conservato nell'ERP per lo storico. Un prodotto promozionale può avere un periodo di validità.
Le immagini
La sincronizzazione delle immagini è spesso trascurata ma rappresenta un volume di dati importante. È cruciale ottimizzare i formati (WebP raccomandato), rispettare le dimensioni imposte dal negozio e prevedere un'attivazione progressiva durante la prima sincronizzazione.
9. Sincronizzazione delle scorte
La gestione delle scorte è il punto critico di qualsiasi integrazione e-commerce. Una rottura di stock scoperta al momento della spedizione è una delle principali fonti di insoddisfazione del cliente.
Modalità di calcolo dello stock visualizzato
Diverse strategie sono possibili:
- Stock unico consolidato: il negozio riceve la somma di tutti i magazzini. Ideale se spedisci da un unico sito.
- Stock per magazzino: utile se hai più siti logistici con regole di spedizione per zona geografica.
- Stock virtuale: tiene conto degli ordini cliente in attesa e degli ordini fornitori previsti, per dare una visione dinamica.
- Stock con buffer: si tolgono sistematicamente alcune unità dallo stock visualizzato per assorbire le latenze tra i due sistemi.
Il buffer di sicurezza è particolarmente raccomandato per i prodotti ad alta rotazione, dove il rischio di sovravvendita è elevato.
Prevenzione della sovravvendita
Per limitare al massimo le sovravvendite:
- Attiva la prenotazione al carrello in WooCommerce/PrestaShop: lo stock viene immobilizzato dal momento in cui il prodotto entra nel carrello.
- Configura la sincronizzazione immediata al momento dell'ordine: il negozio notifica Dolibarr istantaneamente, e Dolibarr rinvia il nuovo stock al negozio.
- Imposta un avviso quando un prodotto scende sotto una soglia critica (per esempio stock = 3) per anticipare il riassortimento.
Frequenza di sincronizzazione
Una sincronizzazione ogni 5-15 minuti è generalmente sufficiente, completata da un evento immediato a ogni ordine. Una sincronizzazione totale del catalogo può essere pianificata di notte per recuperare eventuali divergenze.
10. Sincronizzazione degli ordini
È il flusso più visibile: ogni ordine effettuato sul negozio deve attivare la creazione di un ordine in Dolibarr.
Lo scenario tipo
Quando un cliente convalida il suo carrello e paga, il negozio trasmette a Dolibarr l'insieme delle informazioni dell'ordine: cliente, indirizzi, righe, spese di spedizione, sconti, tasse, totale, metodo di pagamento, stato. Dolibarr esegue allora diverse operazioni a catena:
- Ricerca o creazione dell'anagrafica corrispondente (per email, numero di P.IVA o identificativo negozio).
- Creazione dell'ordine cliente in Dolibarr con tutte le sue righe.
- Validazione automatica o in attesa di controllo, secondo la tua configurazione.
- Decremento delle scorte nel magazzino corretto.
- Generazione della fattura alla conferma del pagamento.
- Eventuale creazione della spedizione quando l'ordine passa in preparazione.
Mapping dei metodi di pagamento
Ciascun metodo di pagamento del negozio (carta bancaria via Stripe, PayPal, bonifico, assegno, contrassegno) deve essere mappato verso un metodo di pagamento Dolibarr corrispondente. Questo garantisce la coerenza contabile e la leggibilità dei report.
Mapping degli stati degli ordini
Gli stati WooCommerce/PrestaShop non corrispondono esattamente agli stati Dolibarr. Devi definire una tabella di corrispondenza:
- In attesa → Bozza o Validato a seconda del regolamento.
- In corso → Validato + in preparazione.
- Completato → Consegnato e fatturato.
- Annullato → Annullato.
- Rimborsato → Nota di credito generata.
Casi particolari
Diverse situazioni meritano particolare attenzione: gli ordini misti (prodotti a stock + servizi), gli ordini con acconto, gli ordini pre-pagati o differiti, gli annullamenti parziali. Documenta ciascuno di questi casi nel capitolato e testali in pre-produzione.
11. Sincronizzazione dei clienti
Un cliente e-commerce diventa un'anagrafica in Dolibarr. Si presentano diversi casi.
Account ospite o account registrato
Un ordine può essere effettuato da un cliente che crea un account o da un visitatore in modalità ospite. In entrambi i casi, Dolibarr deve creare un'anagrafica, ma con regole diverse: un account registrato può essere consolidato con i suoi ordini futuri, mentre un ospite può essere considerato un'anagrafica occasionale.
Deduplicazione
Per evitare i duplicati, il connettore deve cercare prima di creare. I criteri di deduplicazione sono in generale: email esatta, numero di P.IVA intracomunitaria, identificativo negozio. Senza questa logica, accumuli schede duplicate che rendono le tue analisi inefficaci.
Caso del B2B
Per i clienti professionali, valida il numero di P.IVA intracomunitaria presso il servizio europeo VIES. Un numero valido apre il diritto all'inversione contabile e quindi a una fatturazione esente da tasse. Un numero non valido deve essere rifiutato o segnato come tale per trattamento manuale.
Indirizzi multipli
Dolibarr permette più contatti per anagrafica (fatturazione, consegna, contatto tecnico…). Il negozio deve nutrire questi contatti rispettando la semantica: indirizzo di fatturazione, indirizzo di consegna, contatti eventuali per gli account professionali. Questa finezza migliora molto la qualità delle bolle di consegna e delle fatture.
Comunicazioni e marketing
Se sincronizzi i clienti, puoi anche inviare le loro preferenze: opt-in marketing, newsletter, segmenti. Queste informazioni sono preziose per le tue campagne.
12. Gestione di prezzi, promozioni e multi-valuta
Tariffazione per gruppo cliente
Dolibarr offre diversi livelli di prezzi: prezzi per livello (multi-prezzi) e prezzi per cliente. Per esporli correttamente in negozio, bisogna decidere quale livello è pubblico e quali livelli sono riservati a gruppi specifici (rivenditori, professionisti, clienti fedeli). WooCommerce e PrestaShop dispongono della nozione di gruppi clienti che si mappano a questi livelli.
Promozioni
Coesistono due filosofie:
- Promozione gestita in Dolibarr: gli sconti sono definiti nell'ERP e propagati al negozio.
- Promozione gestita nel negozio: il negozio gestisce i codici promo e invia il totale ridotto a Dolibarr al momento dell'ordine.
Il secondo approccio è generalmente più semplice. Il connettore deve allora creare una riga di sconto nell'ordine Dolibarr e conservare la tracciabilità del codice utilizzato per le analisi marketing.
Multi-valuta
Se vendi in più valute, il modulo Multi-valuta di Dolibarr deve essere attivato. Ogni ordine conserva la valuta originale e il tasso di cambio applicato al momento dell'acquisto. Questo permette di riconciliare correttamente i pagamenti (spesso versati nella valuta di vendita poi convertiti) e la contabilità (generalmente tenuta in euro).
13. Gestione delle tasse e dell'IVA intracomunitaria
Vendite B2C nell'Unione europea
Da luglio 2021, il regime dello sportello unico OSS impone di applicare l'aliquota IVA del paese di consegna appena la soglia annuale di 10.000 € viene superata. Questo significa che una vendita verso il Belgio applica il 21%, verso la Germania il 19%, verso l'Italia il 22%, ecc. Il connettore deve quindi:
- Identificare il paese di consegna.
- Applicare l'aliquota corretta secondo la matrice OSS.
- Configurare in Dolibarr i codici tassa corrispondenti.
- Preparare le dichiarazioni OSS trimestrali con gli importi per paese.
Vendite B2B intracomunitarie
Se il cliente B2B fornisce un numero di P.IVA intracomunitaria valido, la fattura è in imponibile con la dicitura obbligatoria «Inversione contabile – Articolo 196 direttiva IVA 2006/112/CE». Questo comporta diverse implicazioni funzionali: validazione del numero VAT a monte, applicazione di un'aliquota IVA allo 0%, aggiunta automatica della dicitura legale sulla fattura PDF.
Vendite extra UE
Per le esportazioni fuori dall'Unione europea, la fattura è generalmente in imponibile con la dicitura «Esportazione – Articolo 8 DPR 633/72» (o equivalente locale). Il connettore deve gestire questi casi specifici in funzione dell'indirizzo del cliente.
Configurazione delle classi fiscali
In WooCommerce e PrestaShop, crea esplicitamente le classi fiscali corrispondenti (standard, ridotta, esente B2B, extra UE) e mappale con precisione verso i codici tassa Dolibarr.
14. Sincronizzazione in tempo reale o pianificata
Approccio per polling
In questo approccio, un programma si esegue periodicamente (ogni 5, 10 o 15 minuti) e interroga i due sistemi per individuare i cambiamenti. È semplice da implementare ma introduce una latenza: un cliente può ordinare alle 14:00 e l'ordine arrivare in Dolibarr solo alle 14:10.
Approccio event-driven
In questo approccio, il negozio notifica Dolibarr immediatamente non appena si verifica un evento (ordine creato, pagamento validato, prodotto modificato). Dolibarr reagisce in tempo reale. È più complesso da orchestrare ma offre un'esperienza nettamente superiore, in particolare per la gestione delle scorte e la conferma al cliente.
Approccio ibrido
È la strategia raccomandata: event-driven per i flussi critici (ordini, scorte, pagamenti), polling di riconciliazione ogni 15 minuti per recuperare eventuali fallimenti e garantire la coerenza a lungo termine.
Code di lavoro
Per assorbire i picchi di traffico (vendite flash, saldi) senza saturare Dolibarr, intercala una coda di lavoro tra il negozio e l'ERP. Gli eventi vi sono depositati e poi trattati da uno o più worker al ritmo che Dolibarr può sostenere. Questa architettura evita le perdite in caso di picco e permette di rilanciare automaticamente i trattamenti falliti.
Idempotenza
Qualunque sia la modalità scelta, ciascun evento deve essere idempotente: ricevere due volte la stessa notifica non deve creare due ordini. Il connettore conserva un registro degli eventi trattati per garantire questa proprietà.
15. Mettere in sicurezza l'integrazione
L'integrazione apre un canale di comunicazione sensibile tra il tuo negozio e il tuo ERP. La sua sicurezza non deve mai essere trascurata.
Autenticazione
Usa sistematicamente chiavi API dedicate per il connettore. Non riutilizzare mai le credenziali di amministratore. Conserva queste chiavi in casseforti (HashiCorp Vault, gestori di segreti cloud) o in file di configurazione con diritti limitati, mai in chiaro nel codice condiviso.
HTTPS ovunque
Tutti gli scambi devono passare in HTTPS con TLS 1.2 minimo, idealmente TLS 1.3. Nessuna eccezione, nemmeno in pre-produzione.
Restrizione per indirizzo IP
Se possibile, restringi l'accesso agli endpoint d'integrazione ai soli indirizzi IP del negozio (e viceversa). Questo limita considerevolmente la superficie d'attacco.
Firma delle notifiche
Ogni notifica inviata dal negozio deve essere firmata con un segreto condiviso. Il connettore verifica questa firma prima di trattare la notifica. Senza questo, chiunque potrebbe iniettare ordini falsi in Dolibarr.
Limitazione di velocità
Implementa un rate limiting lato Dolibarr affinché un connettore difettoso (o un attacco) non saturi il server. Oltre una certa soglia di richieste al minuto, le nuove richieste vengono temporaneamente respinte.
Logging
Traccia tutti gli eventi: chi ha chiamato, quando, con quale risultato, quanto tempo è durato. Questi log sono essenziali per gli audit, il debug e il rilevamento di anomalie.
16. Prestazioni e scalabilità
Paginazione degli scambi
Quando sincronizzi grandi volumi (diverse migliaia di prodotti o di ordini), è imperativo paginare le richieste: recuperare i dati per pagine di 50 o 100 piuttosto che in una sola volta. Questo evita i timeout e alleggerisce il server.
Trattamento per lotti
Per gli import massivi, usa gli endpoint batch di WooCommerce e PrestaShop che permettono di creare o aggiornare più entità in una sola chiamata. Il guadagno di prestazione è significativo.
Messa in cache
Alcuni dati cambiano raramente: aliquote IVA, metodi di pagamento, categorie, corrieri. Mettili in cache lato connettore per non chiederli a ogni operazione.
Indicizzazione del database
Lato Dolibarr, verifica che i campi utilizzati per la deduplicazione delle anagrafiche (email, numero di P.IVA) e i riferimenti dei prodotti siano ben indicizzati. Altrimenti, ogni creazione di ordine può richiedere diversi secondi quando il database cresce.
Scaling orizzontale
Per i grandissimi volumi (più di 10.000 ordini al giorno), prevedi un'architettura in cui più connettori possano trattare gli eventi in parallelo, dietro la stessa coda di lavoro. Dolibarr può anche essere distribuito dietro un load balancer con sessioni condivise.
17. Pilotaggio, monitoraggio e indicatori
Un'integrazione non è un progetto «one-shot». Deve essere pilotata quotidianamente.
Cruscotto operativo
Implementa un cruscotto che mostri:
- Numero di ordini sincronizzati per ora.
- Numero di prodotti aggiornati.
- Volume delle divergenze di stock rilevate.
- Latenza media delle sincronizzazioni.
- Dimensione della coda di lavoro.
- Numero di eventi in errore.
Avvisi proattivi
Configura avvisi per le anomalie critiche: coda bloccata, tasso di errore superiore al 5%, nessun ordine risalito da più di 30 minuti in orario lavorativo. Questi avvisi possono essere inviati per email, Slack o Microsoft Teams.
Riconciliazione periodica
Una volta a settimana, lancia un rapporto di riconciliazione che confronta i dati tra Dolibarr e il negozio: prodotti mancanti, divergenze di prezzo, divergenze di stock, ordini non risaliti. È questo rapporto che individua le derive lente prima che diventino problemi critici.
Reporting di business
Oltre al monitoraggio tecnico, alimenta i tuoi cruscotti di business: fatturato per canale (web vs negozio), prodotti più venduti online, tasso di carrello abbandonato, valore medio degli ordini web. Tutte queste analisi sono possibili dal momento in cui Dolibarr centralizza i dati.
18. Manutenzione ed evoluzioni
Le API e le piattaforme evolvono. WooCommerce, PrestaShop e Dolibarr pubblicano regolarmente nuove versioni, a volte con cambiamenti impattanti.
Versionare i flussi
I tuoi flussi di integrazione devono sempre precisare la versione d'API utilizzata. Un cambiamento di versione deve essere validato in pre-produzione prima del deployment.
Test automatizzati
Implementa una suite di test automatizzati che valida i principali scenari: creazione di prodotto, sincronizzazione di stock, creazione di ordine, generazione di fattura. Questa suite viene rigiocata dopo ogni aggiornamento per individuare immediatamente le regressioni.
Vigilanza funzionale
Segui gli annunci degli editori (note di versione Dolibarr, changelog WooCommerce, blog PrestaShop). Anticipare un'evoluzione importante piuttosto che subirla fa risparmiare un tempo considerevole.
Piano di continuità
Documenta un piano di continuità: cosa succede se il negozio va giù? se Dolibarr non è disponibile per qualche ora? se la coda di lavoro satura? Avere queste risposte pronte riduce considerevolmente lo stress in caso di incidenti.
19. Errori comuni e best practice
Nel corso dei progetti, alcune insidie ricorrono:
- Sottostimare la fase di cartografia dei dati: metà del lavoro è nella definizione precisa delle corrispondenze. Non saltare questa tappa.
- Testare solo in produzione: è la garanzia di problemi gravi. Investi in un ambiente di pre-produzione realistico.
- Trascurare la deduplicazione delle anagrafiche: in poche settimane, accumuli duplicati che rendono le tue analisi inefficaci.
- Dimenticare le spese di spedizione: rappresentano spesso il 10% del fatturato e devono essere correttamente contabilizzate.
- Non anticipare i saldi o le vendite flash: il picco di carico può far vacillare un connettore dimensionato per il quotidiano.
- Mancare di monitoraggio: senza avvisi, un connettore in errore passa inosservato per ore o persino giorni.
- Confondere valuta di visualizzazione e valuta di fatturazione: può creare divergenze contabili impossibili da recuperare.
- Ignorare la formazione degli utenti: un buon connettore mal usato resta un cattivo strumento.
Al contrario, le best practice strutturanti sono: definire chiaramente le fonti di verità, distribuire per fasi, testare sistematicamente, monitorare in continuo e documentare tutto ciò che esce dall'ordinario.
20. Conclusione
Collegare Dolibarr a WooCommerce o PrestaShop è un progetto ad alto ritorno sull'investimento, ma richiede rigore funzionale e visione chiara. Ben fatto, trasforma le tue operazioni: automazione delle immissioni, affidabilità delle scorte, soddisfazione cliente accresciuta, contabilità semplificata. Mal fatto, diventa una fonte quotidiana di bug e frustrazioni.
Da NEXT GESTION, accompagniamo le aziende e-commerce nella progettazione, distribuzione e gestione di connettori Dolibarr su misura o basati su moduli esistenti. Il nostro approccio: audit funzionale approfondito, scelta tecnologica adatta, distribuzione iterativa con collaudo in pre-produzione, monitoraggio in produzione, supporto continuo e accompagnamento alla gestione del cambiamento.
Hai un progetto di integrazione Dolibarr ↔ e-commerce? Contattaci a contact@nextgestion.com per un audit gratuito. Sapremo proporti la soluzione più adatta al tuo volume, ai tuoi vincoli di business e al tuo budget.
FAQ: Collegare Dolibarr a WooCommerce / PrestaShop
Quanto costa un connettore Dolibarr e-commerce? Da 99 € per un modulo Dolistore standard, a diverse migliaia di euro per uno sviluppo su misura. Il ROI viene generalmente raggiunto in pochi mesi grazie ai guadagni di produttività.
Bisogna scegliere una sincronizzazione in tempo reale o per lotti? Ibrida. Tempo reale per gli eventi critici (ordini, scorte), sincronizzazione periodica di riconciliazione ogni 15 min per recuperare eventuali fallimenti.
È possibile collegare più negozi a un unico Dolibarr? Sì, tramite il modulo MultiShop o un middleware che aggrega i flussi. Ogni negozio può essere identificato per la tracciabilità e le analisi per canale.
Qual è l'impatto sulle prestazioni di Dolibarr? Con una buona architettura (coda di lavoro, cache, indicizzazione), nessun impatto percepibile fino a diverse migliaia di ordini al giorno.
Come gestire la transizione da un connettore esistente? Mantenere entrambi in parallelo per qualche settimana in modalità sola lettura per validare le divergenze, poi commutare il senso di scrittura progressivamente. Una riconciliazione iniziale per riferimento prodotto è indispensabile.
Quanto dura un progetto di integrazione? Per un connettore chiavi in mano con configurazione: 2-4 settimane. Per uno sviluppo su misura completo: 2-6 mesi a seconda della complessità.
Articolo redatto da NEXT GESTION, esperto in integrazione Dolibarr ↔ e-commerce. Per un audit o un accompagnamento, contattaci a contact@nextgestion.com.