Doli2Shop - ERP Integration

Modulo professionale di sincronizzazione tra il vostro negozio Shopify e il vostro ERP Dolibarr.

Funzionalita

• Webhook in tempo reale: ordini, prodotti, stock, spedizioni sincronizzati istantaneamente
• Esportazione automatica di prodotti, varianti, immagini e stock da Dolibarr a Shopify
• Importazione di prodotti da Shopify a Dolibarr
• Importazione automatica di ordini con clienti, indirizzi e sconti da Shopify
• Creazione automatica di fatture e pagamenti dagli ordini Shopify
• CRON di recupero: nessun ordine perso anche se un webhook fallisce
• Assistente di configurazione in 6 passaggi per un'installazione rapida
• Gestione multi-prezzo e varianti Shopify
• Interfaccia di amministrazione completa con log, diagnostica e visualizzatore webhook
• Compatibile con Dolibarr 18 a 23, Docker, Cloudron

Licenza e attivazione

Acquistando sul DoliStore, riceverete un numero di serie via email entro 24 ore lavorative per attivare il vostro modulo. Inseritelo in Doli2Shop > Licenza nel vostro Dolibarr.

Doli2Shop e disponibile anche sul Shopify App Store (https://apps.shopify.com/doli2shop) con attivazione automatica e istantanea della licenza tramite Shopify Billing, senza attendere alcuna email.

Novita nella v2.5.2

• Correzione critica: su alcune installazioni la connessione a Shopify doveva essere rifatta a mano ogni giorno. Il negozio predefinito conservava due copie delle proprie credenziali e il rinnovo automatico ne aggiornava una sola; poiche il token Shopify e valido una volta sola, la copia dimenticata scadeva. Ora entrambe le copie sono tenute aggiornate insieme
• Correzione: l'etichetta di ogni variante veniva sostituita dal titolo del prodotto padre a ogni aggiornamento proveniente da Shopify, compreso un semplice cambio di prezzo o di giacenza. Le etichette vengono ora ricalcolate come alla creazione, e lo strumento di riparazione le ritrova anche quando sono gia state collegate una prima volta
• Correzione: nella schermata dei webhook, il pulsante di salvataggio non aveva alcun effetto — l'elenco degli eventi seguiti non poteva essere modificato. Un difetto di struttura della pagina impediva l'invio del modulo
• Correzione: la schermata di sincronizzazione dei prodotti e l'attivita pianificata non guardavano lo stesso perimetro. Un prodotto collocato in una sottocategoria veniva sincronizzato senza mai comparire a schermo, che annunciava "nessun prodotto". Le due condividono ora la stessa definizione, e una nuova data di messa in servizio permette di escludere gli ordini precedenti al vostro passaggio a Shopify
• Correzione: sulle installazioni con piu negozi, i contatori della schermata di sincronizzazione contavano ogni prodotto tante volte quanti erano i negozi che lo contenevano. I totali mostrati caleranno quindi: ora sono corretti
• Correzione: l'importazione degli ordini storici non indicava mai a che punto fosse — "completato" restava sempre no, le statistiche restavano vuote, e cambiare la data di inizio in corsa non aveva effetto. L'importazione rende ora conto del proprio avanzamento, e non puo piu dichiararsi completata quando e fallita

Novita nella v2.5.0

• Flussi direzionali configurabili: per ogni tipo di dato (prodotti, giacenze, prezzi, ordini, pagamenti, spedizioni) scegliete il senso di sincronizzazione — da Dolibarr a Shopify, da Shopify a Dolibarr, o entrambi. La giacenza in particolare e bidirezionale per impostazione predefinita: impostatela esplicitamente se gestite il catalogo da Dolibarr
• API di pilotaggio: le principali operazioni del modulo sono accessibili via API, per automatizzare dai vostri strumenti
• Internazionalizzazione: il modulo e disponibile in francese, inglese, tedesco, spagnolo e italiano
• Immagini: trasferimento piu affidabile dei visual di prodotto verso Shopify, con deduplicazione delle immagini identiche

Novita nella v2.4.6 (cumulativa, copre dalla 2.4.3 alla 2.4.6)

• Correzione critica: sulle installazioni con sicurezza rafforzata (token anti-CSRF rinnovato a ogni pagina), tutte le azioni di amministrazione del modulo venivano rifiutate in silenzio — procedura guidata di configurazione compresa. Un clic su "Salva" non produceva ne effetto ne messaggio. La verifica e ora allineata al cuore di Dolibarr e ogni rifiuto viene segnalato a schermo
• Correzione: con piu negozi collegati, la pagina Webhook mostrava il negozio selezionato ma salvava su un altro — impossibile disattivare un webhook. I messaggi di errore di quella pagina, finora vuoti, vengono ora mostrati per esteso
• Correzione critica: su Dolibarr da 18 a 22, il collegamento di un negozio restituiva un errore 500 al ritorno da Shopify e il negozio andava perso. Sugli hosting in modalita SQL rigorosa i webhook non venivano mai registrati (date Shopify rifiutate dal database)
• Prestazioni: l'invio delle giacenze a Shopify diventa asincrono — la convalida di una fattura risponde subito, anche se Shopify e lento o irraggiungibile. Un'attivita pianificata invia le giacenze ogni 5 minuti, raggruppando i movimenti e riprovando automaticamente dopo un errore
• Vere varianti Dolibarr all'importazione: i prodotti con varianti importati da Shopify creano ora una vera variante Dolibarr (visibile nell'interfaccia), con un'etichetta diversa da quella del prodotto padre. Nuovo pulsante "Ripara varianti" per collegare a posteriori i cataloghi gia importati, senza reimportare ne duplicare
• Nuovo strumento "Correzione sconti": ripara gli ordini importati prima della 2.2.9 il cui sconto percentuale risultava sottostimato — anteprima prima dell'applicazione, solo bozze, traccia di audit preservata
• Importazione piu robusta: messaggio di errore completo quando una variante non puo essere creata, riutilizzo del prodotto esistente quando il riferimento (SKU) esiste gia, e righe d'ordine provenienti da app di pacchetti/bundle finalmente importate quando sono fatturabili

