Doli2Shop - Integrazione ERP

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 24, 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 v2.5.5

• Il modulo tiene ora un proprio registro, separato dal registro generale di Dolibarr, con un pulsante "Scarica il registro del modulo" nella scheda Assistenza. In caso di problemi lo allegate al vostro messaggio, e la diagnosi parte dai fatti anziche da una serie di domande. Rotazione, archiviazione e pulizia sono gestite da Dolibarr stesso : nessuna impostazione aggiuntiva da conoscere
• Correzione con impatto contabile : uno sconto globale ripartito sulle righe non veniva mai applicato su due percorsi di importazione — l'importazione storica e il recupero di un singolo ordine, cioe il percorso usato dopo la notifica di un nuovo ordine. Un'informazione necessaria alla decisione non veniva richiesta a Shopify, quindi la condizione era sempre falsa : l'ordine veniva registrato a prezzo pieno, senza errori ne avvisi
• Un prodotto lasciato senza immagini su Shopify viene ora contato e nominato, a schermo e nel rapporto dell'attivita pianificata. Il modulo rinuncia all'invio quando non trova alcuna immagine lato Dolibarr, per non rimuovere le vostre immagini senza sostituirle — finora lo diceva solo in una riga tecnica che nessuno leggeva

• Correzione: la giacenza di una variante senza corrispondenza di SKU non veniva mai inviata a Shopify, e nulla lo segnalava. La variante restava indefinitamente alla quantita che aveva nel momento in cui e comparso lo scarto — vendibile pur essendo esaurita, o non vendibile pur essendo disponibile — mentre il rapporto annunciava una sincronizzazione riuscita
• Le varianti Dolibarr senza corrispondente Shopify, e le varianti Shopify senza corrispondente Dolibarr, sono ora contate, elencate per prodotto e segnalate come non sincronizzate, sia nel rapporto di sincronizzazione sia nella schermata di diagnostica
• Correzione: un prodotto le cui foto erano sparite dal lato Shopify (prodotto eliminato e ricreato, media rimossi a mano, ripristino di un backup) non le recuperava mai. Il modulo si affidava a un'impronta delle immagini di Dolibarr per concludere che Shopify le possedeva gia, e nessuna pulizia cancellava quell'impronta: la procedura corretta, applicata correttamente, non poteva funzionare
• Le pulizie cancellano ora anche la memoria delle immagini, un invio saltato viene segnalato nel rapporto di sincronizzazione, ed e disponibile nella configurazione un'azione "forzare il reinvio completo delle immagini" di un prodotto — senza query SQL ne pulizia globale
• Accessibilita: 52 testi mostrati nei nostri colori di marca non raggiungevano il contrasto richiesto dalle regole WCAG AA. Corretti nelle nostre e-mail, nelle schermate del sito e nei fogli di stile del modulo, con varianti scurite a tinta invariata

Novita v2.5.4

• Importante: dal 12 novembre 2026, una licenza scaduta arresta la sincronizzazione del modulo — in entrambe le direzioni, compresa l'importazione dei vostri ordini Shopify verso Dolibarr. Una licenza attiva e interessata solo alla sua scadenza. Siete avvisati nel modulo per tutto il periodo precedente, con la data esatta. Essendo questo meccanismo incorporato nel modulo, si applica solo alle installazioni aggiornate: una versione precedente continua a funzionare
• La data di arresto proviene dai nostri server e non dalla vostra installazione, ed e firmata: una data modificata localmente viene ignorata. Se i nostri server non rispondono, nulla si ferma — un guasto dalla nostra parte non deve mai tagliare fuori un cliente in regola
• Correzione: "La vostra licenza e scaduta" non compare piu quando e il nostro server a non aver risposto. Il messaggio era falso e colpiva clienti in regola con i pagamenti, per una semplice interruzione di rete. Una licenza mai attivata non viene piu annunciata come scaduta
• Le email di scadenza licenza partono finalmente: 30 giorni prima, 7 giorni prima, poi il giorno della scadenza. Erano previste ma non erano mai state scritte
• Il link di rinnovo porta ora nel posto giusto secondo il canale d'acquisto: un cliente DoliStore non viene piu inviato a Shopify
• L'avviso di licenza compare su tutte le schermate di amministrazione del modulo, invece che su due
• Lo stock va da Dolibarr a Shopify per impostazione predefinita. Riguarda solo le installazioni che non hanno mai scelto un verso esplicito; un'impostazione esistente viene mantenuta
• Nuova schermata di controllo: sui negozi impostati a prezzi al netto delle imposte, indica quali ordini sono stati registrati sotto il loro valore reale, con l'importo in gioco. Constata e non modifica nulla — una fattura convalidata si regolarizza con una nota di credito, che resta una vostra decisione

Novita nella v2.5.3 (cumulativa, copre dalla 2.5.0 alla 2.5.3)

