Webhooks de WooCommerce y Sellsy

¿Para qué sirven los webhooks?

Los webhooks permiten que Order Invoicer sea notificado de inmediato cuando se produce un evento (nuevo pedido, actualización de producto, factura pagada en Sellsy, etc.). Complementan las sincronizaciones periódicas (tareas programadas) ya existentes.

Sin webhooks operativos, algunas acciones pueden tardar más en tenerse en cuenta.

---

WooCommerce

Lo que se configura por usted

Cuando guarda la conexión con su tienda (URL + claves de API de WooCommerce), Order Invoicer crea o actualiza automáticamente los webhooks necesarios en su sitio.

Se utilizan los siguientes topics:

• Pedidos: creación, actualización, eliminación
• Productos: creación, actualización, eliminación

Cada webhook apunta a una URL de entrega gestionada por Order Invoicer (una pasarela segura). No tiene que copiarla manualmente.

Otros plugins o herramientas

Si ya dispone de webhooks de WooCommerce para el mismo topic pero que apuntan a otra URL (otra herramienta, Zapier, etc.), Order Invoicer no los elimina. Solo los webhooks de Order Invoicer (la misma URL de entrega que la nuestra) se reparan o se deduplican durante las comprobaciones automáticas.

Comprobar que todo está correcto

1. En Order Invoicer, abra su conector
2. Vaya a Configuración (o Setup)
3. La pestaña de su tienda (comercio electrónico)
4. Revise la sección Webhooks: cada topic debe estar en estado OK

Allí también verá los topics ausentes, inactivos o con una URL incorrecta (otra integración en el mismo topic).

WooCommerce: registro de entregas vacío

En WooCommerce, la pantalla Webhooks → Registro de entregas (o equivalente) solo muestra una entrada después de que se haya enviado un evento. Si acaba de instalar los webhooks y no ha cambiado ningún pedido ni producto, el registro puede permanecer vacío: esto es normal.

Para probarlo: cree o actualice un pedido / un producto y vuelva a comprobarlo.

Resolución de problemas de WooCommerce

• Enlaces permanentes de WordPress: utilice una estructura distinta de «Plain» si la API REST o los webhooks fallan.
• Plugins de seguridad / firewalls: pueden bloquear las llamadas entrantes; añada una excepción si es necesario.
• La URL de la tienda en Order Invoicer: debe coincidir con la tienda (incluida una subcarpeta https://site.com/boutique si esa es su configuración). Una discrepancia http / https suele gestionarse, pero la URL guardada debe seguir siendo la correcta.
• En caso de duda, la sección Webhooks en la página del conector resume el estado real del lado de la API.

---

Sellsy

Lo que se configura por usted

Cuando conecta Sellsy (OAuth) en un conector, Order Invoicer registra un webhook en su cuenta de Sellsy: una única entrada por cuenta, que apunta a la misma infraestructura segura que para WooCommerce.

Los tipos de evento (factura, presupuesto, artículo, pago, etc.) siguen la configuración prevista por Order Invoicer. No tiene que marcar manualmente cada casilla en Sellsy si sigue nuestro flujo de instalación.

Comprobar que todo está correcto

1. Abra el conector
2. Configuración / Setup
3. La pestaña Facturación (Sellsy)
4. La sección Webhooks: puede ver si el webhook está presente, activo y si cada evento requerido cumple los requisitos.

Errores del lado de Sellsy

Si los eventos ya no se envían o si la aplicación informa de un problema de autenticación en el webhook:

• Reconecte Sellsy (OAuth) desde Order Invoicer para renovar los tokens de acceso.
• Asegúrese de que el usuario conectado tenga los permisos adecuados en Sellsy (se recomienda un administrador).

---

¿Necesita ayuda?

Para un conector WooCommerce + Sellsy, consulte también la documentación general.
Contacto: contact@orderinvoicer.com.