Integración con WooCommerce
Configura el conector de tienda y el plugin oficial, incluidos el NIF del checkout y el diagnóstico de conexión.
El conector procesa pedidos y devoluciones en Factuarea. El plugin oficial de WordPress añade la configuración en la tienda, la captura del NIF en el checkout y el acceso a facturas. Descarga la versión v0.1.0; esta guía no depende de su publicación en el directorio de WordPress. Requiere WordPress 6.5+, WooCommerce 8.9+ y PHP 8.1+.
Configura la conexión
Instala el ZIP de la versión en WordPress y autoriza WooCommerce en Factuarea. Sigue el ciclo de la tienda para asociar la conexión del proveedor con la tienda. Configura el plugin con su API key de Factuarea, ID de tienda y secreto de firma del webhook. La API key consulta la tienda y los PDF de facturas; el secreto de firma verifica las notificaciones entrantes. Mantén separadas esas credenciales.
Revisa la recogida del NIF en el checkout, si los precios incluyen impuestos, el umbral de factura simplificada y el envío automático antes de habilitar la integración. El plugin permanece inactivo hasta habilitarlo expresamente. Una tienda en modo test descarta los eventos de pedido con un motivo explicado; las credenciales de test también suprimen el correo real y la entrega de webhooks públicos.
Comprueba ambas direcciones
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 prueba de conexión del plugin consulta la tienda en Factuarea. La operación REST anterior comprueba el acceso de Factuarea a WooCommerce y necesita woocommerce_store:write. woocommerce_credentials_rejected requiere revisar la autorización del proveedor; woocommerce_rest_route_missing, las rutas REST de WooCommerce; woocommerce_store_unreachable, la disponibilidad y conectividad. Consulta los campos de la respuesta 200, no solo el estado HTTP.
Tras un pedido pagado o una devolución, consulta la bandeja de integraciones y el evento order.invoiced u order.refunded resultante. La reconciliación puede recuperar notificaciones del proveedor que se hayan perdido. Antes de crear una factura manualmente, comprueba si el evento está aparcado y si su documento ya existe, para no facturar dos veces el mismo pedido.