Guia d'ús de B2Brouter per a WooCommerce

Índex

1. Introducció
2. Requisits i Instal·lació
3. Provar el plugin en un entorn de prova
4. Configuració Inicial
5. Generació de Factures
6. Configuració d’impostos
7. Recollida de NIF/VAT
8. Configuració de Webhooks
9. Gestió de PDFs
10. Experiència del Client
11. Resolució de Problemes

---

Introducció

B2Brouter for WooCommerce és un plugin que automatitza la generació i l’enviament de factures electròniques des de la vostra botiga WooCommerce utilitzant la plataforma B2Brouter.

Principals beneficis

• Compliment Legal: Compliment automàtic amb les normatives de facturació electrònica de múltiples països.
• Estalvi de Temps: Generació automàtica de factures electròniques sense intervenció manual.
• Professionalitat: Factures estructurades en formats estàndard (UBL, CII, XML, etc.)
• Transfronterera: Suport per a transaccions B2B i B2C internacionals.
• Integració Total: Funciona perfectament amb WooCommerce sense afectar el flux de treball.

---

Requisits i instal·lació

Requisits previs

Abans d’instal·lar el plugin B2Brouter, assegureu-vos que teniu:

• 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 teniu WooCommerce instal·lat, aneu a Plugins → Afegir nou, cerqueu “WooCommerce”, instal·leu-lo i activeu-lo abans de continuar.

Instal·lació del plugin B2Brouter

Opció recomanada — des del repositori oficial de WordPress

1. A l’administrador de WordPress, aneu a Plugins → Afegir nou.
2. Cerqueu “B2Brouter for WooCommerce”.
3. Feu clic a Instal·lar ara i, tot seguit, a Activa.

Alternatives — descàrrega manual

Si preferiu instal·lar-lo manualment, podeu descarregar el fitxer ZIP des de:

• El repositori oficial de WordPress
• La pàgina de releases de GitHub

Un cop descarregat el ZIP, aneu a Plugins → Afegir nou → Pujar plugin, seleccioneu el fitxer i feu 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 veureu la nova secció Factures.

A partir d’aquí podeu procedir amb la configuració inicial.

---

Provar el plugin en un entorn de prova

⚠️ Important — no facis servir el Sandbox a la teva botiga de producció

El Sandbox de B2BRouter genera documents marcats com a “No vàlida” i els seus webhooks són completament independents dels de producció. Si configures el plugin amb una clau de sandbox (test_…) a la teva botiga WooCommerce real:

• Les comandes dels teus clients reals generarien factures sense validesa legal.
• Els canvis d’estat (factura emesa, registrada, etc.) no arribarien al teu WooCommerce, perquè els webhooks de producció i de sandbox no es comuniquen.
• Perdries la traçabilitat de la numeració i la quota.

El Sandbox està pensat exclusivament per a entorns de proves. Abans de configurar el plugin contra el teu compte real, recomanem provar-lo en un entorn de staging.

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 (incloent reverse charge intracomunitari) es calculen com esperes.
• Que el camp de NIF/VAT es recull al checkout i es propaga a la factura.
• Que els webhooks actualitzen correctament l’estat de la comanda a WooCommerce.
• Que els PDFs es generen i es poden descarregar des de “El meu compte”.
• Que els emails 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

Tens dues opcions:

