Magazzino WooCommerce e gestionale non coincidono: quali dati confrontare

Quando il magazzino WooCommerce e il gestionale mostrano quantità diverse, confronta prima lo stesso articolo, la stessa disponibilità e lo stesso momento. Una differenza può dipendere da un ordine ancora da importare, da un prodotto associato male o da due sistemi che riscrivono la quantità. Correggere il numero a mano, senza ricostruire il movimento, può far ricomparire il problema al successivo aggiornamento.

Per capire dove si interrompe la sincronizzazione serve una cronologia: quale sistema ha cambiato lo stock, per quale evento e quando l’altro avrebbe dovuto riceverlo. Ecco quali dati raccogliere prima di chiedere un intervento sull’integrazione.

Stabilisci chi aggiorna il magazzino WooCommerce

Chiedi a chi gestisce il collegamento una regola scritta: da quale sistema deve provenire la quantità vendibile? Può essere il gestionale, ma non va dato per scontato. L’integrazione potrebbe importare gli ordini dal negozio e inviare le disponibilità in direzione opposta, con passaggi e tempi differenti.

Per ciascun flusso annota origine, destinazione, evento di avvio e intervallo previsto. Specifica anche se il connettore invia una quantità completa, per esempio “ora sono 10”, oppure un movimento, per esempio “sottrai 2”. La ripetizione dello stesso movimento richiede un controllo diverso dalla sovrascrittura di una quantità con un valore vecchio.

Individua inoltre chi può intervenire manualmente. Se un operatore corregge WooCommerce mentre il gestionale continua a inviare un altro numero, l’allineamento può durare soltanto fino al prossimo ciclo.

Verifica che i due numeri rappresentino la stessa cosa

Giacenza fisica e disponibilità alla vendita

Dieci pezzi sugli scaffali non significano necessariamente dieci pezzi vendibili: alcuni potrebbero essere già impegnati. La documentazione LibertyCommerce distingue giacenza e disponibilità proprio in relazione agli articoli prenotati. Controlla però il significato dei campi nel gestionale che usi: etichette e formule possono cambiare.

Annota il deposito coinvolto, le quantità riservate e l’eventuale quota destinata agli altri canali. Confrontare il totale di più magazzini con la sola disponibilità del negozio online può produrre una differenza prevista dalle regole commerciali.

SKU del prodotto e della variante

Confronta codice SKU, identificativo WooCommerce e codice del gestionale. Nome e fotografia non bastano a identificare taglia, colore o confezione. Verifica anche l’unità di misura: un collo da sei pezzi deve essere interpretato nello stesso modo lungo il collegamento.

Nei prodotti variabili WooCommerce lo stock può essere gestito a livello del prodotto oppure delle singole varianti. Prima di sommare quantità, controlla quale livello utilizza il negozio e quale viene associato dal connettore. Un collegamento fra variante e prodotto principale può spostare il confronto sull’articolo sbagliato.

Ricostruisci ordini resi e rettifiche

Scegli uno SKU con una divergenza e parti dall’ultimo momento in cui i valori risultavano coerenti. Raccogli gli ordini che lo contengono, quantità, stati e note, poi collega ciascuno all’eventuale documento o movimento nel gestionale. Includi vendite al banco, marketplace, carichi e correzioni inventariali avvenuti nello stesso intervallo.

Per ogni evento conserva due orari: quando è avvenuta l’operazione e quando è stata acquisita dall’altro sistema. Indica sempre il fuso orario: due registrazioni apparentemente distanti un’ora potrebbero riferirsi allo stesso istante.

Reso fisico, rimborso economico e rientro in stock vanno verificati separatamente. WooCommerce prevede l’opzione per rimettere a magazzino gli articoli rimborsati. Controlla se è stata utilizzata e come il connettore tratta quel passaggio. Il solo importo restituito al cliente non dimostra che la merce sia rientrata e sia nuovamente vendibile.

Una tabella per leggere il disallineamento

Questa è una simulazione con dati fittizi, non una prova su un negozio reale. Lo SKU DEMO-BLU-M identifica la stessa variante in entrambi i sistemi. Per l’esempio si ipotizza che il gestionale invii la disponibilità al sito dopo avere importato gli ordini; gli orari sono tutti Europe/Rome.

Nel primo scarto il dato converge dopo il passaggio previsto. Nel secondo, la correzione manuale viene sovrascritta: occorre chiarirne la ragione e registrare l’eventuale rettifica nel sistema responsabile. La tabella mostra perché due schermate raccolte in momenti diversi non bastano a diagnosticare un guasto.

Se la differenza resta controlla il percorso del dato

Quando lo scarto persiste oltre il tempo previsto dal collegamento, cerca l’ultimo evento riuscito per quello SKU. Chiedi al tecnico di verificare associazione dei codici, operazioni in coda, errori e tentativi successivi. Conserva gli identificativi delle operazioni per distinguere un evento mancante da uno elaborato due volte.

Se il connettore usa webhook WooCommerce, la guida ufficiale ai webhook indica come controllarne stato e registri di consegna. Un invio riuscito documenta la comunicazione con il destinatario; va ancora verificato che il gestionale abbia applicato il movimento corretto. Un collegamento che lavora tramite importazioni periodiche richiederà invece i registri di quelle importazioni.

Controlla infine la sequenza: un aggiornamento vecchio arrivato dopo uno più recente può riportare indietro la quantità. La causa va cercata nel percorso effettivamente utilizzato, senza presumere che tutti i connettori funzionino allo stesso modo.

Prepara una riconciliazione verificabile

Esporta una fotografia dei dati prima delle correzioni e concorda il valore di riferimento con chi segue il magazzino. Inizia da un piccolo insieme di SKU, documentando valore iniziale, movimento mancante o errato, intervento e valore finale. Un’importazione massiva senza questa ricostruzione rende più difficile capire che cosa sia successo.

Il collaudo da concordare comprende un ordine, un annullamento, un rimborso con eventuale reintegro e una rettifica inventariale. Sono prove da eseguire in un ambiente controllato, con risultati attesi e tempi definiti per il connettore specifico. Questa guida non certifica l’esecuzione di quei test.

Per le attività ordinarie puoi approfondire i consigli per gestire l’inventario WooCommerce. Se invece devi risolvere giacenze non sincronizzate, richiedi una verifica dell’integrazione WooCommerce indicando gestionale, connettore, uno SKU di esempio e gli orari della divergenza. Una cronologia circoscritta permette di impostare la diagnosi senza inviare l’intero archivio clienti o credenziali.