• Correzione critica, contabile: su un negozio Shopify impostato con prezzi IVA esclusa (l'imposta viene aggiunta al pagamento), ogni ordine importato risultava sottovalutato di circa il 17% — righe, sconti, spese di spedizione e fattura comprese. Il modulo divideva il prezzo per l'aliquota IVA presupponendo che fosse sempre IVA inclusa, senza mai leggere l'impostazione reale del negozio. Lo scarto non era visibile da Dolibarr: il pagamento veniva registrato per l'importo gia errato, quindi la fattura appariva saldata. Se l'impostazione non puo essere determinata, l'ordine non viene piu importato e il rifiuto viene mostrato a schermo con il suo motivo
• Correzione, impatto contabile: l'impostazione "non importare gli ordini non pagati" era rispettata solo da due dei tre percorsi di importazione. I webhook la ignoravano: un ordine in attesa di pagamento veniva importato E fatturato. Ogni ordine scartato e ora visibile a schermo con il suo motivo, ed entra normalmente se viene pagato in seguito
• Novita: gli scarti di importo tra Shopify e Dolibarr sono ora mostrati nella diagnostica, con il numero di ordini interessati. Il modulo distingue lo scarto di arrotondamento di pochi centesimi dallo scarto proporzionale, che segnala un errore di calcolo sistematico
• Correzione Multicompany: le foto importate da Shopify vengono finalmente registrate nell'indice dei file di Dolibarr nel momento in cui vengono salvate. In caso contrario Dolibarr le indicizzava da solo in seguito, senza protezione dagli accessi simultanei — da cui errori ripetuti "record gia esistente" sulle schede prodotto e ordine
• Correzione: un'installazione con la tabella dei negozi incompleta non riusciva piu a uscirne. La connessione di un negozio falliva per una colonna mancante, e la diagnostica consigliava una riattivazione che non riparava nulla. La riparazione e ora automatica all'attivazione, senza mai svuotare ne ricreare una tabella
• Correzione multi-negozio: la disconnessione di un negozio agiva sempre sul negozio predefinito, indipendentemente da quello visualizzato, ed eliminava i dati degli ordini dell'intera entita. Ora e limitata al negozio indicato nella conferma
• Esistevano dieci schermate di amministrazione senza alcun link che vi conducesse: corrispondenza degli stati ordine, ticket di supporto, corrispondenza delle collezioni, manutenzione. Ora sono accessibili. Due script obsoleti sono stati rimossi
• Correzione: la schermata delle corrispondenze di stato ordine si bloccava non appena aperta, i suoi quattro pulsanti di scrittura erano inoperanti, e il pulsante "Ripristina valori predefiniti" svuotava le tabelle senza reinserire nulla. I valori predefiniti sono ora completi, compresi gli ordini rimborsati, annullati o autorizzati senza cattura
• La schermata che imposta il verso delle sincronizzazioni e riparata e accessibile, e ora indica chiaramente quali versi sono realmente operativi
• Un amministratore non viene piu segnalato erroneamente come privo di diritti sulla schermata di diagnostica
• Versioni di Dolibarr supportate: dalla 18.0 alla 24.x. Tre versioni sono realmente testate a ogni pubblicazione — la 18.0, la penultima e l'ultima. Le versioni intermedie si installano e funzionano, senza test dedicati
• Correzione critica Multicompany: sulle installazioni in cui il modulo e configurato su un'entita diversa dalla prima, nessun webhook veniva accettato. Il punto di ingresso girava sempre nella prima entita e li non trovava il segreto di firma — ordini, prodotti e spedizioni non arrivavano piu, senza alcun messaggio di errore, e nulla veniva conservato per essere ripetuto
• Correzione, tutte le installazioni: le foto dei prodotti venivano duplicate a ogni notifica di Shopify — bastava un cambio di prezzo o di giacenza per depositare un'altra copia. Per i duplicati gia accumulati e disponibile una schermata di pulizia, con anteprima prima dell'eliminazione
• Correzione Multicompany: le foto dei prodotti non arrivavano mai a Shopify e la schermata di diagnostica annunciava "nessun prodotto con almeno una foto" mentre l'ERP le mostrava. L'IVA degli ordini importati veniva inoltre calcolata con la scheda azienda della prima entita. Le corrispondenze di pagamento predefinite non venivano mai create su un'entita secondaria
• Correzione critica: su alcune installazioni la connessione a Shopify andava rifatta manualmente ogni giorno. Il negozio predefinito conservava due copie delle proprie credenziali e il rinnovo automatico ne aggiornava una sola
• 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
• Correzione: la schermata di sincronizzazione e l'attivita pianificata non guardavano lo stesso perimetro — un prodotto collocato in una sottocategoria veniva sincronizzato senza mai comparire a schermo. Una data di messa in produzione consente ora di escludere gli ordini anteriori al passaggio a Shopify
• Flussi direzionali configurabili: per prodotti, giacenze, ordini e pagamenti scegliete il verso di ogni sincronizzazione — da Dolibarr a Shopify, il contrario, entrambi o nessuno
• Nuovo documento, in cinque lingue: la procedura di messa in produzione per collegare il modulo a un Dolibarr che contiene gia il vostro storico commerciale, con cio da cui non protegge

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

Associazione P'tite Tete - Moduli Dolibarr dal 2021