Conectar Holded con WooCommerce é o paso que transforma a túa tenda dun simple carriño nun sistema administrativo real: cada pedido pagado pasa, sen intervención manual, a converterse nunha factura correcta dentro da túa conta de Holded. Nesta guía práctica centrámonos no acto concreto da conexión —xerar a API key, instalar o plugin, mapear a facturación e emitir a primeira factura— para que deixes o proceso funcionando nunha soa tarde e sen sustos contables a fin de mes.
Conectar Holded con WooCommerce: que necesitas antes de empezar
Antes de tocar ningún axuste, convén ter o terreo preparado. A maioría das incidencias non xorden do plugin, senón de datos fiscais incompletos ou dunha API key mal xerada. Se repasas esta lista, a conexión completarase á primeira:
- Unha conta de Holded activa con permisos de administrador (os plans con facturación electrónica son os idóneos).
- WooCommerce actualizado e cos datos fiscais da túa empresa cumprimentados (NIF, enderezo e razón social).
- Ao menos unha serie de facturación definida en Holded, distinta das túas facturas manuais ou doutros канles.
- O plugin EHERO Woo Holded para facturación, que traslada cada pedido a Holded de forma automática.
- Os impostos da túa tenda (IVE xeral, reducido, recarga de equivalencia se aplica) ben configurados en WooCommerce.
Esta peza é complementaria á nosa guía xeral para integrar Holded con WooCommerce: aquí non falamos de estratexia, senón do procedemento técnico de enlace paso a paso.
Xera a API key en Holded
A API key é a credencial que autoriza a túa tenda a crear facturas no teu nome. Entra no panel oficial de Holded, abre o menú da túa conta e vai a Configuración > Desenvolvedores (segundo o plan aparece como «API» ou «Integracións»). Preme en crear unha clave nova, ponlle un nome recoñecible —por exemplo «WooCommerce tenda»— e cópiaa nun lugar seguro.
Ten en conta un detalle clave: Holded só mostra a clave completa unha vez. Se pechas a xanela sen copiala, terás que revogala e xerar outra. Gárdaa no teu xestor de contrasinais, nunca nun correo ou nunha nota compartida.
Instala o plugin EHERO Woo Holded
Sube o ZIP do plugin desde Plugins > Engadir novo > Subir plugin no teu WordPress e actívao. Verás un novo apartado de axustes onde pegarás a API key que acabas de xerar. Ao gardar, o plugin realiza unha chamada de validación contra Holded: se a credencial é correcta, recibirás unha confirmación en verde. Este é o momento no que realmente rematas de enlazar a túa tenda con Holded a nivel de credenciais.
Como conectar Holded con WooCommerce paso a paso
Coa clave validada, o resto é cuestión de decidir o comportamento. Para deixar a conexión ordenada, segue esta secuencia dentro dos axustes do plugin:
- Pega a API key e garda para verificar a conexión.
- Escolle a serie de facturación que usará a tenda (idealmente unha serie dedicada á canle online).
- Define o disparador: emitir a factura cando o pedido pase a «Procesando» ou a «Completado».
- Decide se o número de factura o asigna Holded ou se herda do pedido.
- Activa, se o precisas, o envío automático do PDF ao cliente.
Mapea a facturación: series, impostos e datos fiscais
O mapeo é a parte que marca a diferenza entre unha factura correcta e unha que a túa xestoría rexeitará. Asegúrate de que os tipos de IVE de WooCommerce coincidan cos definidos en Holded; se na tenda tes un 21 % e en Holded ese imposto non existe co mesmo valor, a factura crearase con importes descadrados. Revisa tamén o mapeo de contactos: o plugin busca o cliente por NIF ou correo e, se non o atopa, créao. Isto evita duplicados na túa base de contactos de Holded.
Para negocios suxeitos á normativa antifraude, este enlace é a base sobre a que despois montas un TPV para WooCommerce con VeriFactu. EHERO Woo Holded é compatible con VeriFactu, de modo que as facturas que xera cumpren cos requisitos de trazabilidade esixidos.
Emite a túa primeira factura de proba
Non confíes a primeira emisión a un pedido real. Crea un pedido de proba cun produto de importe baixo, márcao como pagado e observa que ocorre. Se todo está ben mapeado, en segundos aparecerá a factura en Holded coa serie, o imposto e o contacto correctos. Comproba tres cousas: que o número de serie é o previsto, que o total coincide co pedido e que o cliente se creou ou vinculou sen duplicar. Cando ese pedido de proba saia limpo, xa remataches a conexión e podes pasar a produción con tranquilidade.
Erros típicos de conexión e como resolvelos
Aínda que enlazar ambas plataformas é un proceso curto, hai tres fallos que concentran case todas as consultas de soporte. Estes son e así se resolven.
API key inválida ou sen permisos
Se ao gardar recibes un erro de credencial, revisa que non copiases espazos en branco ao principio ou ao final da clave. O segundo motivo máis habitual é unha clave con permisos limitados: algúns plans de Holded xeran claves de só lectura que non poden crear facturas. Xera unha nova con permisos de escritura e volve validar.
Erros de serie de facturación
Cando a factura non se emite e o rexistro menciona a «serie», case sempre falta seleccionar unha serie válida ou esta eliminouse en Holded. Crea unha serie exclusiva para a canle online, sepáraa da que usas para facturas manuais e volve escollela no plugin. Así evitas saltos de numeración que despois complican o peche trimestral.
| Aspecto | Facturación manual | Conexión con EHERO Woo Holded |
|---|---|---|
| Tempo por pedido | 3-5 minutos copiando datos | Automático, cero minutos |
| Risco de erro | Alto (importes, NIF, serie) | Baixo, datos herdados do pedido |
| Numeración de serie | Manual, con saltos frecuentes | Consecutiva e controlada |
| Compatibilidade VeriFactu | Depende do método | Si, integrada |
Preguntas frecuentes
Necesito coñecementos técnicos para facer esta conexión?
Non. O proceso redúcese a xerar unha API key, instalar o plugin e pegar a clave. Todo o mapeo faise desde unha pantalla de axustes, sen tocar código nin bases de datos.
O plugin sincroniza tamén o stock entre Holded e a tenda?
Non. EHERO Woo Holded céntrase na facturación: converte cada pedido nunha factura dentro de Holded. A xestión de stock é un fluxo distinto e non forma parte desta conexión.
Podo usar funcións de IA na facturación?
Calquera función asistida por IA funciona en modo BYOK, é dicir, coa túa propia clave do provedor. Ti controlas a clave e o gasto; o plugin non inclúe consumo de terceiros pola súa conta.
Que pasa se cambio a API key máis adiante?
Basta con pegar a nova clave nos axustes e gardar para que o plugin a valide de novo. Se revogas a anterior en Holded, faino xusto despois de confirmar que a nova conexión responde correctamente.
Conclusión
Conectar Holded con WooCommerce é máis rápido do que parece cando preparas a API key, defines unha serie propia e validas cun pedido de proba antes de pasar a produción. Con eses catro coidados —credencial correcta, impostos aliñados, serie dedicada e proba real— deixarás a facturación funcionando de forma desatendida e conforme a VeriFactu. Dá o paso co plugin de facturación Holded para WooCommerce de EHERO e converte cada pedido nunha factura sen volver copiar un dato a man.