Conectar Holded con WooCommerce es el paso que transforma tu tienda de un simple carrito en un sistema administrativo real: cada pedido pagado pasa, sin intervención manual, a convertirse en una factura correcta dentro de tu cuenta de Holded. En esta guía práctica nos centramos en el acto concreto de la conexión —generar la API key, instalar el plugin, mapear la facturación y emitir la primera factura— para que dejes el proceso funcionando en una sola tarde y sin sustos contables a fin de mes.
Conectar Holded con WooCommerce: qué necesitas antes de empezar
Antes de tocar ningún ajuste, conviene tener el terreno preparado. La mayoría de incidencias no surgen del plugin, sino de datos fiscales incompletos o de una API key mal generada. Si repasas esta lista, la conexión se completará a la primera:
- Una cuenta de Holded activa con permisos de administrador (los planes con facturación electrónica son los idóneos).
- WooCommerce actualizado y con los datos fiscales de tu empresa cumplimentados (NIF, dirección y razón social).
- Al menos una serie de facturación definida en Holded, distinta de tus facturas manuales o de otros canales.
- El plugin EHERO Woo Holded para facturación, que traslada cada pedido a Holded de forma automática.
- Los impuestos de tu tienda (IVA general, reducido, recargo de equivalencia si aplica) bien configurados en WooCommerce.
Esta pieza es complementaria a nuestra guía general para integrar Holded con WooCommerce: aquí no hablamos de estrategia, sino del procedimiento técnico de enlace paso a paso.
Genera la API key en Holded
La API key es la credencial que autoriza a tu tienda a crear facturas en tu nombre. Entra en el panel oficial de Holded, abre el menú de tu cuenta y ve a Configuración > Desarrolladores (según el plan aparece como «API» o «Integraciones»). Pulsa en crear una clave nueva, ponle un nombre reconocible —por ejemplo «WooCommerce tienda»— y cópiala en un lugar seguro.
Ten en cuenta un detalle clave: Holded solo muestra la clave completa una vez. Si cierras la ventana sin copiarla, tendrás que revocarla y generar otra. Guárdala en tu gestor de contraseñas, nunca en un correo o en una nota compartida.
Instala el plugin EHERO Woo Holded
Sube el ZIP del plugin desde Plugins > Añadir nuevo > Subir plugin en tu WordPress y actívalo. Verás un nuevo apartado de ajustes donde pegarás la API key que acabas de generar. Al guardar, el plugin realiza una llamada de validación contra Holded: si la credencial es correcta, recibirás una confirmación en verde. Este es el momento en el que realmente terminas de enlazar tu tienda con Holded a nivel de credenciales.
Cómo conectar Holded con WooCommerce paso a paso
Con la clave validada, el resto es cuestión de decidir el comportamiento. Para dejar la conexión ordenada, sigue esta secuencia dentro de los ajustes del plugin:
- Pega la API key y guarda para verificar la conexión.
- Elige la serie de facturación que usará la tienda (idealmente una serie dedicada al canal online).
- Define el disparador: emitir la factura cuando el pedido pase a «Procesando» o a «Completado».
- Decide si el número de factura lo asigna Holded o se hereda del pedido.
- Activa, si lo necesitas, el envío automático del PDF al cliente.
Mapea la facturación: series, impuestos y datos fiscales
El mapeo es la parte que marca la diferencia entre una factura correcta y una que tu gestoría rechazará. Asegúrate de que los tipos de IVA de WooCommerce coincidan con los definidos en Holded; si en la tienda tienes un 21 % y en Holded ese impuesto no existe con el mismo valor, la factura se creará con importes descuadrados. Revisa también el mapeo de contactos: el plugin busca al cliente por NIF o correo y, si no lo encuentra, lo crea. Esto evita duplicados en tu base de contactos de Holded.
Para negocios sujetos a la normativa antifraude, este enlace es la base sobre la que después montas un TPV para WooCommerce con VeriFactu. EHERO Woo Holded es compatible con VeriFactu, de modo que las facturas que genera cumplen con los requisitos de trazabilidad exigidos.
Emite tu primera factura de prueba
No confíes la primera emisión a un pedido real. Crea un pedido de prueba con un producto de importe bajo, márcalo como pagado y observa qué ocurre. Si todo está bien mapeado, en segundos aparecerá la factura en Holded con la serie, el impuesto y el contacto correctos. Comprueba tres cosas: que el número de serie es el previsto, que el total coincide con el pedido y que el cliente se ha creado o vinculado sin duplicar. Cuando ese pedido de prueba salga limpio, ya has terminado la conexión y puedes pasar a producción con tranquilidad.
Errores típicos de conexión y cómo resolverlos
Aunque enlazar ambas plataformas es un proceso corto, hay tres fallos que concentran casi todas las consultas de soporte. Estos son y así se resuelven.
API key inválida o sin permisos
Si al guardar recibes un error de credencial, revisa que no hayas copiado espacios en blanco al principio o al final de la clave. El segundo motivo más habitual es una clave con permisos limitados: algunos planes de Holded generan claves de solo lectura que no pueden crear facturas. Genera una nueva con permisos de escritura y vuelve a validar.
Errores de serie de facturación
Cuando la factura no se emite y el registro menciona la «serie», casi siempre falta seleccionar una serie válida o esta se ha eliminado en Holded. Crea una serie exclusiva para el canal online, sepárala de la que usas para facturas manuales y vuelve a elegirla en el plugin. Así evitas saltos de numeración que después complican el cierre trimestral.
| Aspecto | Facturación manual | Conexión con EHERO Woo Holded |
|---|---|---|
| Tiempo por pedido | 3-5 minutos copiando datos | Automático, cero minutos |
| Riesgo de error | Alto (importes, NIF, serie) | Bajo, datos heredados del pedido |
| Numeración de serie | Manual, con saltos frecuentes | Consecutiva y controlada |
| Compatibilidad VeriFactu | Depende del método | Sí, integrada |
Preguntas frecuentes
¿Necesito conocimientos técnicos para hacer esta conexión?
No. El proceso se reduce a generar una API key, instalar el plugin y pegar la clave. Todo el mapeo se hace desde una pantalla de ajustes, sin tocar código ni bases de datos.
¿El plugin sincroniza también el stock entre Holded y la tienda?
No. EHERO Woo Holded se centra en la facturación: convierte cada pedido en una factura dentro de Holded. La gestión de stock es un flujo distinto y no forma parte de esta conexión.
¿Puedo usar funciones de IA en la facturación?
Cualquier función asistida por IA funciona en modo BYOK, es decir, con tu propia clave del proveedor. Tú controlas la clave y el gasto; el plugin no incluye consumo de terceros por su cuenta.
¿Qué pasa si cambio la API key más adelante?
Basta con pegar la nueva clave en los ajustes y guardar para que el plugin la valide de nuevo. Si revocas la anterior en Holded, hazlo justo después de confirmar que la nueva conexión responde correctamente.
Conclusión
Conectar Holded con WooCommerce es más rápido de lo que parece cuando preparas la API key, defines una serie propia y validas con un pedido de prueba antes de pasar a producción. Con esos cuatro cuidados —credencial correcta, impuestos alineados, serie dedicada y prueba real— dejarás la facturación funcionando de forma desatendida y conforme a VeriFactu. Da el paso con el plugin de facturación Holded para WooCommerce de EHERO y convierte cada pedido en una factura sin volver a copiar un dato a mano.