Novita nella v2.4.2

• Correzione critica: lo stock di Dolibarr non veniva mai inviato a Shopify (riassortimenti, produzione interna, correzioni manuali) — lo stock Shopify derivava a ogni vendita, fino a valori negativi errati. Ogni movimento di stock Dolibarr e ora sincronizzato in tempo reale verso Shopify (valore assoluto, mai negativo)
• Nuovo pulsante "Riallinea lo stock verso Shopify": invia in una volta lo stock Dolibarr di tutti i prodotti mappati — ripara immediatamente i valori Shopify falsati in passato
• Multi-negozio: lo stock viene inviato a ogni negozio in cui il prodotto e mappato, con le credenziali proprie di ciascun negozio
• Osservabilita: ogni invio di stock e tracciato nel registro delle azioni, e lo stato "ultimo riallineamento" (data, prodotti, errori) e visualizzato nell'amministrazione

Novita nella v2.4.1

• Conformita Shopify 2026: gestione nativa dei token OAuth scadenti (token di accesso di 60 minuti + token di aggiornamento), richiesti da Shopify entro il 1 gennaio 2027. Rinnovo automatico trasparente; i negozi gia connessi migrano con un clic tramite il pulsante "Riconnetti"
• Nuova API Collections di Shopify 2026-07: le collezioni create con il nuovo modello (rollout Shopify dal 1 luglio 2026) sono ora visibili e sincronizzate, nessuna sparizione silenziosa
• Correzione critica: sincronizzazione prodotti/stock resa piu affidabile — una variante disattivata a volte restava visibile su Shopify, e le divergenze di stock (a volte negative) non venivano piu corrette silenziosamente; gli errori sono ora registrati e mostrati
• Diagnostica istantanea: i test di connessione e stato per negozio vengono ora eseguiti in background, senza rallentare la pagina
• Telemetria piu affidabile: il modulo ora comunica il proprio dominio reale e la versione Dolibarr su tutti i canali, eliminando le false installazioni in sospeso

Novita nella v2.4.0

• Multi-negozio: collega piu negozi Shopify a un'unica installazione Dolibarr, con contabilita unificata. Selettore negozio e barra di contesto per passare da un negozio all'altro, configurazione completa per negozio (impostazioni, ordini, prodotti, spedizione, tag rinominati automaticamente in base al nome del negozio)
• Licenza per negozio: attiva il tuo numero di serie DoliStore direttamente dalla scheda di ogni negozio secondario
• Diagnostica Salute per negozio: connessione, webhook, licenza e dati locali verificati a colpo d'occhio per ciascun negozio
• Sincronizzazione delle spedizioni piu affidabile: recupero automatico rafforzato, nessuna spedizione orfana dopo un errore temporaneo
• Correzioni di visualizzazione (caratteri accentati) e aggiornamento della pagina Chi siamo
• Le installazioni a negozio singolo restano invariate: nessuna riconfigurazione necessaria all'aggiornamento

Novita nella v2.3.1 (hotfix)

• Correzione: pagina bianca all'attivazione del modulo su installazioni multi-negozio (la classe Categorie non veniva caricata prima di usare le sue costanti). L'attivazione e la creazione delle categorie per negozio funzionano di nuovo. Le installazioni a negozio singolo non erano interessate

Novita nella v2.3.0

• Multi-negozio: gestisci piu negozi Shopify da una sola installazione Dolibarr con contabilita unificata. Connessione e configurazione per negozio, isolamento di prodotti, ordini e fatture tramite categorie ed etichette, verifica della licenza per negozio. Le installazioni a negozio singolo funzionano come prima
• Sicurezza rafforzata della connessione Shopify: il ritorno OAuth e ora firmato con una firma crittografica asimmetrica (chiave pubblica/privata), eliminando ogni segreto condiviso lato modulo; rotazione trasparente lato server
• Strumenti di supporto: esportazione del JSON grezzo di un ordine o prodotto Shopify con un clic, ed esportazione ZIP di piu ordini insieme, da inviare al supporto senza manipolazioni tecniche
• Scheda ordine: indirizzi di spedizione e fatturazione, e punto di ritiro, mostrati direttamente senza aprire la scheda Contatti
• Wizard di verifica post-installazione: controllo a colpo d'occhio di connessione, configurazione, CRON, webhook e migrazioni, con azioni correttive
• Chiusura automatica degli ordini dopo consegna e pagamento, avvisi email su errori critici, registro delle azioni del modulo
• Dati ordine arricchiti (riepilogo finanziario, stati, contesto); compatibilita SQL con MySQL 8.x e MariaDB validata in integrazione continua

