Cómo conectar Holded con WooCommerce: guía completa del conector oficial [2026]

Si gestionas tu negocio con Holded y vendes (o vas a vender) con WooCommerce, mantener las dos plataformas sincronizadas a mano es una fuente inagotable de errores: stock que no cuadra, facturas por duplicar, clientes copiados a mano. La buena noticia, puedes conectar Holded con Woocommerce, ya que Holded tiene conector oficial para WooCommerce, es gratuito y para la mayoría de tiendas es la forma correcta de conectar ambos mundos.

En esta guía vamos más allá del «instala y listo»: te contamos qué sincroniza exactamente (y en qué dirección, que es el detalle que interesa e importa conocer, cómo configurarlo bien a la primera y dónde están los límites del conector oficial.

Qué sincroniza el conector oficial (y en qué dirección)

Esto es lo primero que hay que entender, porque no todo fluye en ambos sentidos:

Dato	Dirección	Detalle
Pedidos	WooCommerce → Holded	Cada venta se convierte en pedido, ticket o factura de venta en Holded
Productos	WooCommerce → Holded solamente	Los cambios hechos en Holded NO viajan a la tienda
Stock	Bidireccional	Un ajuste en cualquiera de las dos plataformas actualiza la otra (requiere la gema Inventario en Holded)
Contactos/clientes	WooCommerce → Holded	Se crean al importar pedidos, no como sincronización independiente
Almacenes	Mapeo	Asocias tu ubicación WooCommerce a un almacén de Holded

La asimetría de productos es el detalle que más despista: el catálogo maestro vive en WooCommerce, no en Holded. Si cambias un precio o una descripción en Holded, la tienda no se entera. El stock, en cambio, sí es bidireccional — que es justo lo que necesitas si también vendes fuera de la web (tienda física, marketplaces, venta directa).

La pieza que lo sostiene todo: el SKU

El conector vincula los productos entre plataformas por SKU. De aquí derivan las tres reglas que evitan el 90% de los problemas:

1. Todos los productos (y todas las variantes) necesitan SKU en WooCommerce. Sin SKU, el producto no se sincroniza. Punto.
2. El SKU debe ser idéntico en ambas plataformas. Si en Holded es «CAM-001» y en Woo es «cam001», para el conector son productos distintos.
3. Los SKU no pueden repetirse entre productos simples y variantes, o el stock bailará entre ellos.

Antes de conectar nada, dedica una hora a auditar tus SKU. Es la hora mejor invertida de toda la integración.

Cómo conectar Holded con WooCommerce, paso a paso

1. En Holded: ve a la Holded Store (arriba a la izquierda) → pestaña Integraciones → WooCommerce → «Activar». Aparecerá WooCommerce en tu menú lateral, bajo Integraciones.
2. Descarga el plugin oficial: en «Conecta y configura», pulsa «Descargar WooCommerce Plugin».
3. En WordPress: Plugins → Añadir nuevo → Subir plugin, instala el archivo descargado y actívalo.
4. Genera la clave API: en Holded, Configuración → Más → Desarrolladores → nueva API key.
5. Pega la clave en WooCommerce: Ajustes → Integraciones → Holded, guarda y verifica que la clave queda registrada.
6. Configura las opciones de sincronización en Holded (Integraciones → WooCommerce → Configuración) — las repasamos a continuación, porque los valores por defecto no siempre son los que quieres.

Un apunte útil si tienes varias tiendas WooCommerce: puedes conectarlas todas a la misma cuenta de Holded usando la misma API key (la primera que generaste).

Las decisiones de configuración que importan

Aquí es donde una integración «que funciona» se diferencia de una integración bien montada:

¿Pedido, ticket o factura? Decide en qué se convierte cada pedido de WooCommerce al llegar a Holded. Para la mayoría de tiendas B2C, la factura de venta directa simplifica; si tu flujo tiene fases (preparación, envío), el pedido de venta te da más control.

El modo borrador viene activado por defecto. Los documentos generados desde WooCommerce se crean como borradores en Holded y hay que aprobarlos. Al principio es una red de seguridad estupenda para validar que impuestos e importes cuadran; cuando confirmes que todo está bien, valora desactivarlo para automatizar del todo.

Impuestos: prepara Holded antes. Los pedidos importados usan los impuestos que ya existan en tu cuenta de Holded; si no hay uno específico, aplica el más cercano — con sorpresas potenciales. Crea antes los impuestos genéricos que uses (IVA 21%, 10%…) y activa la opción de «impuesto por defecto» para pedidos que lleguen con el campo vacío. Si vendes fuera de España (OSS, intracomunitarios), configura los impuestos por país antes de activar nada.

Reconciliación automática: actívala. WooCommerce y Holded redondean con métodos ligeramente distintos; esta opción añade una línea de ajuste para que los totales coincidan al céntimo. Sin ella, tendrás descuadres de céntimos que enloquecen cualquier revisión contable.

El NIF necesita un paso extra. WooCommerce no pide NIF de serie, y sin él tus facturas en Holded quedan cojas. Se resuelve con el plugin de campo NIF que recomienda la propia Holded, marcando «campo requerido» y «validar campo» en su configuración.

Contactos: activa «Crear contacto» en la configuración de la integración para que cada pedido genere o vincule el cliente en Holded. Si está desactivado, los pedidos llegan con los datos de cliente vacíos.

Los límites del conector oficial (dilos antes de que duelan)

Nuestra filosofía en integraciones es clara: usar el conector oficial cuando existe, y movernos dentro de lo que la API oficial permite. Los apaños por fuera de ahí acaban rompiéndose con las actualizaciones. Pero precisamente por eso conviene conocer los límites del conector antes de comprometer tu operativa a él:

• Productos solo simples y con variantes. Packs, lotes y números de serie no se sincronizan correctamente. Si tu catálogo depende de ellos, hay que diseñar la operativa alrededor (o plantear desarrollo con la API).
• El catálogo no baja de Holded a la tienda. Si tu flujo ideal es «gestiono productos en Holded y se publican en la web», el conector oficial no lo hace — es exactamente al revés.
• Un solo almacén por tienda WooCommerce. Multi-almacén real requiere otro planteamiento.
• El momento de facturación es configurable pero limitado: revisa con tu asesor en qué estado del pedido quieres generar la factura (cobro vs pedido completado), porque tiene implicaciones de IVA en pagos anticipados.
• Sin lógica personalizada: tarifas por cliente, reglas de facturación complejas o transformaciones de datos entre plataformas quedan fuera del alcance del plugin.

Para la mayoría de tiendas — catálogo estándar, un almacén, facturación directa — el conector oficial cubre perfectamente. Cuando la operativa se sale de ese perfil, la respuesta correcta no es un plugin milagro de terceros: es un desarrollo controlado sobre la API oficial de Holded, que es justo el tipo de proyecto de integración que hacemos sobre las tiendas que desarrollamos — tienes el contexto de ese tipo de trabajo en nuestra guía de desarrollo de tiendas online.

Errores comunes (y cómo evitarlos)

1. Conectar sin auditar los SKU. El origen del 90% de los «no me sincroniza».
2. No crear los impuestos en Holded antes de importar pedidos. Resultado: importes con el impuesto «más cercano» y facturas que hay que corregir a mano.
3. Olvidar el plugin del NIF. Te das cuenta el día que un cliente te pide factura… y no tienes su NIF.
4. Desactivar el modo borrador el primer día. Valida una o dos semanas de pedidos reales antes de automatizar la aprobación.
5. Productos con variantes en una plataforma y simples en la otra. El conector los tratará como productos distintos y el stock se desincronizará.

Preguntas frecuentes

---

¿Quieres montar la integración Holded + WooCommerce bien a la primera, o tu operativa se sale de lo que cubre el conector oficial? Podemos ayudarte a desarrollar integraciones sobre su API oficial. Cuéntanos tu caso →