Opció A — Staging del teu hosting (recomanat 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

Si el teu hosting no ofereix staging o no en 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 /staging o a un domini de proves abans d’introduir cap clau.

Pas 2: Obtén una clau API de sandbox

1. Entra a B2BRouter amb el teu compte habitual.
2. Vés a Developers → Sandboxes i obre (o crea) un sandbox.
3. Dins del sandbox, vés a API Keys i genera una clau nova. Començarà amb el prefix test_.
4. 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

Al teu WordPress de staging (no al de producció):

1. Instal·la i activa el plugin de B2BRouter com s’indica a la secció “Requisits i instal·lació”.
2. A la configuració del plugin, introdueix la clau test_… que has generat.
3. 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

🚧 El suport de webhooks en l’entorn sandbox estarà disponible properament.

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, incloent el reverse charge si fas vendes B2B intracomunitàries.
• Si el client introdueix un NIF/VAT, queda registrat a la factura.
• El webhook arriba al staging i l’estat de la comanda s’actualitza a WooCommerce.
• El PDF es descarrega correctament des de “El meu compte” (portarà la marca “No vàlida” — és normal en sandbox).
• Els emails es disparen amb els adjunts correctes.

Pas 6: Pas a producció

Quan tot funcioni al staging:

1. 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.
2. Configura els webhooks al compte de producció de B2BRouter apuntant a la URL del WP de producció.
3. No migris dades del staging a producció — les factures de proves (les marcades com “No vàlida”) han de quedar només al sandbox.
4. Fes una comanda real de prova petita per confirmar que tot el flux funciona també en producció.

---

Configuració inicial

Pas 1: Obtenir credencials de B2Brouter

1. Registreu-vos a app.b2brouter.net
2. Contracteu una subscripció a eDocExchange.
3. Aneu a Developers → API Keys al tauler de B2Brouter.
4. Copieu la clau API i guardeu-la de forma segura.

💡 Estàs configurant l’entorn de producció. Si encara no has provat el plugin, et recomanem fer-ho abans en un entorn de staging amb una clau de sandbox. Consulta la secció “Provar el plugin en un entorn de prova”.

Pas 2: Configurar el plugin

1. Accediu a la configuració:

   • A WordPress, aneu a Factures → Configuració

2. Introduïu la clau API:

   • Enganxeu la vostra clau API de B2Brouter.
   • Feu clic a Validar Clau.
   • Si la clau API és correcta, el plugin mostrarà la informació del vostre compte.

3. Configureu 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 voleu 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 preferiu que sigui l’usuari qui decideixi quan generar la factura.

Pas 3: Configurar la numeració de factures

1. 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”)

2. Patró de numeració (trieu una opció):

   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:

   • Definiu el vostre 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/1234
   • INV{year}{month}{day}-{order_id} → INV20251211-123

Pas 4: Configurar PDFs

1. Memòria cau automàtica de PDF:

   • Activeu 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.

2. Neteja automàtica:

   • Activeu la neteja programada per esborrar els PDFs que superin el nombre de dies definits en el període de retenció.
   • Configureu el període de retenció (per defecte: 90 dies).
   • La neteja s’executa diàriament via cron de WordPress.

3. 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

Generació automàtica

Si heu activat el Mode Automàtic:

1. El client completa una compra.
2. Processeu la comanda i la marqueu com a Completada.
3. 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

Si heu activat el Mode Manual i necessiteu generar una factura:

1. Aneu a WooCommerce → Comandes.
2. Obriu la comanda que voleu facturar.
3. Localitzeu el meta box B2Brouter Invoice.
4. Feu clic al botó Generar Factura.
5. En el metabox es mostrarà l’estat i els detalls principals de la factura.
6. Podeu descarregar el PDF directament des d’aquí.

Generació manual - Accions massives

Per processar múltiples comandes alhora:

1. Aneu a WooCommerce → Comandes
2. Seleccioneu les comandes completades que voleu facturar
3. Al menú desplegable d’accions massives, trieu Generar Factures B2Brouter
4. Feu clic a Aplicar
5. Veureu 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

Les notes de crèdit es generen per als reemborsaments de WooCommerce:

1. Obriu la comanda a WooCommerce → Comandes
2. A la meta box ‘Article’, feu clic a Reemborsa (la comanda ha de tenir una factura).
3. Introduïu l’import del reemborsament, pot ser total o parcial.
4. Confirmeu el reemborsament.
5. La nota de crèdit es genera automàticament format específic del país (per exemple, factures rectificatives espanyoles).

---

Configuració d’impostos

El plugin llegeix la configuració dels impostos de WooCommerce i la converteix automàticament en categories fiscals PEPPOL.

Categories fiscals PEPPOL

• S (Standard rate): Taxa estàndard - Aplicada quan existeixen taxes.
• E (Exempt from tax): Exempt de taxa - Productes taxables amb taxa del 0%.
• Z (Zero-rated goods): Béns amb taxa zero - Productes amb classe fiscal de taxa zero explícita.
• NS (Not subject to tax): No subjecte a taxa - Productes no taxables.
• AE (VAT Reverse Charge): Inversió del subjecte passiu - Detectat automàticament per a transaccions intra-UE B2B.

