Integrar Holded con WooCommerce: qué hace y dónde falla.
La integración oficial convierte pedidos en facturas y sincroniza stock por SKU. Funciona bien en tiendas sencillas y se atasca siempre en los mismos sitios. Qué revisar antes de activarla y cuándo compensa un flujo a medida.
01 · TL;DR
Holded tiene una integración oficial con WooCommerce: un plugin que instalas en la tienda, una clave API que generas en Holded y, a partir de ahí, los pedidos entran como documentos de venta, los contactos se crean solos y los productos con SKU se sincronizan. Para una tienda con catálogo simple, pocos pedidos al día y sin devoluciones frecuentes, funciona y es gratis. Los problemas aparecen siempre en los mismos sitios: SKU que no coinciden, estados de pedido que no disparan la factura, stock que no se descuenta, packs y lotes, devoluciones y NIF de clientes empresa. Aquí va qué hace la integración, qué conviene configurar antes de activarla y cuándo merece la pena un flujo a medida por API. Está escrito desde la experiencia como partner de Holded; las funciones cambian con las actualizaciones, así que confírmalas en la documentación oficial antes de decidir.
02 · Qué hace la integración oficial
A octubre de 2026, según la documentación de Holded y lo que vemos en cuentas de clientes, la integración cubre cuatro cosas:
- Pedidos a documentos de venta. Cada pedido de WooCommerce se convierte en el documento que elijas: factura, ticket de venta o pedido de venta. Por defecto se crean como borrador, y alguien tiene que aprobarlos.
- Contactos. Si activas la creación de contactos, el cliente se da de alta en Holded con nombre, email, dirección y teléfono. El NIF no viene de serie en WooCommerce: necesitas un plugin que añada ese campo al checkout.
- Productos. Se sincronizan de WooCommerce hacia Holded, en un solo sentido, y solo productos simples y con variantes. Cada producto y cada variante necesita un SKU.
- Stock. Puede ser bidireccional si tienes contratado el complemento de Inventario de Holded y los SKU coinciden en las dos plataformas. Sin eso, como mucho se descuenta en Holded al entrar el pedido.
Qué plan y qué complementos necesitas para cada cosa lo tienes en precios y planes de Holded. Holded ofrece integraciones parecidas con PrestaShop y Shopify; la lógica es la misma (SKU como clave, pedidos a documentos), con matices propios de cada plataforma.
03 · Dónde falla en la práctica
Los problemas que más vemos al revisar tiendas conectadas no son errores del plugin, sino de configuración o de casos que la integración no contempla:
| Síntoma | Causa habitual | Qué hacer |
|---|---|---|
| El stock no baja al entrar un pedido | SKU distinto entre tienda y Holded, o producto sin SKU | Auditoría de SKU antes de activar. En Holded, un documento con el artículo vinculado muestra el icono de caja |
| Pedidos que no llegan | Estados de pedido personalizados (por ejemplo, de una pasarela o un plugin de envíos) que no están en la configuración | Listar todos los estados que usa la tienda y decidir cuáles se importan y cuáles como pagados |
| Factura en una fecha que no toca | La factura se genera al cambiar a un estado concreto, no al cobrar | Decidir con tu asesoría en qué momento se factura y configurar el estado que lo dispara |
| Packs y lotes descuadrados | La integración solo trata productos simples y con variantes | Desactivar la sincronización de stock de esos productos o resolverlos con un flujo propio |
| Devoluciones sin rectificativa | Holded documenta en PrestaShop que los reembolsos no se sincronizan solos; en WooCommerce compruébalo en tu cuenta | Procedimiento para crear la rectificativa, o automatizarla a partir del reembolso |
| Factura a empresa sin NIF | El checkout no pide NIF o es opcional | Campo NIF en el checkout con validación de formato, obligatorio si el cliente pide factura |
Un detalle que pasa desapercibido: los impuestos de los pedidos importados se ajustan a los que tengas creados en Holded, y si no existe el exacto se aplica el más cercano. Si vendes con tipos reducidos o fuera de España, crea los impuestos en Holded antes de importar nada.
04 · Cómo dejarla bien configurada
Antes de conectar una tienda en producción, este es el orden que seguimos:
- Inventario de SKU. Exporta el catálogo de WooCommerce y el de Holded, y cruza por SKU. Productos sin SKU, duplicados o con espacios sobrantes se corrigen ahora, no después de 300 pedidos.
- Impuestos. Todos los tipos que usa la tienda (21 %, 10 %, 4 %, exento, ventas a otros países) creados en Holded.
- Mapa de estados. Una tabla con cada estado de pedido de la tienda y qué debe pasar en Holded: nada, documento pendiente o documento pagado.
- Tipo de documento. Ticket para consumidor final y factura para quien la pide con NIF es lo habitual. Lo que elijas, que lo valide tu asesoría.
- Borradores sí o no. Dejarlos en borrador da control, pero alguien tiene que aprobarlos cada día. Si nadie lo hace, la contabilidad va con retraso y los tickets se acumulan.
- Prueba con pedidos reales. Diez pedidos de prueba que cubran los casos raros: variante, cupón, envío gratis, cliente con NIF, reembolso parcial. Revisa en Holded documento, impuestos y stock de cada uno.
Con ese trabajo previo, una tienda pequeña queda funcionando en una o dos jornadas. Sin él, lo normal es descubrir los descuadres al cerrar el trimestre.
05 · WooCommerce, Holded y Verifactu
Verifactu será obligatorio desde el 1 de enero de 2027 para sociedades y desde el 1 de julio de 2027 para autónomos (RD-ley 15/2025); en 2026 es voluntario. Para una tienda online conectada a Holded esto tiene tres consecuencias prácticas:
- La factura se emite en Holded, no en la tienda. Si WooCommerce genera además sus propios PDF de factura con otro plugin, tendrás dos numeraciones y una de ellas fuera del sistema. Elige una sola fuente de facturas, y que sea el programa adaptado.
- El borrador no es una factura emitida. Lo que cuenta es el documento aprobado. Si dejas borradores sin aprobar días, la fecha de emisión real se separa de la venta.
- Los errores se corrigen con rectificativa. Con Verifactu no se borra ni se edita una factura emitida. Por eso importa tanto que el NIF, los impuestos y el estado que dispara la factura estén bien antes de empezar.
Cómo cumple Holded y qué tienes que activar lo explicamos en Holded y Verifactu, y el paso a paso de emisión en cómo facturar con Holded.
06 · Cuándo compensa un flujo a medida por API
La integración oficial es la opción correcta mientras la tienda sea sencilla. Pasamos a un flujo propio sobre la API de Holded y la de WooCommerce cuando se da alguno de estos casos:
- Varios canales. WooCommerce más Amazon, un marketplace o venta B2B por pedido, todo contra el mismo stock.
- Packs, kits o fabricación. Un pedido que debe descontar componentes, no el producto vendido.
- Devoluciones frecuentes. Moda, calzado o electrónica, donde la rectificativa manual se come horas cada semana.
- Cobros por varias pasarelas que hay que cuadrar con el banco. Ahí la integración se extiende a la conciliación bancaria automática.
- Reglas propias de facturación. Clientes B2B con condiciones, facturas agrupadas por mes o series distintas por canal.
Un flujo así lee los pedidos, aplica vuestras reglas, crea el documento en Holded, mueve stock y deja lo que no cuadra en una bandeja de revisión en vez de fallar en silencio. La API tiene sus trampas (fechas en segundos, paginación, sin entorno de pruebas), documentadas en la guía de la API de Holded. Como orientación a octubre de 2026, una integración a medida de una tienda con Holded cuesta entre 1.500 y 4.000 euros de implantación más mantenimiento mensual, según canales y excepciones. Es un rango de nuestros proyectos, no una tarifa cerrada.
07 · Cómo decidir
Si tienes un solo canal, productos simples con SKU limpio y pocas devoluciones, instala la integración oficial, dedica una jornada a configurarla bien y revisa los primeros 50 pedidos uno a uno. Si vendes por varios canales, tienes packs o devoluciones a diario, o ya estás cuadrando stock a mano cada semana, la integración oficial te va a costar más horas de las que ahorra y conviene un flujo a medida. Si quieres, revisamos vuestra tienda y vuestra cuenta de Holded y te decimos cuál de los dos caminos encaja y qué hay que corregir antes. Habla con un partner de Holded →
08 · Preguntas frecuentes
¿Holded se integra con WooCommerce?
Sí. Holded tiene una integración oficial mediante un plugin para WooCommerce y una clave API generada en Holded. Importa pedidos como factura, ticket o pedido de venta, crea contactos y sincroniza productos simples y con variantes que tengan SKU.
¿La sincronización de stock entre Holded y WooCommerce es bidireccional?
Puede serlo si tienes contratado el complemento de Inventario de Holded y los SKU coinciden en las dos plataformas. Si un producto no tiene SKU o no coincide, el stock no se descuenta. Packs y lotes no se sincronizan bien y conviene tratarlos aparte.
¿Por qué no se crea la factura en Holded al entrar un pedido de WooCommerce?
Lo habitual es que el pedido esté en un estado de WooCommerce que no está configurado en la integración, por ejemplo un estado personalizado de una pasarela o un plugin de envíos. También puede que se haya creado como borrador y nadie lo haya aprobado.
¿Cuándo compensa una integración a medida en vez del plugin oficial?
Cuando vendes por varios canales contra el mismo stock, tienes packs o kits, devoluciones frecuentes, varias pasarelas de cobro o reglas propias de facturación. Como orientación a octubre de 2026, cuesta entre 1.500 y 4.000 euros de implantación más mantenimiento mensual.
¿Tienes la tienda conectada a Holded y el stock o las facturas no cuadran? Revisamos la configuración y te decimos si basta con ajustarla o compensa un flujo a medida. Solicitar diagnóstico →