Centro risoluzione errori
Webhook WooCommerce non funzionante: perché l'ordine non arriva all'ERP?
Se l'ordine esiste nel negozio ma non nell'ERP, individua prima il punto in cui la notifica si è fermata. Riattivare il webhook o reinviare tutti gli ordini non è, da solo, una soluzione.
Risposta breve: Verifica separatamente la generazione dell'evento, l'attività in background, la consegna HTTP e l'accettazione dell'ordine da parte dell'ERP. Non iniziare il reinvio prima di aver collegato queste quattro evidenze allo stesso negozio e identificativo d'ordine. Una risposta HTTP riuscita non dimostra che nell'ERP esista un ordine valido.
Questa guida riguarda le notifiche d'ordine che WooCommerce invia a un sistema esterno. La notifica di pagamento inviata dal fornitore di pagamento al negozio opera nella direzione opposta; il successo dell'una non verifica l'altra. Ad esempio, le impostazioni webhook della connessione Stripe riguardano l'integrazione dei pagamenti. Se ricevi un errore di autorizzazione chiamando la REST API del negozio, consulta la guida WooCommerce REST API 401.
In quale passaggio si è fermata la notifica?
Il trasferimento delle giacenze da Mikro ERP a WooCommerce è un flusso di dati separato. L'aggiornamento delle giacenze non dimostra che la notifica dell'ordine dal negozio abbia raggiunto l'ERP; i registri di accettazione dei due flussi vanno monitorati separatamente.
Circoscrivi prima un solo problema reale, indicando l'identificativo dell'ordine e un intervallo temporale con fuso orario. La tabella seguente propone una sequenza diagnostica; una singola riga di log non determina con certezza la causa principale.
| Situazione osservata | Evidenza da cercare | Decisione successiva |
|---|---|---|
| L'ordine esiste; nessuna registrazione di consegna | Stato del webhook, evento selezionato e attività in background dello stesso ordine | Distingui se l'evento non è stato generato, l'attività è in attesa o i log sono stati eliminati. L'assenza di log, da sola, non significa che non sia stato inviato. |
| Attività in attesa o fallita | Orario dell'attività, ultimo errore e ritardo della coda | Individua prima perché il gestore non avanza. Non eseguire né eliminare l'intera coda in blocco. |
| Timeout, 4xx o 5xx durante la consegna | URL di destinazione, codice di stato e, nello stesso intervallo, registro di accettazione del destinatario | Distingui un errore di indirizzo/accesso da un errore di elaborazione. In caso di timeout, verifica la possibilità che la scrittura nell'ERP sia avvenuta. |
| HTTP riuscito; ordine ERP non trovato | Registro persistente di accettazione del destinatario, stato dell'attività e numero del documento ERP | Esamina eventuali errori di mappatura di prodotto, anagrafica cliente, imposta o magazzino. Non passare a ricreare lo stesso ordine. |
| Webhook disattivato | Ultima consegna riuscita, errori successivi e intervallo degli ordini interessati | Risolvi la causa ed esegui un controllo limitato; riconcilia separatamente le mancanze pregresse. |
Quali schermate controllare in WooCommerce?
Impostazioni → Avanzate → Webhook: controlla stato, argomento e indirizzo di consegna. Il ping inviato alla prima registrazione attiva non è un test di elaborazione di un ordine reale nell'ERP. Stato → Log: esamina la fonte webhooks-delivery. WooCommerce può disattivare il webhook dopo errori di consegna consecutivi; la soglia può variare secondo la versione installata e i filtri. Gestione ufficiale dei webhook e comportamento in caso di errore.
Stato → Azioni programmate: esamina attività in attesa e fallite nell'intervallo pertinente. I ritardi delle attività in background possono ritardare anche la consegna. La documentazione WooCommerce sulle azioni programmate spiega questa schermata e il rapporto con WP-Cron. Nel codice core attuale, l'attività predefinita di consegna asincrona usa il nome woocommerce_deliver_webhook_async; i plugin possono modificare il flusso. Implementazione ufficiale della coda.
Confronta periodo di conservazione e fuso orario dei log. Un controllo di integrità generale riuscito non dimostra che l'attività di un ordine specifico sia stata eseguita. Non creare ordini di prova che possano avviare nuovi pagamenti, e-mail, fatture o spedizioni verso clienti reali; preferisci un ambiente di test con effetti collaterali limitati.
Cosa verificare per un errore di firma senza disattivare la sicurezza?
La firma predefinita di WooCommerce è il risultato HMAC-SHA256 del corpo inviato, codificato in Base64, e viene trasmessa nell'header X-WC-Webhook-Signature. Il destinatario deve usare il corpo grezzo ricevuto, anziché riformattare il JSON prima del calcolo, e verificare la corrispondenza del segreto nell'ambiente autorizzato. L'algoritmo di firma può essere modificato tramite filtro. Implementazione ufficiale di firma e consegna.
Esegui il confronto con una verifica appropriata a tempo costante; una firma mancante o non valida non autorizza l'elaborazione dell'ordine. Separa il flusso del ping da quello degli ordini. Non disattivare in blocco il controllo della firma o il firewall per risolvere il problema. Nei ticket di assistenza non condividere segreti, dati dei clienti o il corpo completo dell'ordine; possono bastare codice di errore depurato, orario e identificativo dell'operazione.
È stato restituito HTTP 200: perché nell'ERP non c'è l'ordine?
Se il destinatario risponde con successo appena vede la richiesta, l'attività successiva può andare persa. Nel progetto che proponiamo, la risposta positiva è associata all'accettazione persistente della notifica verificata oppure al completamento dell'operazione. Se si usa una coda, si distinguono gli stati "ricevuto", "in elaborazione", "accettato dall'ERP" e "verifica necessaria", con un responsabile degli errori definito. Questo comportamento deve essere implementato nell'integrazione; WooCommerce da solo non lo garantisce.
L'identificativo di consegna è utile per il monitoraggio; per deduplicare l'attività usa anche negozio e identificativo d'ordine. Le notifiche di creazione e aggiornamento dello stesso ordine non sono la stessa operazione. Applica gli aggiornamenti secondo le regole aziendali, senza ignorarli, e impedisci che una vecchia notifica ripristini uno stato superato. Le decisioni dettagliate su titolarità e accettazione sono riportate nella guida alla pianificazione dell'integrazione ERP.
Esempio: come riconciliare due notifiche mancanti?
Scenario esemplificativo, non dati di clienti: Durante un'interruzione, l'esito di consegna degli ordini 4101 e 4102 del negozio è incerto. In questo esempio gli ordini sono idonei al trasferimento nell'ERP; in un progetto reale si applicano separatamente le regole di pagamento, annullamento e rimborso.
| Ordine | Controllo ERP | Operazione controllata |
|---|---|---|
| Negozio A / 4101 | Esiste un record ERP corrispondente al riferimento esterno; righe e importo coincidono | Non creare un nuovo ordine. Collega il documento esistente al registro del trasferimento e riconcilia l'esito come "accettato dall'ERP". |
| Negozio A / 4102 | Nessuna corrispondenza nella ricerca autorizzata; verificata l'assenza di attività in corso | Verifica lo stato attuale dell'ordine e le mappature. Esegui un solo trasferimento controllato con protezione dai duplicati e controlla l'accettazione ERP. |
| Esito incerto per uno dei due ordini | ERP non accessibile o registri contraddittori | Interrompi il ciclo automatico di tentativi e attendi la verifica del responsabile. Non equiparare l'incertezza a un fallimento. |
La deduplicazione deve impedire anche che due attività simultanee vedano separatamente il record come assente e creino entrambe l'ordine. Il supporto ERP per riferimenti esterni univoci o la protezione atomica dell'integrazione vengono verificati durante il progetto. Si definiscono limiti per numero di tentativi, intervallo di attesa e durata totale di elaborazione, oltre al responsabile delle notifiche. Verifica separatamente il completamento dell'attività in coda e l'accettazione del record ERP.
Non presumere che riattivare il webhook riproduca integralmente tutte le vecchie notifiche. Registra l'intervallo interessato e riconcilia gli ordini del negozio con i record ERP. Trasferisci in modo controllato solo le mancanze verificate; reinviare tutta la cronologia può duplicare operazioni di magazzino, fatturazione e spedizione.
Quando serve assistenza per l'integrazione?
Se la consegna risulta riuscita ma non puoi tracciare l'accettazione dell'operazione, gli eventi vecchi modificano dati aggiornati o dopo un'interruzione non riesci a individuare gli ordini mancanti, il problema potrebbe andare oltre una singola impostazione. Occorre progettare insieme registro di accettazione, deduplicazione e riconciliazione.
Verifica delle fonti e aggiornamento del contenuto: 18 ottobre 2026. I link al codice core si riferiscono al ramo di sviluppo; versione di WooCommerce, plugin e filtri dell'installazione vanno verificati separatamente. Lo scenario e le tabelle decisionali sono proposte architetturali; non rappresentano risultati di clienti, test eseguiti su un'installazione WooCommerce o partnership con il produttore.
Definiamo insieme il flusso degli ordini
Possiamo valutare il perimetro di accettazione ERP e ripristino dopo gli errori attraverso il nostro servizio di sviluppo software su misura.
Parliamo delle tue esigenze →