Integració amb WooCommerce
Configura el connector de botiga i el plugin oficial, inclosos el NIF del checkout i el diagnòstic de connexió.
El connector processa comandes i devolucions a Factuarea. El plugin oficial de WordPress afegeix la configuració a la botiga, la captura del NIF al checkout i l’accés a factures. Descarrega la versió v0.1.0; aquesta guia no depèn de la publicació al directori de WordPress. Requereix WordPress 6.5+, WooCommerce 8.9+ i PHP 8.1+.
Configura la connexió
Instal·la el ZIP de la versió a WordPress i autoritza WooCommerce a Factuarea. Segueix el cicle de la botiga per associar la connexió del proveïdor amb la botiga. Configura el plugin amb la seva API key de Factuarea, l’ID de botiga i el secret de signatura del webhook. L’API key consulta la botiga i els PDF de factures; el secret de signatura verifica les notificacions entrants. Mantén separades aquestes credencials.
Revisa la recollida del NIF al checkout, si els preus inclouen impostos, el llindar de factura simplificada i l’enviament automàtic abans d’habilitar la integració. El plugin roman inactiu fins que l’habilites expressament. Una botiga en mode test descarta els esdeveniments de comanda amb un motiu explicat; les credencials de test també suprimeixen el correu real i el lliurament de webhooks públics.
Comprova totes dues direccions
curl -X POST "https://api.factuarea.com/v1/woocommerce/stores/$STORE_ID/connection-test" \
-H "Authorization: Bearer $FACTUAREA_API_KEY" \
-H "Idempotency-Key: woocommerce-check-2026-09-08"La prova de connexió del plugin consulta la botiga a Factuarea. L’operació REST anterior comprova l’accés de Factuarea a WooCommerce i necessita woocommerce_store:write. woocommerce_credentials_rejected requereix revisar l’autorització del proveïdor; woocommerce_rest_route_missing, les rutes REST de WooCommerce; woocommerce_store_unreachable, la disponibilitat i connectivitat. Consulta els camps de la resposta 200, no només l’estat HTTP.
Després d’una comanda pagada o una devolució, consulta la safata d’integracions i l’esdeveniment order.invoiced o order.refunded resultant. La reconciliació pot recuperar notificacions del proveïdor que s’hagin perdut. Abans de crear una factura manualment, comprova si l’esdeveniment està aparcat i si el seu document ja existeix, per no facturar dues vegades la mateixa comanda.