Plugin de B2Brouter per a WooCommerce
Guia pas a pas per generar i enviar factures electròniques automàticament a cada comanda de WooCommerce.
B2Brouter per a WooCommerce és un plugin que genera i envia automàticament les factures electròniques de la teva botiga WooCommerce a través de B2Brouter. Cada comanda té la seva factura, en el format que demana cada país, sense que hagis de fer res.
- Compliment normatiu automàtic. Les factures compleixen la normativa de facturació electrònica de cada país.
- Sense feina manual. Les factures es generen soles a cada comanda, o quan tu decideixis.
- Formats estàndard. Factures estructurades en UBL, CII i altres formats.
- Vendes internacionals. Funciona per a vendes B2B i B2C, també fora del teu país.
- Integrat amb WooCommerce. No canvia la manera com gestiones la botiga.
Requisits
Section titled “Requisits”Abans d'instal·lar el plugin B2Brouter, assegura't que tens:
- WordPress 5.8 o superior
- WooCommerce 5.0 o superior, instal·lat i actiu
- PHP 7.4 o superior
- Un compte de B2Brouter amb subscripció eDocExchange activa
Si encara no tens WooCommerce instal·lat, vés a Plugins → Afegir nou, cerca "WooCommerce", instal·la'l i activa'l abans de continuar.
Instal·lació
Section titled “Instal·lació”Des del repositori oficial de WordPress Opció recomanada
Section titled “Des del repositori oficial de WordPress ”- A l'administrador de WordPress, vés a Plugins → Afegir nou.
- Cerca "B2Brouter for WooCommerce".
- Fes clic a Instal·lar ara i, tot seguit, a Activa.
Descàrrega manual Alternatives
Section titled “Descàrrega manual ”Si prefereixes instal·lar-lo manualment, pots descarregar el fitxer ZIP des de:
Un cop descarregat el ZIP, vés a Plugins → Afegir nou → Pujar plugin, selecciona el fitxer i fes clic a Instal·lar ara i Activa.
Un cop activat, apareixerà la pàgina de benvinguda del plugin amb les instruccions inicials. Al menú lateral veuràs la nova secció Factures.
Provar el plugin en un entorn de prova
Section titled “Provar el plugin en un entorn de prova”Abans de connectar el plugin a la teva botiga real, prova'l en una còpia de la teva web de WordPress (un staging de WordPress) connectada al sandbox de B2Brouter. Així comproves la numeració, els impostos i els PDFs sense generar factures reals. Al pas 1 t'expliquem com crear aquesta còpia.
Per què val la pena provar-ho primer
Section titled “Per què val la pena provar-ho primer”Abans de connectar el plugin a la teva botiga de producció, val la pena verificar en un entorn de proves:
- Que la numeració de factures s'aplica correctament i no entra en conflicte amb cap altra eina.
- Que els impostos (inclosa la inversió del subjecte passiu intracomunitària) es calculen com esperes.
- Que el camp de NIF/VAT es recull al checkout i es propaga a la factura.
- Que els PDFs es generen i es poden descarregar des de "El meu compte".
- Que els correus electrònics al client funcionen amb el text i els adjunts correctes.
Tot això es pot validar end-to-end al sandbox sense consumir quota, sense enviar res per Peppol i sense generar moviments comptables reals.
Pas 1: Crea un entorn de staging del teu WordPress
Section titled “Pas 1: Crea un entorn de staging del teu WordPress”Tens dues opcions:
Opció A: staging del teu hosting (recomanada si està disponible)
Section titled “Opció A: staging del teu hosting (recomanada si està disponible)”La majoria de proveïdors WordPress gestionats inclouen un sistema de staging d'un clic des del panell de control:
- SiteGround — Site Tools → Dev → WordPress Staging
- Kinsta — Sites → Create Staging Environment
- WP Engine — Add Staging Environment
- Cloudways — Application → Clone App / Create Staging
- Hostinger — Hosting → Manage → Crear staging
Comprova el panell del teu hosting abans d'instal·lar res — és la forma més neta de tenir un staging.
Opció B: plugin WP STAGING
Section titled “Opció B: plugin WP STAGING”Si el teu hosting no ofereix staging o no hi tens accés, el plugin gratuït WP STAGING (wordpress.org/plugins/wp-staging) crea un clon de la teva botiga en un subdirectori (per exemple, tevabotiga.com/staging) amb un sol clic. El clon té el seu propi login, la seva pròpia base de dades i no toca cap dada de la botiga real.
💡 No barregis mai un sandbox de B2Brouter amb una botiga de producció: confirma sempre que la URL on configures el plugin acaba a
/stagingo a un domini de proves abans d'introduir cap clau.
Pas 2: Obtén una clau API de sandbox
Section titled “Pas 2: Obtén una clau API de sandbox”- Entra a B2Brouter amb el teu compte habitual.
- Vés a Developers → Sandboxes i obre (o crea) un sandbox.
- Dins del sandbox, vés a API Keys i genera una clau nova. Començarà amb el prefix
test_. - Copia la clau — la necessitaràs al pas següent.
Per a més detalls sobre què inclou i què no el sandbox, consulta la documentació tècnica del sandbox.
Pas 3: Configura el plugin al staging
Section titled “Pas 3: Configura el plugin al staging”Al teu WordPress de staging (no al de producció):
- Instal·la i activa el plugin de B2Brouter com s'indica a les seccions "Requisits" i "Instal·lació".
- A la configuració del plugin, introdueix la clau
test_…que has generat. - Configura la resta de paràmetres (patró de numeració, impostos, PDFs, etc.) com faries en producció — pots tornar a la secció "Configuració inicial" per al detall.
Pas 4: Configura els webhooks del sandbox
Section titled “Pas 4: Configura els webhooks del sandbox”🚧 Els webhooks en l'entorn sandbox estaran disponibles properament.
Pas 5: Llista de comprovació abans de passar a producció
Section titled “Pas 5: Llista de comprovació abans de passar a producció”Fes una comanda de prova al staging i confirma:
- Es genera una factura al sandbox de B2Brouter en finalitzar la comanda.
- El número de factura segueix el patró que has configurat.
- Els impostos són correctes, inclosa la inversió del subjecte passiu si fas vendes B2B intracomunitàries.
- Si el client introdueix un NIF/VAT, queda registrat a la factura.
- El PDF es descarrega correctament des de "El meu compte" (portarà la marca "No vàlida" — és normal en sandbox).
- Els correus electrònics es disparen amb els adjunts correctes.
Pas 6: Pas a producció
Section titled “Pas 6: Pas a producció”Quan tot funcioni al staging:
- Al teu WordPress de producció, instal·la el plugin (si encara no ho has fet) i configura'l des de zero amb la clau
prod_…del teu compte real. - Configura els webhooks al compte de producció de B2Brouter apuntant a la URL del WP de producció.
- No migris dades del staging a producció — les factures de proves (les marcades com "No vàlida") han de quedar només al sandbox.
- Fes una comanda real de prova petita per confirmar que tot el flux funciona també en producció.
Configuració inicial
Section titled “Configuració inicial”Pas 1: Obtenir credencials de B2Brouter
Section titled “Pas 1: Obtenir credencials de B2Brouter”- Registra't a app.b2brouter.net.
- Contracta una subscripció a eDocExchange.
- Vés a Developers → API Keys al tauler de B2Brouter.
- Copia la clau API i guarda-la de forma segura.
Pas 2: Configurar el plugin
Section titled “Pas 2: Configurar el plugin”-
Accedeix a la configuració:
- A WordPress, vés a Factures → Configuració
-
Introdueix la clau API:
- Enganxa la teva clau API de B2Brouter.
- Fes clic a Validar Clau.
- Si la clau API és correcta, el plugin mostrarà la informació del teu compte.
-
Configura el mode de generació:
- Automàtic: el plugin genera la factura de manera automàtica quan una comanda passa a l'estat Completada. És l'opció recomanada si vols garantir que totes les comandes tinguin la seva factura associada.
- Manual: el plugin no genera la factura automàticament. La factura es pot generar manualment des de la fitxa de cada comanda i, un cop la comanda està en estat Completada, també la pot generar el client des de la pàgina del seu compte. És l'opció recomanada si prefereixes que sigui l'usuari qui decideixi quan generar la factura.
Pas 3: Configurar la numeració de factures
Section titled “Pas 3: Configurar la numeració de factures”-
Codis de sèrie:
- Codi de sèrie de factures: prefix per a factures regulars (per exemple, "FAC", "INV")
- Codi de sèrie de notes de crèdit: prefix per a notes de crèdit (per exemple, "NC", "CN")
-
Patró de numeració: hi ha quatre opcions per definir com es numeren les factures.
a) Automàtic Recomanat
- B2Brouter genera números seqüencials automàticament.
- No cal gestionar comptadors.
b) Número de comanda de WooCommerce:
- Utilitza el número de comanda natiu de WooCommerce.
- Exemple: si la comanda és #1234, la factura serà FAC-1234.
c) Seqüencial:
- El plugin manté un comptador independent.
- Genera números com FAC-00001, FAC-00002, FAC-00003.
d) Patró personalitzat:
- Defineix el teu propi format utilitzant marcadors:
{order_id}: ID de la comanda{order_number}: número de comanda de WooCommerce{year}: any actual (YYYY){month}: mes actual (MM){day}: dia actual (DD)
Exemples de patrons personalitzats:
FAC-{year}-{order_id}→ FAC-2025-123{year}/{month}/{order_number}→ 2025/12/1234INV{year}{month}{day}-{order_id}→ INV20251211-123
Pas 4: Configurar PDFs
Section titled “Pas 4: Configurar PDFs”-
Memòria cau automàtica de PDF:
- Activa aquesta opció per descarregar i guardar els PDFs al servidor, dins la carpeta
wp-content/uploads/b2brouter-Factures/. - Millora el temps de resposta per a descàrregues del client.
- Redueix les crides a l'API de B2Brouter.
- Activa aquesta opció per descarregar i guardar els PDFs al servidor, dins la carpeta
-
Neteja automàtica:
- Activa la neteja programada per esborrar els PDFs que superin el nombre de dies definits en el període de retenció.
- Configura el període de retenció (per defecte: 90 dies).
- La neteja s'executa diàriament mitjançant el cron de WordPress.
-
Adjuntar PDFs als correus:
- Adjuntar al correu de comanda completada: inclou el PDF quan s'envia el correu de confirmació.
- Adjuntar al correu de factura del client: inclou el PDF en els correus de factura de WooCommerce.
- Adjuntar al correu de reemborsament: inclou la nota de crèdit en els correus de reemborsament.
Mode de generació de factures
Section titled “Mode de generació de factures”Generació automàtica
Section titled “Generació automàtica”Si has activat el mode automàtic:
- El client completa una compra.
- Processes la comanda i la marques com a Completada.
- El plugin:
- Genera automàticament la factura a B2Brouter.
- Desa les metadades de la factura (ID, número, data).
- Afegeix una nota a la comanda.
- Genera i guarda el PDF (si està activat).
- Envia el correu amb el PDF adjunt (si està configurat).
Generació manual - comanda individual
Section titled “Generació manual - comanda individual”Si has activat el mode manual i necessites generar una factura:
- Vés a WooCommerce → Comandes.
- Obre la comanda que vols facturar.
- Localitza el meta box B2Brouter Invoice.
- Fes clic al botó Generar Factura.
- En el metabox es mostrarà l'estat i els detalls principals de la factura.
- Pots descarregar el PDF directament des d'aquí.
Generació manual - accions massives
Section titled “Generació manual - accions massives”Per processar diverses comandes alhora:
- Vés a WooCommerce → Comandes.
- Selecciona les comandes completades que vols facturar.
- Al menú desplegable d'accions massives, tria Generar Factures B2Brouter.
- Fes clic a Aplicar.
- Veuràs un missatge amb el resultat de cada comanda:
- Factures generades correctament
- Factures que ja existien
- Errors durant la generació
Generació de notes de crèdit
Section titled “Generació de notes de crèdit”Les notes de crèdit es generen per als reemborsaments de WooCommerce:
- Obre la comanda a WooCommerce → Comandes.
- A la meta box 'Article', fes clic a Reemborsa (la comanda ha de tenir una factura).
- Introdueix l'import del reemborsament, pot ser total o parcial.
- Confirma el reemborsament.
- La nota de crèdit es genera automàticament en el format específic del país (per exemple, factures rectificatives espanyoles).
Configuració d'impostos
Section titled “Configuració d'impostos”El plugin llegeix la configuració dels impostos de WooCommerce i la converteix automàticament en categories fiscals Peppol.
Categories fiscals Peppol
Section titled “Categories fiscals Peppol”- S (Standard rate): tipus estàndard, aplicat quan existeixen impostos.
- E (Exempt from tax): exempt d'impost, per a productes gravats amb un tipus del 0%.
- Z (Zero-rated goods): béns amb tipus zero, per a productes amb una classe fiscal de tipus zero explícita.
- NS (Not subject to tax): no subjecte a impost, per a productes no gravats.
- AE (VAT Reverse Charge): inversió del subjecte passiu, detectada automàticament per a transaccions intra-UE B2B.
Configuració d'impostos a WooCommerce
Section titled “Configuració d'impostos a WooCommerce”-
Activar el càlcul d'impostos:
- Vés a WooCommerce → Opcions → General.
- A la secció Impostos i cupons, activa "Activa els tipus i els càlculs impositius".
-
Configurar impostos:
-
Un cop activats els impostos, vés a WooCommerce → Opcions → Impostos. Des d'aquesta secció pots configurar les diferents tarifes d'impostos:
-
Configurar tarifes estàndard:
- Fes clic a la pestanya Tarifes estàndard.
- Afegeix els teus tipus impositius per país:
- Codi de país
- Percentatge del tipus
- Nom de l'impost (IVA, VAT, etc.)
- Si s'aplica a l'enviament
-
Configurar tarifes de tipus zero:
- Fes clic a la pestanya Tarifes de tipus zero.
- Afegeix els teus tipus impositius per país:
- Codi de país
- Nom de l'impost (IVA, VAT, etc.)
- Si s'aplica a l'enviament
-
Configurar tarifes de tipus reduït:
- Fes clic a la pestanya Tarifes de tipus reduït.
- Afegeix els teus tipus impositius per país:
- Codi de país
- Percentatge del tipus
- Nom de l'impost (IVA, VAT, etc.)
- Si s'aplica a l'enviament
-
Inversió del subjecte passiu intra-UE
Section titled “Inversió del subjecte passiu intra-UE”El plugin detecta automàticament quan s'aplica la inversió del subjecte passiu:
Condicions:
- El client proporciona un NIF vàlid
- El país del client és diferent del país del comerciant
- Ambdós països són membres de la UE (27 estats)
Què fa el plugin:
- Marca la transacció com a inversió del subjecte passiu (categoria AE)
- Genera la factura sense impostos aplicats al client
- Indica que el client ha de declarar els impostos al seu país
Recollida de NIF/VAT
Section titled “Recollida de NIF/VAT”Configuració del camp de NIF
Section titled “Configuració del camp de NIF”El plugin afegeix automàticament un camp de NIF al checkout de WooCommerce. Compatible amb:
- Checkout per blocs (WooCommerce 8.6+)
- Checkout clàssic basat en shortcodes
Com funciona
Section titled “Com funciona”-
Al checkout:
- El camp "NIF / VAT Number" apareix a la secció d'informació de contacte.
- És opcional per defecte.
- El client pot introduir el seu NIF per a factures B2B/B2C.
-
Emmagatzematge:
- El NIF es guarda com a
_billing_tina la caixa de metadades de la comanda. - També es guarda al perfil del client per a reutilització.
- El NIF es guarda com a
-
Facturació:
- Si el client proporciona un NIF, es genera una factura estàndard (IssuedInvoice)
- Si no hi ha NIF, es genera una factura simplificada (IssuedSimplifiedInvoice)
- Per a transaccions intra-UE amb NIF, s'aplica la inversió del subjecte passiu
Validació del NIF
Section titled “Validació del NIF”Actualment el plugin no valida el format del NIF. La validació es pot afegir mitjançant:
- Plugins de validació de tercers
- Validació personalitzada amb hooks de WooCommerce
- Validació a través de l'API de B2Brouter
Configuració de webhooks
Section titled “Configuració de webhooks”Per què utilitzar webhooks?
Section titled “Per què utilitzar webhooks?”- Actualitzacions instantànies: l'estat de la factura apareix immediatament a l'administració del WordPress.
- Menys càrrega: redueix les crides a l'API.
- Més fiable: amb comprovació de fallback cada hora.
Configuració pas a pas
Section titled “Configuració pas a pas”Pas 1: Obtenir la URL al panell d'administració del WordPress
Section titled “Pas 1: Obtenir la URL al panell d'administració del WordPress”- Vés a Factures → Settings.
- Desplaça't a "Configuració de Webhooks".
- Activa "Habilitar Webhooks".
- Copia la URL del webhook del camp de només lectura.
- S'assembla a:
https://tevabotiga.com/wp-json/b2brouter/v1/webhook
- S'assembla a:
- Desa la configuració.
Pas 2: Crear l'endpoint al panell de B2Brouter
Section titled “Pas 2: Crear l'endpoint al panell de B2Brouter”- Accedeix a app.b2brouter.net.
- Vés a la pestanya Developers.
- Fes clic a Webhooks al menú principal.
- Fes clic a "Afegir webhook".
- Introdueix una descripció, per exemple "Botiga WooCommerce".
- Enganxa la URL del webhook copiada de WordPress.
- Selecciona els esdeveniments a enviar. Recomanat: seleccionar-ho tot.
- Desa l'endpoint i copia la clau de signatura del webhook generat.
Pas 3: Finalitzar la configuració al panell d'administració del WordPress
Section titled “Pas 3: Finalitzar la configuració al panell d'administració del WordPress”- Torna a Factures → Configuració → Configuració de Webhooks.
- Enganxa la clau de signatura de B2Brouter.
- Deixa activada l'opció "Habilitar Comprovació de Seguretat".
- Fes clic a "Desar Configuració".
Verificació
Section titled “Verificació”Per verificar que els webhooks funcionen correctament:
- Genera una factura de prova.
- L'estat hauria d'aparèixer en menys d'1 segon.
- Si hi ha problemes:
- Verifica que la URL del webhook coincideix exactament.
- Assegura't que el Secret està enganxat correctament (sense espais extra).
- Comprova que el teu lloc WordPress és accessible des d'Internet.
Seguretat dels webhooks
Section titled “Seguretat dels webhooks”- Totes les peticions estan signades criptogràficament amb HMAC-SHA256.
- Les peticions amb signatures invàlides són rebutjades.
- Validació de timestamp de 5 minuts per prevenir atacs de repetició.
- El secret es guarda de forma segura a les opcions de WordPress.
Gestió de PDFs
Section titled “Gestió de PDFs”Emmagatzematge al servidor
Section titled “Emmagatzematge al servidor”Quan actives "Memòria cau automàtica de PDF":
- Ubicació:
wp-content/uploads/b2brouter-Factures/ - Estructura:
b2brouter-Factures/├── 2025/│ ├── 01/│ │ ├── invoice-123.pdf│ │ └── credit-note-124.pdf│ └── 02/│ └── invoice-125.pdf
Neteja automàtica
Section titled “Neteja automàtica”El plugin inclou una tasca programada per netejar PDFs antics:
-
Configuració:
- Activa el checkbox de "Neteja automàtica".
- Estableix el període de retenció (per defecte: 90 dies).
-
Funcionament:
- S'executa diàriament mitjançant el cron de WordPress.
- Elimina fitxers més antics que el període de retenció.
- Manté l'estructura de carpetes.
- Registra les netejades al log de WordPress.
-
Desactivació de la neteja:
- Si desactives la neteja, els PDFs es mantenen indefinidament.
- Hauràs de gestionar l'espai en disc manualment.
Descàrrega manual de factures des de l'administració del WordPress
Section titled “Descàrrega manual de factures des de l'administració del WordPress”- Accedeix a WooCommerce → Comandes i selecciona la comanda de la qual vulguis descarregar la factura.
- Des del metabox "B2Brouter Invoice" de la comanda fes clic a Descarregar PDF.
- Si el PDF està a la memòria cau, es descarrega immediatament.
- Si no, el plugin:
- Sol·licita el PDF a B2Brouter.
- El guarda a la memòria cau (si està activat).
- El descarrega al teu navegador.
Experiència del client
Section titled “Experiència del client”Descàrrega de factures
Section titled “Descàrrega de factures”Els clients poden accedir a les seves factures de diverses maneres:
-
Des del seu compte → Comandes:
- Es mostra el llistat de comandes.
- Si la factura ja ha estat generada, a la columna Accions del llistat de comandes, es mostrarà el botó Descarregar factura. Fes clic per descarregar la factura.
- Si la factura no ha estat generada, a la columna Accions del llistat de comandes, es mostrarà el botó Generar factura. Fes clic per generar factura. Un cop la factura hagi estat generada, el botó canviarà a Descarregar factura. Fes clic per descarregar la factura.
- Es mostra el llistat de comandes.
-
Des del seu compte → Comandes → Comanda:
- Des del llistat de comandes, a la columna Accions d'una comanda, fes clic a Veure a la comanda.
- A la pàgina de detalls de la comanda, trobaràs:
- Botó Descarregar Factura.
- Botó Descarregar Nota de Crèdit (si n'hi ha).
-
Des del correu electrònic:
- Si has activat "Adjuntar a correus"
- El PDF s'inclou com a adjunt al correu de confirmació
-
Generació per part del client (mode manual):
- Si el mode és manual, els clients poden generar factures ells mateixos
- A la pàgina de detalls de la comanda, veuran un botó Generar Factura
- Després de fer clic, la pàgina es refresca i el PDF està disponible
Seguretat
Section titled “Seguretat”El plugin implementa diverses mesures de seguretat:
- Verificació de propietat: els clients només poden accedir a les seves pròpies factures.
- Validació d'estat: només es poden generar factures per a comandes completades.
- Protecció CSRF: totes les accions utilitzen nonces de WordPress.
- Validació de mode: la generació per part del client només funciona en mode manual.
Bones pràctiques
Section titled “Bones pràctiques”Entorn de prova
Section titled “Entorn de prova”- Comença amb el sandbox i el teu staging de WordPress, tal com s'explica a «Provar el plugin en un entorn de prova».
- Prova tot el flux de facturació abans de passar a producció.
- Genera comandes de prova amb diferents configuracions (amb/sense NIF, diversos països, etc.).
Còpies de seguretat
Section titled “Còpies de seguretat”- Fes còpies de seguretat regulars de la teva base de dades de WordPress
- Inclou el directori
wp-content/uploads/b2brouter-Factures/a les còpies - Prova la restauració de còpies periòdicament
Monitorització
Section titled “Monitorització”- Revisa regularment la pàgina B2Brouter → Factures per veure l'estat.
- Configura notificacions per a errors de generació de factures.
- Comprova els logs de WordPress periòdicament.
Actualitzacions
Section titled “Actualitzacions”- Mantingues el plugin actualitzat a l'última versió.
- Revisa el changelog abans d'actualitzar.
- Prova les actualitzacions a l'entorn de staging primer.
Rendiment
Section titled “Rendiment”- Activa "Auto-guardar PDFs" per millorar el temps de resposta.
- Configura la neteja automàtica per gestionar l'espai en disc.
- Utilitza webhooks per a actualitzacions d'estat en temps real.
Requisits legals
Section titled “Requisits legals”Compliment fiscal
Section titled “Compliment fiscal”El plugin ajuda amb el compliment fiscal, però:
- Responsabilitat: el comerciant és responsable del compliment fiscal.
- Configuració: assegura't que la configuració d'impostos és correcta per al teu país.
- Assessorament: consulta un assessor fiscal per a requisits específics del teu país.
Protecció de dades (RGPD)
Section titled “Protecció de dades (RGPD)”El plugin tracta dades personals:
- Base legal: necessari per al compliment d'obligacions legals.
- Dades tractades: nom, adreça, NIF, informació de comanda.
- Emmagatzematge: les dades es guarden a WordPress i s'envien a B2Brouter.
- Retenció: configura el període de retenció segons els teus requisits legals.
Actualitza la teva política de privacitat per incloure:
- L'ús de B2Brouter per a la generació de factures.
- Les dades que s'envien a B2Brouter.
- Com els clients poden exercir els seus drets.
Problemes freqüents
Section titled “Problemes freqüents”Aquí tens els problemes més habituals en configurar i fer servir el plugin, amb la causa probable i com resoldre'ls. Si el teu cas no hi és, o vols més detall de l'error, activa abans el mode de depuració.
1. Error de validació de clau API
Section titled “1. Error de validació de clau API”Símptomes: missatge "Error al validar la clau API"
Solucions:
- Verifica que la clau API és correcta.
- Assegura't que la teva subscripció a eDocExchange està activa.
- Comprova que el teu servidor pot connectar amb B2Brouter (no bloquejat per firewall).
2. Les factures no es generen automàticament
Section titled “2. Les factures no es generen automàticament”Símptomes: les comandes es completen però no es generen factures.
Solucions:
- Verifica que el mode és Automàtic a la configuració.
- Comprova que l'estat de la comanda és Completada.
- Revisa les notes de la comanda per veure si hi ha errors.
- Comprova els logs de WordPress per veure errors detallats.
3. Els PDFs no s'adjunten als correus
Section titled “3. Els PDFs no s'adjunten als correus”Símptomes: els correus s'envien però sense el PDF adjunt
Solucions:
- Verifica que "Auto-guardar PDFs" està activat.
- Comprova que "Adjuntar a correus" està activat.
- Assegura't que la factura s'ha generat abans d'enviar el correu.
- Revisa els logs del servidor SMTP per veure si hi ha errors en l'enviament.
4. Els webhooks no funcionen
Section titled “4. Els webhooks no funcionen”Símptomes: l'estat de les factures no s'actualitza immediatament
Solucions:
- Verifica que la URL del webhook coincideix exactament.
- Comprova que el secret del webhook és correcte.
- Assegura't que el teu lloc és accessible des d'Internet (els webhooks no funcionen a localhost sense tunneling).
- Revisa els logs de WordPress per veure si arriben peticions.
- Comprova que no hi ha errors SSL al certificat del teu lloc.
5. Error "No s'ha pogut generar el PDF"
Section titled “5. Error "No s'ha pogut generar el PDF"”Símptomes: la factura es crea però el PDF no es pot descarregar
Solucions:
- Comprova que el directori
wp-content/uploads/té permisos d'escriptura. - Revisa l'estat de la factura a B2Brouter (pot no estar processada encara).
- Prova de regenerar el PDF forçadament (Shift + clic).
- Verifica que l'API de B2Brouter està operativa.
6. Els PDFs porten la marca "No vàlida" o els webhooks no arriben
Section titled “6. Els PDFs porten la marca "No vàlida" o els webhooks no arriben”Símptoma: les factures generades es descarreguen amb una marca d'aigua que diu "No vàlida", i/o l'estat de les comandes a WooCommerce no s'actualitza després de processar el pagament.
Causa més probable: estàs fent servir una clau API de sandbox (comença per test_) en lloc d'una clau de producció (comença per prod_), o bé tens els webhooks configurats al sandbox en lloc del compte real.
Solució:
- Comprova el prefix de la clau API a la configuració del plugin:
test_…→ estàs en sandbox. Els documents no tenen validesa legal i els webhooks de producció no arribaran.prod_…→ estàs en producció. És el que vols a la botiga real.
- Si has confirmat que la clau és
prod_…però els webhooks no arriben, vés al compte de producció de B2Brouter (no al sandbox) i revisa la configuració de webhooks. - Si fas servir la clau
test_…voluntàriament per provar, assegura't que ho estàs fent en un entorn de staging i no a la botiga real. Consulta la secció "Provar el plugin en un entorn de prova".
7. Categories d'impostos incorrectes
Section titled “7. Categories d'impostos incorrectes”Símptomes: les categories fiscals no són correctes a les factures
Solucions:
- Revisa la configuració d'impostos a WooCommerce → Configuració → Impostos.
- Assegura't que les classes fiscals estan configurades correctament.
- Verifica que els productes tenen assignada la classe fiscal correcta.
- Per a productes no gravats, estableix "Estat de la taxa" a "Cap".
Obtenir ajuda
Section titled “Obtenir ajuda”Si cap de les solucions de «Problemes freqüents» no et funciona, tens dues vies per demanar ajuda. Per resoldre-ho més ràpid, adjunta les entrades de debug.log relacionades amb B2Brouter i indica la versió del plugin, de WordPress i de WooCommerce.
- Suport B2Brouter: obre un tiquet de suport des del teu compte. Els clients d'eDocExchange tenen accés al suport premium, amb prioritat en la resolució de tiquets i atenció set dies a la setmana.
- Problemes a GitHub: github.com/B2Brouter/b2brouter-woocommerce/issues.