Conectar Holded con WooCommerce: el plugin, paso a paso, y lo que no sincroniza

Conectar Holded con WooCommerce es lo que evita pasar a mano los pedidos de tu tienda a la contabilidad. Holded tiene una integración oficial que se instala con su plugin para WordPress y una clave de API, y que trae pedidos, productos y stock. Funciona, pero tiene detalles propios de WooCommerce que conviene conocer antes de activarla, porque afectan a la fecha de tus facturas, al IVA de tus ventas y a si el banco cuadra a fin de mes. Esto es lo que se sincroniza, cómo se instala y qué revisar.

🔌 Qué sincroniza la integración

Según la documentación de Holded (consultada en octubre de 2026), la integración enlaza las dos plataformas por el SKU de cada producto y mueve esto:

Si ya conoces la de Shopify, la lógica es la misma, pero cambia cómo se instala y cuándo entra cada venta. Lo de Shopify lo contamos en integración Shopify y Holded.

🛠️ Cómo se instala, paso a paso

A diferencia de Shopify, que se instala desde su tienda de apps, en WooCommerce la conexión se hace con un plugin de Holded y una clave de API. Los pasos, según la guía de instalación de Holded:

1. Activa la integración en Holded. En la tienda de Holded (arriba a la izquierda), pestaña Integraciones, elige WooCommerce, pulsa Activar y luego Conectar y configurar.

2. Descarga el plugin y súbelo a WordPress. Desde la ventana de configuración de Holded descargas el plugin, y en WordPress lo subes en Plugins, Añadir nuevo. Ojo con el nombre del archivo: si el navegador le añade un "(1)", quítaselo antes de subirlo.

3. Copia la clave de API v1. En Holded, Configuración, Desarrolladores, Credenciales. Tiene que ser la primera clave de la lista de API v1: si tienes varias y usas otra, la sincronización falla. Pégala en WooCommerce, en Ajustes, Integraciones, Holded.

4. Configura qué se sincroniza. De vuelta en Holded, en los ajustes de WooCommerce eliges en qué se convierten los pedidos (factura, ticket o pedido de venta), la cuenta de ventas, qué método de pago va a qué banco, si se importan productos, cómo se sincroniza el stock y en qué almacén.

5. Instala el plugin del NIF si vendes a empresas. WooCommerce no pide el NIF en el checkout de serie. Para que llegue a la factura de Holded hace falta un plugin adicional de NIF, con el campo marcado como obligatorio y validado.

¿Plugin oficial o de terceros? Todo lo de este artículo se refiere a la integración oficial, la que se descarga desde la propia cuenta de Holded. En WordPress y en agencias encontrarás también plugins de terceros, a veces de pago, que sincronizan otras cosas o en otra dirección. Antes de instalar uno, comprueba quién lo mantiene, cuándo se actualizó por última vez y en qué sentido mueve los productos, y no tengas dos integraciones activas a la vez: duplican pedidos y stock.

¿Tu tienda está en Shopify? La conexión con Holded se hace desde la tienda de apps de Shopify y tiene sus propias reglas: lo contamos en integración Shopify y Holded.

🧩 Seis cosas de WooCommerce que conviene saber

1. Solo factura lo que está "Completado", y con esa fecha. Las facturas y los tickets solo se importan cuando el pedido pasa a Completado en WooCommerce, y la fecha del documento es la del día en que se marcó como completado, no la del pago. Un pedido pagado el 30 de septiembre y completado el 2 de octubre se factura en octubre, en el cuarto trimestre. Si en tu tienda los pedidos tardan días en pasar a Completado, o usas estados personalizados, tus ventas se desplazan de mes y de trimestre. Revísalo antes de cada cierre.