Configuració d’impostos a WooCommerce

1. Activar el càlcul de taxes:

   • Aneu a WooCommerce → Opcions → General.
   • A la secció Impostos i cupons, Activeu “Activa els tipus i els càlculs impositius”.

2. Configurar impostos

   • Un cop activats els impostos aneu a WooCommerce → Opcions → Impostos. Des d’aquesta secció podeu configurar les diferents tarifes d’impostos:

   • Configurar tarifes estàndard:

     • Feu clic a la pestanya Tarifes estàndard.
     • Afegiu les vostres taxes per país:
       • Codi de país
       • Percentatge de taxa
       • Nom de la taxa (IVA, VAT, etc.)
       • Si s’aplica a l’enviament

   • Configurar tarifes taxa zero:

     • Feu clic a la pestanya Taxa zero tarifes.
     • Afegiu les vostres taxes per país:
       • Codi de país
       • Nom de la taxa (IVA, VAT, etc.)
       • Si s’aplica a l’enviament

   • Configurar tarifes taxa reduida:

     • Feu clic a la pestanya Tarifes taxa reduïda.
     • Afegiu les vostres taxes per país:
       • Codi de país
       • Percentatge de taxa
       • Nom de la taxa (IVA, VAT, etc.)
       • Si s’aplica a l’enviament

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 taxes aplicades al client
• Indica que el client ha de declarar les taxes al seu país

---

Recollida de NIF/VAT

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

1. 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.

2. Emmagatzematge:

   • El NIF es guarda com a _billing_tin a la caixa de metadades de la comanda.
   • També es guarda al perfil del client per a reutilització.

3. 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

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

Els webhooks de producció i de sandbox són completament independents: cadascun té la seva pròpia configuració i els esdeveniments no es comuniquen entre entorns. Si estàs provant el plugin en staging amb una clau de sandbox, configura els webhooks dins del sandbox apuntant a la URL del staging. Quan passis a producció, hauràs de configurar-los de nou al compte de producció.

Els webhooks permeten actualitzacions d’estat de factures en temps real (< 1 segon) en lloc d’esperar la comprovació horària.

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

Pas 1: Obtenir la URL al panell d’administració del Wordpress

1. Aneu a Factures → Settings
2. Desplaceu-vos a “Configuració de Webhooks”
3. Activeu “Habilitar Webhooks”.
4. Copieu la URL del Webhook del camp de només lectura
   • S’assembla a: https://vostresitio.com/wp-json/b2brouter/v1/webhook
5. Deseu la configuració.

Pas 2: Crear l’endpoint a B2Brouter Dashboard

1. Accediu a app.b2brouter.net
2. Aneu a la pestanya Developers
3. Feu clic a Webhooks al menú principal.
4. Feu clic a “Afegir webhook”
5. Introduïu una descripció, per exemple “Botiga WooCommerce”.
6. Enganxeu la URL del Webhook copiada de WordPress.
7. Seleccioneu els esdeveniments a enviar. Recomanat: seleccionar-ho tot.
8. Deseu l’endpoint i copieu la clau de signatura del Webhook generat.

Pas 3: Finalitzar la configuració al panell d’administració del Wordpress

1. Torneu a Factures → Configuració → Configuració de Webhooks.
2. Enganxeu la clau de signatura de B2Brouter.
3. Deixeu activada l’opció “Habilitar Comprovació de Seguretat”.
4. Feu clic a “Desar Configuració”.

Verificació

Per verificar que els webhooks funcionen correctament:

1. Genereu una factura de prova.
2. L’estat hauria d’aparèixer en menys d’1 segon
3. Si hi ha problemes:
   • Verifiqueu que la URL del Webhook coincideix exactament.
   • Assegureu-vos que el Secret està enganxat correctament (sense espais extra).
   • Comproveu que el vostre lloc WordPress és accessible des d’Internet.

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

Emmagatzematge al servidor

Quan activeu “Memòria cau automàtica de PDF”:

