WooCommerce / Integracions
Problemes d’integració a WooCommerce: REST API, webhooks i sistemes externs
Les integracions fallen a les vores: autenticació, xarxa, temps d’espera, reintents i correspondència de dades. La dificultat és que cada costat només veu la meitat de la conversa, així que la diagnosi comença ajuntant les dues meitats.
Resposta curta
A la REST API, llegeix el codi d’error exacte de la resposta: woocommerce_rest_cannot_view o un 401 apunten a l’autenticació o als permisos de la clau, un 403 a una capa de seguretat, un 500 a un error PHP a la botiga. Als webhooks, obre el registre de lliuraments del webhook a WooCommerce: codis de resposta, temps d’espera i fallades repetides. WooCommerce desactiva un webhook després de diversos lliuraments fallits seguits.
Recursos tècnics
Guies sobre integracions
- WooCommerce / Integracions Errors de la REST API de WooCommerce: com diagnosticar-los Llegeix el codi d’estat i el codi d’error de la resposta: autenticació, permisos, rutes, capes de seguretat i errors del servidor fallen cadascun d’una manera.
- WooCommerce / Integracions Webhooks de WooCommerce que fallen: com diagnosticar-los Registres de lliurament, codis de resposta, signatures i per què WooCommerce desactiva un webhook després de diversos lliuraments fallits seguits.
Problemes concrets
Fallades d’integració habituals
Errors d’autenticació de la REST API
401 i woocommerce_rest_cannot_view: claus, permisos, HTTPS, capçaleres eliminades.
Lliuraments de webhooks que fallen
Temps d’espera esgotats, respostes no 2xx, webhooks desactivats, signatures que no es validen.
Problemes de sincronització amb l’ERP
Comandes o estoc desincronitzats, duplicats, actualitzacions parcials.
Problemes de sincronització amb el CRM
Clients i comandes que no arriben al CRM, o que hi arriben dues vegades.
Temps d’espera d’API externes
Crides a tercers que alenteixen o trenquen el checkout i l’administració.
Cues de sincronització en segon pla
Tasques d’integració encallades a Action Scheduler.
Ajunta les dues meitats de la conversa
Un problema d’integració sol veure’s diferent des de cada costat. L’ERP diu «la botiga ha retornat un error»; els registres de la botiga no mostren res. O la botiga diu «webhook lliurat» i el sistema receptor assegura que no l’ha processat mai. La diagnosi alinea tots dos costats per a la mateixa comanda o la mateixa petició, per hora i identificador.
| Símptoma | On mirar |
|---|---|
| El client de l’API rep 401/403 | Permisos de la clau, capçaleres d’autenticació que arriben a PHP, regles de seguretat |
| El client de l’API rep 500 | Registres PHP i fatal-errors de la botiga a aquella hora |
| Webhook «no rebut» | Registre de lliuraments del webhook a WooCommerce, codi de resposta, durada |
| Les dades arriben dues vegades | Reintents sense idempotència, webhooks duplicats, diverses tasques de sincronització |
| Checkout lent o amb fallades | Crides externes síncrones durant la petició del checkout |
Construeix integracions que es puguin depurar
Les integracions fàcils de diagnosticar comparteixen uns trets: cada petició es registra amb un identificador, les fallades es reintenten amb límits, les operacions són idempotents perquè els reintents no dupliquin dades i la feina pesada o lenta s’executa en segon pla, no dins de la petició d’un client.
Preguntes freqüents
Per què la REST API de WooCommerce retorna 401?
Causes habituals: claus API incorrectes o revocades, claus sense permís de lectura o escriptura, capçaleres d’autenticació eliminades pel servidor o un proxy, i autenticació bàsica enviada per HTTP sense xifrar. El codi d’error del cos de la resposta acota la causa.
Per què s’ha desactivat el meu webhook de WooCommerce?
WooCommerce desactiva un webhook després de diversos lliuraments fallits consecutius: respostes fora del rang 2xx o temps d’espera esgotats. Arregla l’endpoint receptor i torna a activar el webhook. El registre de lliuraments mostra cada intent fallit.
Com verifico que un webhook de WooCommerce és autèntic?
Cada lliurament inclou una capçalera X-WC-Webhook-Signature: un HMAC-SHA256 del cos de la petició codificat en base64, calculat amb el secret del webhook. Calcula’l al costat receptor i compara’ls.
$ descriu el problema
Tens un problema amb WooCommerce?Sol·licita una diagnosi.
Explica'ns què falla, què ha canviat darrerament i com afecta el negoci. Revisem cada sol·licitud i et recomanem el pas següent.
No enviïs mai contrasenyes, claus d'API ni dades de targetes a través del formulari.