2. Los impuestos tienen que existir antes en Holded. Holded asigna a cada venta el impuesto que ya tengas creado; si no encuentra uno exacto, usa el más parecido. Por eso la ayuda recomienda crear antes los impuestos generales (21 %, 10 %, 4 %) y tener activados los impuestos en WooCommerce. Para los céntimos de diferencia por redondeo hay una opción de ajuste automático de impuestos en la configuración avanzada.

3. Si vendes a otros países de la UE, mira tu plan. A partir de 10.000 € al año en ventas a consumidores de otros países de la UE, el IVA es el del país del cliente y se declara en el modelo 369 (OSS). La integración permite impuestos distintos por país, pero según Holded solo en el plan Premium. Sin él, esas ventas entran con el impuesto que encuentre, y alguien tiene que corregirlas antes del 369. Lo explicamos en IVA OSS en ecommerce.

4. Las devoluciones: compruébalo con una de prueba. Las preguntas frecuentes de la ayuda de Holded dicen que las devoluciones se sincronizan, y que si la factura ya estaba aprobada se genera una rectificativa por el total y un documento nuevo con el cambio. La página comercial de la integración, en cambio, todavía dice que no se importan. Antes de confiar en ninguna de las dos, haz una devolución de prueba y mira qué aparece en Holded.

5. Ojo con los números de pedido repetidos. Si llega un pedido con un número que ya existe en Holded, aunque sea de otro año, Holded no crea uno nuevo: actualiza el antiguo. Pasa con plugins que reinician la numeración cada año. Si usas uno, cámbialo o añade el año al número de pedido.

6. La integración trae ventas, no cobros. Los métodos de pago de WooCommerce se enlazan con los bancos de Holded, pero Redsys, Stripe o PayPal te ingresan agrupado, días después y descontando sus comisiones. Casar cada ingreso del banco con sus ventas y registrar la comisión sigue siendo trabajo de conciliación. Cómo hacerlo, en conciliación bancaria en Holded.

⚙️ La configuración que recomendamos

🧰 Cómo lo llevamos nosotros

En Mouni somos Solution Partner de Holded, nivel Silver. Cuando un cliente vende en WooCommerce, al arrancar revisamos SKU, impuestos, series, estados de pedido y métodos de pago; después conciliamos cada semana los ingresos de las pasarelas con sus ventas y comisiones, y antes de cada trimestre comprobamos que no se queda ningún pedido fuera. Así el IVA sale con las ventas que tocan y el margen de la tienda se puede mirar con datos reales.

❓ Preguntas rápidas

¿Cómo se conecta Holded con WooCommerce? Con la integración oficial de Holded: la activas en la tienda de Holded, descargas su plugin y lo subes a WordPress, pegas en WooCommerce la primera clave de API v1 de tu cuenta y eliges en Holded qué se sincroniza. Importa los pedidos como facturas, tickets o pedidos de venta, los productos con SKU y el stock, este último en los dos sentidos si tienes el módulo de inventario.

¿Por qué no entran en Holded algunos pedidos de WooCommerce? Lo más habitual es que no estén en estado Completado: las facturas y los tickets solo se importan en ese estado. Otras causas son una clave de API que no es la primera de la lista, un cambio de nombre de la tienda, que apaga la sincronización, o pedidos anteriores a la conexión, que hay que importar aparte.

¿La integración pasa el NIF del cliente a la factura? Sí, si WooCommerce lo recoge. De serie WooCommerce no pide el NIF en el checkout, así que hace falta instalar un plugin de NIF y marcar el campo como obligatorio y validado.

¿Se pueden conectar varias tiendas WooCommerce a una misma cuenta de Holded? Sí. Se repite la instalación en cada tienda con la misma clave de API. Si comparten productos con el mismo SKU, conviene importar los productos desde una sola tienda y activar solo el stock en las demás, para no sobrescribirlos.

Pablo Gil Diéguez

Founder de Mouni y CFO externo de marcas de ecommerce, agencias y SaaS en España. Cada semana publicamos una guía sin humo sobre finanzas y fiscalidad de negocios digitales.