Connectar Holded amb WooCommerce és el pas que transforma la teva botiga d’un simple carret en un sistema administratiu real: cada comanda pagada passa, sense intervenció manual, a convertir-se en una factura correcta dins del teu compte de Holded. En aquesta guia pràctica ens centrem en l’acte concret de la connexió —generar la API key, instal·lar el plugin, mapar la facturació i emetre la primera factura— perquè deixis el procés funcionant en una sola tarda i sense ensurts comptables a final de mes.
Connectar Holded amb WooCommerce: què necessites abans de començar
Abans de tocar cap ajust, convé tenir el terreny preparat. La majoria d’incidències no sorgeixen del plugin, sinó de dades fiscals incompletes o d’una API key mal generada. Si repasses aquesta llista, la connexió es completarà a la primera:
- Un compte de Holded actiu amb permisos d’administrador (els plans amb facturació electrònica són els idonis).
- WooCommerce actualitzat i amb les dades fiscals de la teva empresa emplenades (NIF, adreça i raó social).
- Almenys una sèrie de facturació definida a Holded, diferent de les teves factures manuals o d’altres canals.
- El plugin EHERO Woo Holded per a facturació, que trasllada cada comanda a Holded de manera automàtica.
- Els impostos de la teva botiga (IVA general, reduït, recàrrec d’equivalència si escau) ben configurats a WooCommerce.
Aquesta peça és complementària a la nostra guia general per integrar Holded amb WooCommerce: aquí no parlem d’estratègia, sinó del procediment tècnic d’enllaç pas a pas.
Genera la API key a Holded
La API key és la credencial que autoritza la teva botiga a crear factures en nom teu. Entra al panell oficial de Holded, obre el menú del teu compte i ves a Configuració > Desenvolupadors (segons el pla apareix com a «API» o «Integracions»). Prem per crear una clau nova, posa-li un nom reconeixible —per exemple «WooCommerce botiga»— i copia-la en un lloc segur.
Tingues en compte un detall clau: Holded només mostra la clau completa una vegada. Si tanques la finestra sense copiar-la, hauràs de revocar-la i generar-ne una altra. Desa-la al teu gestor de contrasenyes, mai en un correu o en una nota compartida.
Instal·la el plugin EHERO Woo Holded
Puja el ZIP del plugin des de Plugins > Afegeix nou > Penja plugin al teu WordPress i activa’l. Veuràs un nou apartat d’ajustos on enganxaràs la API key que acabes de generar. En desar, el plugin fa una crida de validació contra Holded: si la credencial és correcta, rebràs una confirmació en verd. Aquest és el moment en què realment acabes d’enllaçar la teva botiga amb Holded a nivell de credencials.
Com connectar Holded amb WooCommerce pas a pas
Amb la clau validada, la resta és qüestió de decidir el comportament. Per deixar la connexió ordenada, segueix aquesta seqüència dins dels ajustos del plugin:
- Enganxa la API key i desa per verificar la connexió.
- Tria la sèrie de facturació que farà servir la botiga (idealment una sèrie dedicada al canal en línia).
- Defineix el disparador: emetre la factura quan la comanda passi a «Processant» o a «Completada».
- Decideix si el número de factura l’assigna Holded o s’hereta de la comanda.
- Activa, si ho necessites, l’enviament automàtic del PDF al client.
Mapa la facturació: sèries, impostos i dades fiscals
El mapatge és la part que marca la diferència entre una factura correcta i una que la teva gestoria rebutjarà. Assegura’t que els tipus d’IVA de WooCommerce coincideixin amb els definits a Holded; si a la botiga tens un 21 % i a Holded aquest impost no existeix amb el mateix valor, la factura es crearà amb imports desquadrats. Revisa també el mapatge de contactes: el plugin busca el client per NIF o correu i, si no el troba, el crea. Això evita duplicats a la teva base de contactes de Holded.
Per a negocis subjectes a la normativa antifrau, aquest enllaç és la base sobre la qual després munts un TPV per a WooCommerce amb VeriFactu. EHERO Woo Holded és compatible amb VeriFactu, de manera que les factures que genera compleixen amb els requisits de traçabilitat exigits.
Emet la teva primera factura de prova
No confiïs la primera emissió a una comanda real. Crea una comanda de prova amb un producte d’import baix, marca-la com a pagada i observa què passa. Si tot està ben mapat, en segons apareixerà la factura a Holded amb la sèrie, l’impost i el contacte correctes. Comprova tres coses: que el número de sèrie és el previst, que el total coincideix amb la comanda i que el client s’ha creat o vinculat sense duplicar. Quan aquesta comanda de prova surti neta, ja has acabat la connexió i pots passar a producció amb tranquil·litat.
Errors típics de connexió i com resoldre’ls
Tot i que enllaçar ambdues plataformes és un procés curt, hi ha tres errors que concentren gairebé totes les consultes de suport. Aquests són i així es resolen.
API key invàlida o sense permisos
Si en desar reps un error de credencial, revisa que no hagis copiat espais en blanc al principi o al final de la clau. El segon motiu més habitual és una clau amb permisos limitats: alguns plans de Holded generen claus de només lectura que no poden crear factures. Genera’n una de nova amb permisos d’escriptura i torna a validar.
Errors de sèrie de facturació
Quan la factura no s’emet i el registre esmenta la «sèrie», gairebé sempre falta seleccionar una sèrie vàlida o aquesta s’ha eliminat a Holded. Crea una sèrie exclusiva per al canal en línia, separa-la de la que fas servir per a factures manuals i torna-la a triar al plugin. Així evites salts de numeració que després compliquen el tancament trimestral.
| Aspecte | Facturació manual | Connexió amb EHERO Woo Holded |
|---|---|---|
| Temps per comanda | 3-5 minuts copiant dades | Automàtic, zero minuts |
| Risc d’error | Alt (imports, NIF, sèrie) | Baix, dades heretades de la comanda |
| Numeració de sèrie | Manual, amb salts freqüents | Consecutiva i controlada |
| Compatibilitat VeriFactu | Depèn del mètode | Sí, integrada |
Preguntes freqüents
Necessito coneixements tècnics per fer aquesta connexió?
No. El procés es redueix a generar una API key, instal·lar el plugin i enganxar la clau. Tot el mapatge es fa des d’una pantalla d’ajustos, sense tocar codi ni bases de dades.
El plugin sincronitza també l’estoc entre Holded i la botiga?
No. EHERO Woo Holded se centra en la facturació: converteix cada comanda en una factura dins de Holded. La gestió d’estoc és un flux diferent i no forma part d’aquesta connexió.
Puc fer servir funcions d’IA en la facturació?
Qualsevol funció assistida per IA funciona en mode BYOK, és a dir, amb la teva pròpia clau del proveïdor. Tu controles la clau i la despesa; el plugin no inclou consum de tercers pel seu compte.
Què passa si canvio la API key més endavant?
N’hi ha prou amb enganxar la nova clau als ajustos i desar perquè el plugin la validi de nou. Si revoques l’anterior a Holded, fes-ho just després de confirmar que la nova connexió respon correctament.
Conclusió
Connectar Holded amb WooCommerce és més ràpid del que sembla quan prepares la API key, defineixes una sèrie pròpia i valides amb una comanda de prova abans de passar a producció. Amb aquestes quatre cures —credencial correcta, impostos alineats, sèrie dedicada i prova real— deixaràs la facturació funcionant de manera desatesa i conforme a VeriFactu. Fes el pas amb el plugin de facturació Holded per a WooCommerce d’EHERO i converteix cada comanda en una factura sense tornar a copiar cap dada a mà.