1. Ubicació: wp-content/uploads/b2brouter-Factures/
2. Estructura:

   b2brouter-Factures/
   ├── 2025/
   │   ├── 01/
   │   │   ├── invoice-123.pdf
   │   │   └── credit-note-124.pdf
   │   └── 02/
   │       └── invoice-125.pdf

Neteja Automàtica

El plugin inclou una tasca programada per netejar PDFs antics:

1. Configuració:

   • Activeu el checkbox de “Neteja automàtica”.
   • Establiu el període de retenció (per defecte: 90 dies)

2. Funcionament:

   • S’executa diàriament via WordPress cron.
   • Elimina fitxers més antics que el període de retenció.
   • Manté l’estructura de carpetes.
   • Registra les netejades al log de WordPress.

3. Desactivació de la neteja:

   • Si desactiveu la neteja, els PDFs es mantenen indefinidament.
   • Haureu de gestionar l’espai en disc manualment.

Descàrrega manual de factures des de l’administració del Wordpress

1. Accediu a WooCommerce → Comandes i seleccioneu la comanda de la qual vulgueu descarregar la factura.
2. Des del metabox “B2Brouter Invoice” de la comanda feu clic a Descarregar PDF.
3. Si el PDF està en caché, es descarrega immediatament
4. Si no, el plugin:
   • Sol·licita el PDF a B2Brouter.
   • El guarda en caché (si està activat).
   • El descarrega al vostre navegador.

---

Experiència del Client

Descàrrega de Factures

Els clients poden accedir a les seves factures de diverses maneres:

1. 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. Feu 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. Feu clic per generar factura. Un cop la factura hagi estat generada, el botó canviarà a Descarregar factura. Feu clic per descarregar la factura.

2. Des del seu compte → Comandes → Comanda:

• Des del llistat de comandes, a la columna Accions de una comanda, feu clic a Veure a la comanda.
• A la pàgina de detalls de la comanda, trobareu:
  • Botó Descarregar Factura.
  • Botó Descarregar Nota de Crèdit (si n’hi ha).

2. Des del correu electrònic:

   • Si heu activat “Adjuntar a correus”
   • El PDF s’inclou com a adjunt al correu de confirmació

3. 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

El plugin implementa diverses mesures de seguretat:

1. Verificació de propietat: Els clients només poden accedir a les seves pròpies factures.
2. Validació d’estat: Només es poden generar factures per a comandes completades.
3. Protecció CSRF: Totes les accions utilitzen nonces de WordPress.
4. Validació de mode: La generació per part del client només funciona en mode Manual.

---

Resolució de Problemes

Problemes Comuns

1. Error de Validació de Clau API

Símptomes: Missatge “Error al validar la clau API”

Solucions:

• Verifiqueu que la clau API és correcta.
• Assegureu-vos que la vostra subscripció a eDocExchange està activa.
• Comproveu que el vostre servidor pot connectar amb B2Brouter (no bloquejat per firewall).

2. Les Factures no es Generen Automàticament

Símptomes: Les comandes es completen però no es generen factures.

Solucions:

• Verifiqueu que el mode és Automàtic a la configuració.
• Comproveu que l’estat de la comanda és Completada.
• Reviseu les notes de la comanda per veure si hi ha errors.
• Comproveu els logs de WordPress per veure errors detallats.

3. Els PDFs no s’Adjunten als Correus

Símptomes: Els correus s’envien però sense el PDF adjunt

Solucions:

• Verifiqueu que “Auto-guardar PDFs” està activat.
• Comproveu que “Adjuntar a correus” està activat.
• Assegureu-vos que la factura s’ha generat abans d’enviar el correu.
• Reviseu els logs del servidor SMTP per veure si hi ha errors en l’enviament.

4. Els Webhooks no Funcionen

Símptomes: L’estat de les factures no s’actualitza immediatament

Solucions:

• Verifiqueu que la URL del Webhook coincideix exactament.
• Comproveu que el Secret del Webhook és correcte.
• Assegureu-vos que el vostre lloc és accessible des d’Internet (els webhooks no funcionen a localhost sense tunneling).
• Reviseu els logs de WordPress per veure si arriben peticions.
• Comproveu que no hi ha errors SSL al certificat del vostre lloc.

5. Error “No s’ha pogut generar el PDF”

Símptomes: La factura es crea però el PDF no es pot descarregar

