Los pedidos de WooCommerce no aparecen en Holded: qué revisar
Revisa el documento configurado, el estado del pedido, los filtros y la referencia de destino antes de repetir una importación o cambiar todos los pedidos.
Si un pedido de WooCommerce no aparece en Holded, comprueba primero qué documento debería crear la integración y qué estado permite enviarlo. Un pedido pagado puede seguir en procesamiento y no cumplir la condición configurada. Antes de reimportarlo, busca su referencia en el destino para descartar que exista como borrador o en otra vista.
Esta guía investiga un fallo de una conexión existente. Para preparar una instalación nueva, consulta cómo conectar WooCommerce con Holded y definir pedidos, clientes y facturación.
1. Elegir un pedido que permita reproducir el problema
Anota identificador interno, número visible, fecha, estado actual y cambios anteriores. Incluye qué documento esperabas encontrar, en qué cuenta de Holded y desde cuándo falta. El número mostrado al cliente puede diferir del identificador que utiliza el conector.
Compara ese pedido con uno que sí llegó. Si todos los fallos empiezan en una misma fecha, revisa cambios de credenciales, configuración o versiones. Si solo falla un grupo, compara formas de pago, productos y estados antes de asumir una caída general.
No utilices una factura real como experimento de creación repetida. Las primeras comprobaciones deben leer configuración y registros; las acciones de escritura requieren conocer su efecto.
2. Revisar el estado y el tipo de documento
La documentación de Holded distingue pedidos de venta, tickets y facturas. Para la importación como ticket o factura, indica que el pedido debe estar completado en WooCommerce. Comprueba la configuración concreta, porque pago confirmado y pedido completado no son siempre el mismo momento.
Si vendes productos físicos, el pedido puede permanecer en procesamiento mientras preparas el envío. La solución no consiste necesariamente en completar todos los pedidos: primero decide cuándo debe producirse la importación dentro de tu operación.
Un pedido de venta permite representar otro recorrido. Cambiar el tipo de documento puede afectar seguimiento y facturación, por lo que debe acordarse con la persona responsable antes de modificarlo.
3. Buscar el documento sin depender de una sola vista
Revisa fechas, filtros, canal de venta y documentos en borrador. La documentación de Holded describe la creación en borrador como comportamiento inicial de su integración, salvo configuración de aprobación automática.
Busca también por referencia de origen, contacto e importe. Un documento localizado con datos diferentes no debe considerarse correcto únicamente porque su total coincide. Contrasta productos, descuentos y gastos de envío con el pedido elegido.
Esta comprobación separa tres situaciones: el documento no se creó, se creó pero no está en la vista esperada, o se creó con datos incorrectos. Cada una necesita una corrección distinta.
4. Investigar la ejecución de la integración
Identifica si utilizas la integración de Holded, un plugin de terceros, Make, n8n o una API propia. Sus registros, disparadores y reglas pueden ser diferentes. No todos los conectores utilizan webhooks.
Cuando la conexión sí utiliza webhooks de WooCommerce, revisa estado y registros de entrega. Una respuesta satisfactoria del receptor confirma recepción según su implementación; no demuestra por sí sola que el documento terminó creado en Holded.
Busca el pedido en las tareas pendientes, los errores del conector y la respuesta del destino. Conserva identificador y hora para correlacionar ambos sistemas. Si aparece una respuesta de autenticación o validación, resuelve esa causa antes de programar reintentos.
5. Diferenciar ventas nuevas e importación histórica
La documentación de Holded contempla configurar la importación de pedidos antiguos. Comprueba si el pedido pertenece al periodo que cubre la configuración actual y qué acciones activa una recuperación histórica.
Antes de ejecutar una importación amplia, compara referencias ya existentes. Restaurar un intervalo completo sin excluir lo procesado puede crear duplicados o exigir correcciones manuales. Empieza por un caso controlado y registra el resultado.
6. Recuperar el pedido y verificar el recorrido
Si una petición terminó por timeout, confirma si el destino guardó el documento antes de crear otro. Conserva una correspondencia entre pedido de WooCommerce y documento de Holded para recuperar operaciones sin perder su identidad.
Después de corregir, prueba el pedido afectado y uno nuevo con el mismo recorrido. Revisa líneas, estado, referencia y comportamiento de stock. No des por terminado el trabajo cuando desaparece el mensaje de error: el resultado debe coincidir con lo acordado.
Qué información reunir para pedir ayuda
Prepara versiones, nombre del conector, tipo de documento, estado del pedido, momento del fallo y mensaje de error sin credenciales. Incluye una referencia que haya funcionado y otra que no. Esos datos permiten investigar sin empezar por una reimportación masiva.
Podemos revisar la integración de WooCommerce con ERP, investigar una conexión mediante API o mantener el recorrido dentro del soporte WooCommerce. La guía general de sincronización con Odoo y Holded ayuda a revisar las responsabilidades entre sistemas.