Novita nella v2.2.9 (hotfix)

• Correzione: sconti percentuali sottovalutati — lo sconto veniva calcolato sulla base imponibile e poi diviso una seconda volta per (1 + IVA) come un importo IVA inclusa. Gli ordini con codice promozionale percentuale ritrovano l'importo esatto mostrato da Shopify (es. 5% = -151,20 EUR IVA inclusa, non -126 EUR)
• Gli sconti a importo fisso (inviati IVA inclusa da Shopify) conservano la loro conversione
• Documentazione: tabella delle 4 regole di decremento dello stock di Dolibarr e raccomandazione per i negozi misti banco TakePOS + Shopify

Novita nella v2.2.8 (hotfix)

• Correzione critica: lo stock non veniva decrementato durante l'importazione degli ordini Shopify — il magazzino non veniva trasmesso alla convalida della fattura. Le 4 regole di decremento dello stock di Dolibarr (ordine, fattura, spedizione, chiusura spedizione) sono ora coperte
• Correzione: la migrazione dei permessi v2.2.4 (cambio di ID del modulo) viene ora eseguita automaticamente all'attivazione — diritti degli utenti preservati durante l'aggiornamento da una versione precedente alla 2.2.4
• Correzione webhook: URL di callback errato (percorso /custom/ mancante) in assenza di configurazione esplicita, e il parametro dei giorni di conservazione degli eventi e ora rispettato dalla pulizia
• Robustezza: avvisi espliciti nei log quando nessun magazzino puo essere risolto, e protezioni contro errori fatali

Novita nella v2.2.7 (hotfix)

• Correzione critica: chiamate all'API documenti con errore 404 sulle installazioni Dolibarr in sottodirectory — uno slash iniziale sovrascriveva la sottocartella (issue #288). Tutti gli endpoint documenti (immagini prodotti e categorie) rispettano ora la sottocartella di installazione

Novita nella v2.2.6 (hotfix)

• Correzione critica: sincronizzazione immagini prodotto resiliente — fallback SQL automatico (llx_ecm_files) quando l'endpoint REST Dolibarr /documents non e raggiungibile (Apache 404, timeout, HTML nel body). Nessuna immagine mancante in Shopify anche su hosting restrittivi (issue #286, ticket supporto Philazerty / Click & Play)
• Correzione critica: filtro entity multi-tenant aggiunto alla query SQL delle immagini — evita di esporre immagini di altre entita Dolibarr in installazioni multi-azienda
• Correzione: chiave di ordinamento errata (filename vs relativename) — ordinamento per posizione ora funzionante
• Miglioramento: cache di istanza delle immagini riduce da 3 a 1 le chiamate SQL+API ridondanti per prodotto durante la sincronizzazione

Novita nella v2.2.5 (hotfix)

• Correzione critica: funzione verifToken() non caricata su alcuni stack PHP-FPM (in particolare ISPConfig con open_basedir rigoroso) che bloccava l'OAuth Shopify — 4 file del modulo ora includono esplicitamente il polyfill compatibility.lib.php

Novita nella v2.2.4 (patch)

• Correzione critica: migrazione dell'ID del modulo Dolibarr (436950 → 351003, gamma ufficiale assegnata all'Association P'tite Tete) — migrazione SQL automatica preserva i permessi degli utenti esistenti, nessuna azione manuale richiesta

Novita nella v2.2.3 (hotfix)

• Correzione critica: 3 pagine di amministrazione (setup, wizard di configurazione, sincronizzazione prodotti) referenziavano un file CSS inesistente — caricamento dello stile e visualizzazione ora corretti

Novita nella v2.2.2

• Correzione critica: sincronizzazione stock varianti ogni ora invece di 24h
• Correzione critica: niente piu duplicati creati su Shopify dopo purga di un prodotto con varianti
• Anti-loop migliorato: protezione inter-processo sync/webhook contro deadlock
• Diagnostica migliorata: rilevamento vecchi percorsi immagini + test loopback server
• Versioni dinamiche ovunque (niente piu versioni fisse nell'interfaccia)
• Pagina guida configurazione modernizzata con assistente consigliato
• Correzione webhook products/delete (errore SQL corretto)
• Fallback intelligente version.php per deploy FTP parziali
• Correzione pagine admin (maintenance, version_check) per installazioni non standard

Video tutorial

Tutorial completo di installazione e aggiornamento:
https://youtu.be/NaTBQp4_aq8

5 lingue

Francais, English, Deutsch, Espanol, Italiano

Informazioni

Sito web: https://doli2shop.ptitetete.org
Email: doli2shop@ptitetete.org
Documentazione completa inclusa nel modulo