Solucions:

• Comproveu que el directori wp-content/uploads/ té permisos d’escriptura.
• Reviseu l’estat de la factura a B2Brouter (pot no estar processada encara).
• Proveu de regenerar el PDF forçadament (Shift + clic).
• Verifiqueu que l’API de B2Brouter està operativa.

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ó:

1. 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.
2. 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.
3. 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. Vegeu la secció “Provar el plugin en un entorn de prova”.

---

7. Errors d’impostos incorrectes

Símptomes: Les categories fiscals no són correctes a les factures

Solucions:

• Reviseu la configuració de taxes a WooCommerce → Configuració → Impostos
• Assegureu-vos que les classes fiscals estan configurades correctament.
• Verifiqueu que els productes tenen assignada la classe fiscal correcta.
• Per a productes no taxables, establiu “Estat de la taxa” a “Cap”.

Activar el mode de depuració

Per obtenir més informació sobre errors:

1. Afegiu aquestes línies al vostre wp-config.php:

   define( 'WP_DEBUG', true );
   define( 'WP_DEBUG_LOG', true );
   define( 'WP_DEBUG_DISPLAY', false );

2. Els errors es registraran a wp-content/debug.log

3. Cerqueu entrades que continguin “B2Brouter” per veure els errors del plugin

Obtenir ajuda

Si no podeu resoldre el problema:

1. Suport B2Brouter: Els clients d’eDocExchange tenen accés al suport premium amb:
   • Prioritat en la resolució de tiquets.
   • Atenció set dies per setmana.
2. Problemes a GitHub: github.com/B2Brouter/b2brouter-woocommerce/issues

---

Millors Pràctiques

Entorn de Prova

• Comenceu amb el sandbox — és l’entorn recomanat per a la majoria de proves i el treball de desenvolupament inicial. Utilitzeu l’entorn de staging complet només per a integracions a gran escala o proves exhaustives.
• Proveu tot el flux de facturació abans de passar a producció.
• Genereu comandes de prova amb diferents configuracions (amb/sense NIF, diversos països, etc.).

Còpies de Seguretat

• Feu còpies de seguretat regulars de la vostra base de dades de WordPress
• Incloeu el directori wp-content/uploads/b2brouter-Factures/ a les còpies
• Proveu la restauració de còpies periòdicament

Monitorització

• Reviseu regularment la pàgina B2Brouter → Factures per veure l’estat.
• Configureu notificacions per a errors de generació de factures.
• Comproveu els logs de WordPress periòdicament.

Actualitzacions

• Manteniu el plugin actualitzat a l’última versió.
• Reviseu el changelog abans d’actualitzar.
• Proveu les actualitzacions a l’entorn de staging primer.

Rendiment

• Activeu “Auto-guardar PDFs” per millorar el temps de resposta.
• Configureu la neteja automàtica per gestionar l’espai en disc.
• Utilitzeu webhooks per a actualitzacions d’estat en temps real.

---

Requisits Legals

Compliment Fiscal

El plugin ajuda amb el compliment fiscal, però:

• Responsabilitat: El comerciant és responsable del compliment fiscal.
• Configuració: Assegureu-vos que la configuració de taxes és correcta per al vostre país.
• Assessorament: Consulteu amb un assessor fiscal per a requisits específics del vostre país.

Protecció de Dades (GDPR)

El plugin processa dades personals:

• Base legal: Necessari per al compliment d’obligacions legals.
• Dades processades: Nom, adreça, NIF, informació de comanda.
• Emmagatzematge: Les dades es guarden a WordPress i s’envien a B2Brouter.
• Retenció: Configureu el període de retenció segons els vostres requisits legals.

Actualitzeu la vostra 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.

---

Conclusió

Aquest plugin proporciona una integració completa entre WooCommerce i B2Brouter per a la gestió automatitzada de factures electròniques. Seguint aquesta guia, podreu configurar i utilitzar totes les funcionalitats del plugin de manera efectiva.

Per a qualsevol pregunta o problema, no dubteu en contactar amb el suport de B2Brouter o obrir un issue al repositori de GitHub.

Gaudiu de la facturació electrònica automatitzada amb B2Brouter! 🎉