Conectar WooCommerce con Holded: pedidos, clientes y facturación
Evalúa la integración disponible de Holded y define qué documento crear, cuándo importar una venta y cómo tratar contactos, cancelaciones y duplicados.
Holded dispone de una integración con WooCommerce. Antes de desarrollar una conexión propia, conviene comprobar si sus opciones cubren tus ventas y qué configuración necesitan. La decisión principal es qué registro debe generar cada pedido y en qué momento de su recorrido.
Esta guía se centra en documentos, contactos y excepciones. Para criterios generales de catálogo y stock, consulta la comparación de conectores e integración mediante API.
1. Elegir el documento de destino
La documentación de integración de Holded describe opciones de importación de ventas. La elección debe reflejar cómo trabaja la empresa: registrar un pedido, emitir una factura y anotar un pago son operaciones distintas.
Anota qué sistema emite el documento definitivo y comprueba si otro plugin de WooCommerce ya lo está haciendo. Dos automatismos pueden crear documentos para una misma operación aunque cada uno funcione correctamente por separado.
Define la serie y los criterios de emisión con la persona responsable de facturación. La integración implementa esas reglas; no determina por sí sola qué documento exige cada venta.
2. Confirmar qué estado inicia la importación
Según las preguntas frecuentes de Holded, al configurar la sincronización como facturas o tickets de venta, la importación depende de que el pedido esté marcado como completado en WooCommerce. Comprueba la opción utilizada y la documentación vigente antes de decidir el flujo.
Esto importa si tu tienda mantiene los pedidos pagados en procesamiento mientras prepara el envío. Documenta cuándo cambian de estado y quién lo hace. No fuerces todos los pedidos a completado solo para que una integración se ejecute.
Prepara una prueba con pago pendiente, pago confirmado, pedido completado y cancelación. Escribe el resultado esperado para cada caso antes de activar pedidos reales.
3. Asociar clientes con contactos
Revisa qué datos transfiere el conector y cómo asocia contactos existentes. El correo puede ser una referencia operativa, pero no resuelve por sí solo empresas con varios compradores, cambios de dirección o clientes que compran como invitados.
Prueba un contacto existente, uno nuevo y un pedido sin cuenta de usuario. Si falta un dato requerido, deja el caso pendiente con un motivo claro. No inventes identificadores fiscales ni relaciones entre empresas para completar una importación.
En una conexión propia, conserva los identificadores de ambos sistemas. La API de creación de facturas de Holded describe esa operación para contactos existentes, por lo que el recorrido de contacto debe resolverse antes de ejecutarla.
4. Comparar líneas y totales
Comprueba productos, cantidades, descuentos, envío, moneda y total. Un pedido puede cuadrar en importe final y tener líneas mal clasificadas. Incluye variantes, cupones y redondeos en la prueba.
Define qué ocurre con productos sin referencia o servicios ajenos al catálogo. Una correspondencia ambigua debe ser visible para quien revisa las ventas, en lugar de vincularse por una coincidencia aproximada del nombre.
La revisión de impuestos y documentos debe seguir la configuración validada por la empresa. No copies importes sin comprobar si origen y destino esperan precios con impuestos incluidos o excluidos.
5. Revisar pagos, cancelaciones y devoluciones
Un documento creado no demuestra que el cobro esté conciliado. Comprueba qué información de pago transfiere la integración y qué queda pendiente de revisar con el banco o la pasarela.
Verifica el soporte real de cancelaciones y devoluciones en la opción seleccionada. Define cómo detectar una devolución parcial, quién revisa el documento resultante y qué acciones son manuales. Cambiar el estado en WooCommerce no garantiza que se resuelva todo el recorrido en Holded.
6. Recuperar fallos sin duplicar documentos
Si una operación queda a medias, busca primero su referencia en Holded antes de repetirla. Una respuesta perdida puede ocultar una creación completada. Conserva pedido de origen, documento de destino, momento del intento y resultado.
Para una conexión propia, establece reintentos limitados y revisión de discrepancias. Antes de importar pedidos históricos, marca un límite de fechas y excluye ventas ya trasladadas. Reprocesar el historial sin referencias puede duplicar trabajo y documentos.
Cuándo personalizar la conexión
El conector disponible puede ser suficiente si sus opciones coinciden con tu operación. Una personalización tiene sentido cuando faltan campos, intervienen otros sistemas o hay reglas de estados que no puede representar. Confirma qué falta con una prueba y después delimita el desarrollo.
Reúne un ejemplo de pedido normal, otro con descuento y una devolución, junto con el tipo de documento deseado y la configuración actual. Esos ejemplos permiten evaluar el alcance con más precisión que pedir una sincronización de todo.
Podemos evaluar la integración de WooCommerce con ERP y CRM, preparar una integración mediante API o revisar la automatización de pedidos. Si estás eligiendo ERP, la guía de WooCommerce con Odoo aborda catálogo, almacenes y disponibilidad.