Una piccola introduzione Cos'è un'integrazione e-commerce gestionale e perché serve davvero
Un'integrazione e-commerce gestionale è un middleware (livello software intermedio) che mette in comunicazione il tuo negozio online (WooCommerce, PrestaShop, Magento) con il gestionale aziendale (Mexal, Zucchetti Ad Hoc, SAP Business One, Esolver, Buffetti) per sincronizzare in modo bidirezionale e in tempo reale catalogo prodotti, giacenze di magazzino, ordini, anagrafica clienti e fatturazione elettronica SDI.
Senza integrazione: il team commerciale esporta gli ordini dal sito in CSV, li importa a mano nel gestionale, controlla lo stock una volta al giorno, aggiorna i prezzi separatamente sul sito e nel gestionale, registra clienti due volte, emette fatture in un terzo software. Risultato: stock disallineato, prezzi diversi tra sito e gestionale, clienti duplicati, ore di lavoro manuale.
Da Vicenza dal 2008 con oltre 60 integrazioni gestionali realizzate: lavoriamo con i principali ERP italiani (Passepartout, Zucchetti, SAP B1, TeamSystem, Esolver, Buffetti) e con e-commerce su WooCommerce, PrestaShop e Magento. Middleware costruito su Node.js o PHP a seconda del caso, niente piattaforme SaaS terze.
Esempi tipici Tre esempi di intervento, in settori diversi
Esempio · settore distribuzione B2B Sito di un distributore industriale (settore meccanica)
Integrazione WooCommerce con SAP Business One via Service Layer. Sync bidirezionale di 8.000 prodotti, oltre 200 dealer registrati, ordini in tempo reale. Coda Redis per sync ad alto volume nei giorni di promozione. Stock mai disallineato in 18 mesi.
8000 prodotti sincronizzati
Esempio · settore alimentare B2C Sito di un produttore di alimentari (settore food specialty)
Integrazione WooCommerce con Mexal di Passepartout. Sync prodotti, stock, ordini, clienti, fatturazione elettronica SDI dal gestionale. Log centralizzato con alert email per errori. Manutenzione attiva da oltre 24 mesi senza incidenti rilevanti.
24+ mesi senza incidenti
Esempio · settore retail multi-brand Sito di un gruppo retail con più marchi (settore moda)
Integrazione PrestaShop multistore con Zucchetti Ad Hoc Enterprise. 5 brand sincronizzati con un solo gestionale, anagrafica clienti unificata cross-shop, fatturazione SDI gestita dal gestionale per tutti i brand.
5 brand 1 gestionale unico
Cosa includiamo Cosa contiene il middleware di integrazione
4 flussi bidirezionali, log centralizzato, recovery automatico.
Catalogo + stock
Prodotti e giacenze sempre allineati.
Il middleware legge il catalogo dal gestionale (codice, descrizione, prezzo, attributi, immagini se presenti) e lo replica sul sito alla creazione o aggiornamento. Lo stock viene letto in tempo reale dal magazzino e mostrato sul sito (disponibile, esaurito, in arrivo). Per cataloghi grandi (10.000+ prodotti) si usa coda di sync con priorità.
- Sync catalogo dal gestionale al sito
- Stock in tempo reale dal magazzino
- Multi-magazzino se attivo
- Coda di sync per cataloghi grandi
- Notifica admin se prodotto scompare
- Mapping attributi gestionale → sito
Ordini bidirezionali
Dal sito al gestionale e ritorno.
Quando arriva un ordine sul sito, il middleware lo crea automaticamente nel gestionale come ordine cliente con riga prodotti, IVA corretta, indirizzi, condizioni di pagamento. Quando l'ordine viene spedito (cambio stato nel gestionale), lo stato torna al sito: 'spedito' con tracking se presente.
- Ordine sito al gestionale automatico
- Stato gestionale al sito (spedito, fatturato)
- Tracking corriere quando disponibile
- Note ordine sincronizzate
- Annullamenti gestiti in entrambi i versi
- Email cliente automatiche al cambio stato
Clienti unici
Anagrafica condivisa, niente duplicati.
Quando un nuovo cliente si registra sul sito, il middleware verifica se esiste già nel gestionale (per partita IVA o codice fiscale) e se sì lo collega; altrimenti crea l'anagrafica. I dati di fatturazione vengono presi sempre dal gestionale, garantendo coerenza. Per i portali B2B, gruppo cliente e listino vengono dal gestionale al sito.
- Verifica esistenza cliente da P.IVA / CF
- Creazione anagrafica nel gestionale
- Dati fatturazione dal gestionale
- Listino e gruppo cliente B2B
- Multi-indirizzo (consegna, fatturazione)
- Conformità GDPR su dati personali
Fatturazione elettronica SDI
La fattura nasce nel gestionale, non nel sito.
La fattura elettronica viene emessa dal gestionale (che è il sistema di certificazione fiscale) e il middleware riporta sul sito lo stato di emissione e il link al PDF, se disponibile. Niente plugin di fatturazione che parallelizzano con il gestionale, sarebbe un disastro fiscale: il gestionale resta unico master della fatturazione.
- Fattura emessa dal gestionale
- Trasmissione SDI dal gestionale
- Stato fattura riportato sul sito
- Note di credito gestite nello stesso modo
- Conformità Agenzia delle Entrate
- Backup XML fatture per archiviazione
Il problema Errori tipici nelle integrazioni gestionali
Pattern che vediamo prendendo in carico integrazioni fatte da altri:
- Sync solo notturno: lo stock è disallineato per tutto il giorno, vendi prodotti che in realtà non hai
- Sync solo in un verso (sito al gestionale): il cambio di stato dell'ordine non torna mai, il cliente non sa quando il pacco parte
- Plugin SaaS terzi tipo automazioni cloud o Integromat per logiche complesse: si bloccano al primo errore, niente recovery, costi mensili che esplodono
- Plugin di fatturazione lato sito in parallelo al gestionale: numerazione doppia, errori SDI, problemi con l'Agenzia delle Entrate
- Anagrafica clienti duplicata: lo stesso cliente esiste sul sito e nel gestionale con dati diversi
- Niente log e niente alert: quando qualcosa si rompe, nessuno se ne accorge per giorni
- Niente recovery automatico: se la rete cade durante una sync, l'ordine resta in limbo
Il nostro approccio: middleware costruito su misura, sync bidirezionale in tempo reale, log centralizzato con alert, recovery automatico, fatturazione gestita solo dal gestionale.
I vantaggi Cosa ti porta un'integrazione fatta bene
Quello che ti porti a casa
Risultati concreti per imprenditore, magazziniere e team commerciale:
- Stock sempre allineato: niente vendite di prodotti che non hai
- Niente import Excel a mano: ore di lavoro manuale risparmiate ogni settimana
- Anagrafica clienti unica: niente duplicati, dati sempre coerenti
- Fatturazione SDI dal gestionale: niente errori fiscali
- Stato ordine al cliente automatico: meno chiamate al customer care
- Log centralizzato + alert: se qualcosa si rompe, lo sai subito
- Scalabilità: l'integrazione regge il prossimo Black Friday
Come lavoriamo Le 4 fasi del progetto integrazione
1. Discovery API
Settimana 1-2.
- Analisi gestionale e API disponibili
- Mappa dei dati da sincronizzare
- Definizione frequenza sync per flusso
- Spec tecnica con il fornitore gestionale
2. Middleware build
Settimana 3-6.
- Setup middleware Node.js / PHP
- Connettori sito (WooCommerce, PrestaShop)
- Connettori gestionale (Mexal, Zucchetti, SAP)
- Mapping campi e gestione errori
3. Sync bidirezionali
Settimana 6-9.
- Catalogo + stock al sito
- Ordini al gestionale
- Stato ordine al sito
- Anagrafica clienti unica
4. Test + go-live
Settimana 9-12.
- Test multi-scenario (ordine, reso, fattura)
- Stress test sync per cataloghi grandi
- Setup log + alert + recovery
- Go-live + monitoraggio 30 giorni
Strumenti Stack che usiamo nelle integrazioni
Best-in-class per ogni layer, niente piattaforme SaaS terze:
- Node.js o PHP per il middleware (a seconda del caso)
- API WooCommerce REST per il sito WordPress
- Webservice PrestaShop per shop PrestaShop
- Mexal API di Passepartout
- Zucchetti Ad Hoc API Revolution ed Enterprise
- SAP B1 Service Layer per SAP Business One
- Coda Redis per sync di volume
- Log centralizzato con alert email/Slack
Tecnologie Stack tecnico delle integrazioni
WooCommerce
WordPress
PrestaShop
PHP
MySQL
Redis
WooCommerce
WordPress
PrestaShop
PHP
MySQL
Redis Risultati Cosa garantiamo a fine progetto
Quello che ti consegniamo a go-live:
- Middleware bidirezionale in tempo reale
- Sync catalogo + stock + ordini + clienti
- Fatturazione SDI dal gestionale
- Log centralizzato + alert
- Recovery automatico in caso di errore
- Documentazione tecnica per il team interno
- Manutenzione opzionale per evoluzioni e nuovi flussi
Quanto costa un'integrazione gestionale? +
Servizio su misura: il preventivo dipende dalla complessità dei requisiti, dalle integrazioni con sistemi terzi (CRM, gestionale, API esterne), dal volume di test richiesto e dal livello di SLA in manutenzione. Prima cosa che facciamo è una discovery call gratuita di 30-45 minuti per capire scope e contesto, poi mandiamo un preventivo scritto entro 48-72 ore. Niente listini standard.
Posso usare automazioni cloud, Make o Integromat al posto di un middleware custom? +
Funziona per casi semplici (poche righe al giorno, niente logica condizionale). Per volumi seri (centinaia di ordini al giorno, multi-magazzino, gestione errori) le piattaforme SaaS si bloccano al primo errore e i costi mensili crescono in modo non lineare. Un middleware custom è più affidabile e ha costo fisso una tantum + manutenzione.
Quanto tempo per andare in produzione? +
Per integrazioni leggere su gestionali con API REST documentate (Mexal, SAP B1 Service Layer): 8-10 settimane. Per gestionali con API legacy o flussi complessi (multi-magazzino, multi-azienda): 12-16 settimane. Roadmap dettagliata nella proposta dopo la discovery API.
Quali gestionali integrate davvero? +
Mexal di Passepartout, Zucchetti Ad Hoc Revolution ed Enterprise, SAP Business One via Service Layer, Esolver, Buffetti, TeamSystem (Sphera, Lynfa). Per gestionali custom o di nicchia, valutiamo le API in fase di discovery prima di accettare il progetto.
La fattura elettronica SDI viene generata dal sito o dal gestionale? +
Sempre dal gestionale, che è il sistema certificato per la fatturazione fiscale. Il middleware riporta sul sito lo stato di emissione e il link al PDF se disponibile. Mai plugin di fatturazione lato WordPress in parallelo al gestionale: causa numerazione doppia ed errori SDI.
Cosa succede se la rete cade durante una sync? +
Il middleware ha una coda con retry automatico: l'operazione fallita viene rimessa in coda e ritentata fino a successo. Se persiste l'errore, viene generato un alert email/Slack al team tecnico. Niente ordini persi, niente sync silenziose.
Posso aggiungere flussi nuovi dopo il go-live? +
Sì, è il caso comune. Le integrazioni evolvono: aggiunta di nuovi gruppi cliente B2B, nuovo magazzino, nuovo paese di vendita, sync fornitori. Manutenzione opzionale per estensioni progressive del middleware.
Cosa NON fate? +
Niente integrazioni con piattaforme SaaS al posto del middleware custom per volumi seri. Niente fatturazione lato sito in parallelo al gestionale. Niente sync solo notturno per shop dove lo stock cambia di ora in ora. Niente integrazione con gestionali senza API o con accesso solo a database diretto (rischio fiscale).