Changelog

Lo stock di Dolibarr torna a essere inviato a Shopify: gli aggiornamenti venivano rifiutati non appena un prodotto aveva già stock online («changeFromQuantity»). Il modulo legge ora la quantità effettivamente registrata presso Shopify, invia solo la differenza, raggruppa gli aggiornamenti in lotti, e un'interruzione temporanea di Shopify non manda più i prodotti in errore definitivo; i prodotti rimasti bloccati vengono rimessi in coda automaticamente

L'API REST del modulo rispondeva con un errore 500 dalla 2.6.0, anche con una chiave valida: corretto e verificato in HTTP reale su Dolibarr 18 e 24 dal pacchetto consegnato

Gli strumenti di manutenzione si aprono finalmente (la scheda andava in errore all'apertura), e la scheda «Mappatura degli stati», priva di qualsiasi effetto sui vostri ordini, viene rimossa — i vecchi collegamenti rimandano a «Configurazione degli ordini»

La scheda Webhook non va più in errore: deselezionare «Elaborazione immediata» o svuotare un campo numerico provocava un errore fatale, e scegliere la riga vuota in «Utente dei webhook» faceva rispondere tutti i vostri webhook con un errore 500

Salvare la categoria prodotto di un negozio non cancella più in silenzio i suoi tag ordine, fattura e preventivo. Da verificare: aprite la scheda di ciascun negozio, scheda «Categorie e tag», e controllate che i tre tag siano compilati

Una collezione manuale non viene più scambiata per una automatica: i suoi prodotti vengono di nuovo associati, e le collezioni gestite da condizioni sono segnalate a parte nella schermata di sincronizzazione

Correzione critica: su un negozio Shopify configurato con più sedi/magazzini, il ciclo di ri-sincronizzazione del solo stock (quando il contenuto del prodotto non è cambiato dall'ultimo invio) veniva sistematicamente rifiutato da Shopify. Un integratore ci ha segnalato 141 errori su 158 prodotti, con lo stock che restava mostrato su Shopify al suo vecchio valore senza che passasse alcun aggiornamento. La causa: la quantità di riferimento veniva confrontata con uno stock Shopify di tutte le sedi combinate, mentre Shopify la confronta in realtà con la sola sede configurata per il vostro negozio — invisibile su un negozio con una sola sede, il difetto compare non appena esiste una seconda sede. Viene ora sempre letta presso la sede effettivamente configurata per il vostro negozio. Dopo l'aggiornamento, rilanciate una sincronizzazione dello stock per i prodotti precedentemente in errore

Correzione: un prodotto con più varianti non vede più tutte le sue varianti bloccate dal problema di una sola — se una variante non può essere ri-sincronizzata in un dato ciclo, le altre varianti dello stesso prodotto, correttamente sincronizzate, non vengono più trattenute insieme ad essa

Correzione: un problema reale di configurazione della sede Shopify (sede eliminata, non valida, o disattivata — ad esempio un vecchio magazzino chiuso ma non eliminato) viene ora segnalato chiaramente nei log e nel riepilogo di sincronizzazione, con l'azione da intraprendere a seconda del caso. Un identificativo di sede configurato male viene inoltre ora rilevato immediatamente, senza attendere la chiamata a Shopify

Correzione: un rallentamento temporaneo imposto da Shopify (limitazione di frequenza, normale su un catalogo voluminoso) non viene mai confuso con questo problema di configurazione della sede — segue il percorso normale, con un nuovo tentativo al ciclo successivo

Correzione: un articolo correttamente definito con uno stock pari a zero non viene più confuso con un articolo la cui quantità non è stata leggibile — uno stock legittimamente nullo presso la sede configurata viene ora correttamente inviato a Shopify

Correzione: su un'installazione con più negozi Shopify, il tracciamento di sincronizzazione di un prodotto resta correttamente isolato per negozio, senza mescolanze tra negozi; i due contatori introdotti da questa versione sono inoltre ora visibili direttamente nella schermata di sincronizzazione manuale, come banner dedicati

Correzione critica, impatto contabile: dall'aggiornamento del 18 settembre 2026 (versione 2.5.5), un ordine Shopify con uno sconto globale (codice promozionale o sconto automatico su più articoli) poteva essere importato con uno sconto vicino al doppio di quello effettivamente concesso da Shopify. Su un ordine di 2.520,00 € IVA esclusa scontato del 5% (126,00 € IVA esclusa), l'importazione tratteneva 245,70 € IVA esclusa. L'importo dello sconto globale viene ora ripreso direttamente dalla ripartizione già calcolata da Shopify per ogni articolo, letta una sola volta: il doppio conteggio diventa strutturalmente impossibile

Correzione: uno sconto rivolto solo a una parte dei vostri articoli (ad esempio «-10% sugli articoli in saldo») poteva, in alcuni casi, essere calcolato sul valore di tutti gli articoli dell'ordine anziché sui soli articoli interessati, presente dallo stesso aggiornamento del 18 settembre

Correzione: con alcune app di sconto di terze parti o Shopify Functions che riportano già lo sconto globale nel prezzo mostrato da Shopify, la prima correzione di questa versione lo contava comunque una seconda volta. Il calcolo ora legge ogni ripartizione dello sconto una sola volta, indipendentemente da come Shopify mostra altrimenti il prezzo della riga

Correzione: gli ordini marketplace (Nature & Découvertes e canali simili), che non sempre indicano l'aliquota IVA su ogni articolo, potevano vedere il proprio sconto globale sovrastimato del 20%; il modulo ora ricorre all'aliquota IVA della vostra scheda prodotto Dolibarr per questo calcolo, come già fa per la riga stessa

Correzione: un ordine con IVA mista (5,5% e 20% sullo stesso ordine, ad esempio) ripartiva l'intero sconto globale sull'aliquota più alta; viene ora creata una riga di sconto per ogni aliquota IVA realmente interessata

Uno sconto annunciato da Shopify ma non trovato nel dettaglio degli articoli non scompare più silenziosamente: viene ora registrato per l'indagine

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, cioè 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 né avvisi

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 quantità che aveva nel momento in cui è comparso lo scarto — vendibile pur essendo esaurita, o non vendibile pur essendo disponibile — mentre il rapporto annunciava una sincronizzazione riuscita

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 già, e nessuna pulizia cancellava quell'impronta: la procedura corretta, applicata correttamente, non poteva funzionare

Correzione: veniva mostrato «La vostra licenza è scaduta» quando in realtà era il nostro server a non aver risposto. Un guasto dalla nostra parte non si presenta più come un problema dalla vostra

Correzione Multicompany: sulle installazioni in cui Doli2Shop è configurato su un'entità diversa dalla prima, nessun webhook veniva accettato. Il punto di ingresso girava sempre nella prima entità e lì non trovava il segreto di firma: ordini, prodotti e spedizioni non arrivavano più, senza alcun messaggio di errore, e nulla veniva conservato per essere ripetuto

Correzione Multicompany: le foto dei prodotti non arrivavano mai a Shopify. Dolibarr archivia i documenti in una sottocartella che porta il numero dell'entità, che il modulo non riconosceva — la schermata di diagnostica annunciava «nessun prodotto con almeno una foto» mentre l'ERP le mostrava

Correzione Multicompany: l'IVA degli ordini importati veniva calcolata con la scheda azienda della prima entità anziché con quella dell'azienda interessata

Correzione Multicompany: le corrispondenze di pagamento predefinite (carta, bonifico, assegno, PayPal…) non venivano mai create su un'entità secondaria. Ora vengono impostate per entità e non sovrascrivono mai una corrispondenza da voi modificata

Correzione, tutte le installazioni: per ogni prodotto e a ogni sincronizzazione veniva scritto un avviso secondo cui la foto non era indicizzata, anche quando lo era perfettamente — e ogni prodotto veniva letto due volte dal disco

Correzione, tutte le installazioni: le foto dei vostri prodotti venivano duplicate a ogni notifica di Shopify — bastava un cambio di prezzo o di giacenza per depositarne un'altra copia. Un cliente aveva quattro esemplari della stessa immagine su un solo prodotto, tre dei quali creati lo stesso giorno. Per i duplicati già accumulati è disponibile una schermata di pulizia: mostra ciò che verrà eliminato prima di agire e non tocca mai una foto caricata da voi

Correzione critica: su alcune installazioni, la connessione a Shopify doveva essere ristabilita manualmente ogni giorno. Il negozio predefinito conservava due copie delle proprie credenziali e il rinnovo automatico ne aggiornava soltanto una; poiché un token Shopify è monouso, la copia dimenticata scadeva. Ora entrambe le copie vengono mantenute allineate

Correzione: l'etichetta di ogni variante veniva sostituita dal titolo del prodotto principale a ogni aggiornamento proveniente da Shopify, anche per una semplice modifica di prezzo o di giacenza. Le etichette vengono ora ricalcolate come alla creazione, e lo strumento di riparazione le ritrova anche quando sono già state collegate una prima volta

Correzione: nella schermata dei webhook, il pulsante di salvataggio non aveva alcun effetto — l'elenco degli eventi monitorati non poteva essere modificato. Un difetto di struttura della pagina impediva l'invio del modulo

Correzione: la schermata di sincronizzazione dei prodotti e l'attività pianificata non consideravano lo stesso perimetro. Un prodotto collocato in una sottocategoria veniva sincronizzato senza mai comparire sulla schermata, che segnalava «nessun prodotto». Entrambe condividono ora la stessa definizione, e una nuova data di messa in servizio consente di escludere gli ordini precedenti al passaggio a Shopify

Correzione: sulle installazioni con più negozi, i contatori della schermata di sincronizzazione contavano ogni prodotto tante volte quanti erano i negozi in cui era presente. I totali visualizzati diminuiranno quindi: ora sono corretti

Correzione: l'importazione degli ordini storici non indicava mai il proprio stato — «completata» rimaneva sempre su no, le statistiche restavano vuote e modificare la data di inizio in corso d'opera non aveva effetto. L'importazione riporta ora il proprio avanzamento e non può più dichiararsi completata dopo un errore

Correzione critica: l'attività pianificata di recupero delle spedizioni non si avviava più affatto, senza lasciare la minima traccia in Dolibarr — soltanto il registro del server la conservava. Un controllo automatico impedisce ora il ripresentarsi di questo tipo di guasto silenzioso

Correzione: altre due attività pianificate fallivano per un motivo affine, tra cui il controllo dello stato dei webhook — che si guastava proprio nel momento in cui registrava un incidente, ossia quando serviva di più

Correzione: i prodotti con varianti generavano una trentina di avvisi a ogni sincronizzazione delle immagini

Correzione critica: consultare una pagina poteva rendere inutilizzabili i pulsanti di un'altra. Le chiamate interne del modulo rinnovavano il token di sicurezza della sessione, e la pagina Stato ne attiva uno per negozio all'apertura: su un'installazione con tre negozi, la semplice consultazione di quella pagina bastava a far respingere in silenzio i clic della pagina Webhook

Correzione: trenta azioni distribuite su nove pagine di amministrazione potevano essere respinte senza messaggio né traccia quando il token di sicurezza veniva rifiutato — tra cui il collegamento di un numero di licenza a un negozio, che poteva quindi fallire senza alcuna indicazione. Tutte mostrano ora un errore esplicito

Correzione: una sincronizzazione poteva spegnere i webhook degli altri negozi

Correzione: nella schermata dei webhook compariva «Configurazione salvata» senza che lo stato cambiasse. Visualizzazione e salvataggio non consultavano la stessa riga del database: si disattivava un webhook, la pagina confermava e nulla si muoveva

Correzione: la disattivazione rimuove ora ogni abbonamento interessato e non più soltanto il primo trovato — una riga gemella non può più far riapparire un webhook appena rimosso. L'attivazione riutilizza un abbonamento già presente invece di crearne un altro

Le incoerenze eredidate dalle installazioni precedenti al supporto multi-negozio vengono corrette lungo il percorso: una riga rimasta «attiva» senza abbonamento reale viene ripristinata

Correzione: con più negozi collegati, la pagina Webhook mostrava il negozio selezionato ma salvava su un altro — impossibile disattivare un webhook e il pulsante «Salva» sembrava non fare nulla. Visualizzazione e salvataggio condividono ora lo stesso filtro per negozio, e ogni errore viene mostrato per esteso invece di un messaggio vuoto

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. La verifica è ora allineata al cuore di Dolibarr e ogni rifiuto viene sempre segnalato a schermo

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 — il modulo usava una funzione del core introdotta solo a fine 2025

Correzione: sugli hosting in modalità SQL rigorosa i webhook non venivano mai registrati — le date inviate da Shopify erano rifiutate dal database. Ora vengono convertite e memorizzate in ora universale

Correzione: i prodotti con varianti importati da Shopify non creavano una vera variante Dolibarr — il collegamento prodotto/variante restava invisibile nell'interfaccia e l'etichetta della variante poteva restare identica a quella del prodotto padre

Correzione: l'importazione di prodotti con varianti falliva quando uno stesso riferimento (SKU) è condiviso tra più prodotti Shopify — il modulo ora riutilizza il prodotto esistente invece di fallire e mostra il motivo di errore completo in caso di altri problemi

Correzione: le righe d'ordine provenienti da app di pack/bundle ("componi il tuo pack") non venivano create in Dolibarr — i prodotti fatturabili raggruppati in un bundle ora vengono importati correttamente (i componenti gratuiti a 0 € restano ignorati)

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 è ora sincronizzato in tempo reale verso Shopify (valore assoluto, mai negativo)

Correzione critica: sincronizzazione prodotti/stock resa più affidabile — una variante disattivata a volte restava visibile su Shopify, e le divergenze di stock (a volte negative) non venivano più corrette silenziosamente; gli errori sono ora registrati e mostrati

Correzione critica: una spedizione rimasta in bozza dopo un errore (magazzino/stock) non veniva mai recuperata automaticamente — ora viene convalidata e chiusa dal processo di recupero periodico

Correzione di visualizzazione: caratteri accentati codificati in modo errato (doppia codifica) corretti in tutta l'interfaccia di amministrazione

Correzione: lo stato della licenza di un negozio poteva restare bloccato su "sconosciuto" — la verifica ora è affidabile e non declassa mai un negozio predefinito

Correzione critica: alcuni ordini non venivano più recuperati da Shopify (regressione introdotta nella 2.3.0) — la sincronizzazione degli ordini torna a funzionare normalmente

Correzione: i webhook registrati su una versione API Shopify obsoleta vengono ora ri-registrati automaticamente durante i controlli di stato, per ciascun negozio

Correzione: blocco all'attivazione del modulo sulle installazioni multi-negozio (pagina bianca)

Correzione: sconti percentuali sottovalutati — lo sconto veniva calcolato sulla base imponibile e poi diviso una seconda volta per (1 + IVA) come se fosse un importo IVA inclusa. Gli ordini con codice promozionale percentuale ritrovano l'importo esatto mostrato da Shopify (es. 5% = −151,20 € IVA inclusa, non −126 €)

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 — i diritti degli utenti sono 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 è ora rispettato dalla pulizia

Correzione critica: chiamate all'API documenti con errore 404 su installazioni in sottodirectory — uno slash iniziale sovrascriveva il percorso della sottodirectory (issue #288)

Tutti i punti di accesso ai documenti (immagini prodotti e categorie) rispettano ora correttamente la sottodirectory di installazione

Corregge le installazioni Dolibarr in sottodirectory (la versione 2.2.6 gestiva già il problema tramite il fallback SQL locale)

Correzione critica: sincronizzazione immagini prodotto resiliente — fallback SQL automatico (llx_ecm_files) quando l'endpoint REST Dolibarr /documents non è raggiungibile (404, timeout, HTML nel body). Le immagini del prodotto vengono ora correttamente sincronizzate in Shopify anche su hosting restrittivi (issue #286)

Correzione critica: filtro entity multi-tenant aggiunto alla query SQL delle immagini — evita di esporre immagini di altre entità Dolibarr in installazioni multi-azienda

Correzione: chiave di ordinamento errata (filename vs relativename) — ordinamento per posizione ora funzionante

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

Correzione critica: migrazione dell'ID del modulo Dolibarr (436950 → 351003, gamma ufficiale assegnata all'Association P'tite Tête) — migrazione SQL automatica preserva i permessi esistenti

Correzione critica: le pagine di amministrazione (setup, wizard, sincronizzazione prodotti) referenziavano un file CSS inesistente — caricamento del CSS e visualizzazione delle pagine ora corretti

Correzione critica: sincronizzazione stock varianti ogni ora invece di 24h

Correzione webhook products/delete — query SQL non valida corretta

Correzione critica: niente più duplicati creati su Shopify dopo purga di un prodotto con varianti

Anti-loop migliorato: protezione inter-processo sync/webhook contro deadlock

Falso positivo diagnostico corretto: API Documents 404 su prodotto di test inesistente ora segnalato come avviso anziché errore

Rimosse ~1.974 righe di codice morto

Compatibilità Dolibarr 23 — audit sistematico e correzioni

Correzione del link della licenza OAuth

Sconti non applicati sui servizi