Plugin de B2Brouter para WooCommerce

B2Brouter para WooCommerce es un plugin que genera y envía automáticamente las facturas electrónicas de tu tienda WooCommerce a través de B2Brouter. Cada pedido tiene su factura, en el formato que pide cada país, sin que tengas que hacer nada.

• Cumplimiento normativo automático. Las facturas cumplen la normativa de facturación electrónica de cada país.
• Sin trabajo manual. Las facturas se generan solas en cada pedido, o cuando tú decidas.
• Formatos estándar. Facturas estructuradas en UBL, CII y otros formatos.
• Ventas internacionales. Funciona para ventas B2B y B2C, también fuera de tu país.
• Integrado con WooCommerce. No cambia la forma en que gestionas tu tienda.

B2Brouter para WooCommerce WordPress Plugin gratuito en el repositorio oficial de WordPress.

---

Requisitos

Antes de instalar el plugin B2Brouter, asegúrate de tener:

• WordPress 5.8 o superior
• WooCommerce 5.0 o superior, instalado y activo
• PHP 7.4 o superior
• Una cuenta de B2Brouter con suscripción eDocExchange activa

Si todavía no tienes WooCommerce instalado, ve a Plugins → Añadir nuevo, busca "WooCommerce", instálalo y actívalo antes de continuar.

---

Instalación

Desde el repositorio oficial de WordPress Opción recomendada

1. En el administrador de WordPress, ve a Plugins → Añadir nuevo.
2. Busca "B2Brouter for WooCommerce".
3. Haz clic en Instalar ahora y después en Activar.

Descarga manual Alternativas

Si prefieres instalarlo manualmente, puedes descargar el archivo ZIP desde:

• El repositorio oficial de WordPress
• La página de releases de GitHub

Una vez descargado el ZIP, ve a Plugins → Añadir nuevo → Subir plugin, selecciona el archivo y haz clic en Instalar ahora y Activar.

Una vez activado, aparecerá la página de bienvenida del plugin con las instrucciones iniciales. En el menú lateral verás la nueva sección Facturas.

---

Probar el plugin en un entorno de prueba

Antes de conectar el plugin a tu tienda real, pruébalo en una copia de tu web de WordPress (un staging de WordPress) conectada al sandbox de B2Brouter. Así compruebas la numeración, los impuestos y los PDFs sin generar facturas reales. En el paso 1 te explicamos cómo crear esta copia.

Importante: no uses el sandbox en tu tienda de producción

El sandbox de B2Brouter genera documentos marcados como "No válida". Si configuras el plugin con una clave de sandbox (test_…) en tu tienda WooCommerce real:

• Los pedidos de tus clientes reales generarían facturas sin validez legal.
• Los cambios de estado (factura emitida, registrada, etc.) no llegarían a tu WooCommerce, porque los webhooks de producción y de sandbox no se comunican.
• Perderías la trazabilidad de la numeración y la cuota.

El sandbox está pensado exclusivamente para entornos de prueba. Antes de configurar el plugin contra tu cuenta real, recomendamos probarlo en un entorno de staging.

Por qué vale la pena probarlo primero

Antes de conectar el plugin a tu tienda de producción, vale la pena verificar en un entorno de pruebas:

• Que la numeración de facturas se aplica correctamente y no entra en conflicto con ninguna otra herramienta.
• Que los impuestos (incluyendo la inversión del sujeto pasivo intracomunitaria) se calculan como esperas.
• Que el campo de NIF/VAT se recoge en el checkout y se propaga a la factura.
• Que los PDFs se generan y se pueden descargar desde "Mi cuenta".
• Que los correos al cliente funcionan con el texto y los adjuntos correctos.

Todo esto se puede validar end-to-end en el sandbox sin consumir cuota, sin enviar nada por Peppol y sin generar movimientos contables reales.

Paso 1: Crea un entorno de staging de tu WordPress

Tienes dos opciones:

Opción A: staging de tu hosting (recomendado si está disponible)

La mayoría de proveedores WordPress gestionados incluyen un sistema de staging de un clic desde el panel 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

Comprueba el panel de tu hosting antes de instalar nada: es la forma más limpia de tener un staging.

Opción B: plugin WP STAGING

Si tu hosting no ofrece staging o no tienes acceso a él, el plugin gratuito WP STAGING (wordpress.org/plugins/wp-staging) crea un clon de tu tienda en un subdirectorio (por ejemplo, tutienda.com/staging) con un solo clic. El clon tiene su propio login, su propia base de datos y no toca ningún dato de la tienda real.

💡 Nunca mezcles un sandbox de B2Brouter con una tienda de producción: confirma siempre que la URL donde configuras el plugin termina en /staging o en un dominio de pruebas antes de introducir ninguna clave.

Paso 2: Obtén una clave API de sandbox

1. Entra en B2Brouter con tu cuenta habitual.
2. Ve a Developers → Sandboxes y abre (o crea) un sandbox.
3. Dentro del sandbox, ve a API Keys y genera una clave nueva. Empezará con el prefijo test_.
4. Copia la clave: la necesitarás en el paso siguiente.

Para más detalles sobre qué incluye y qué no incluye el sandbox, consulta la documentación técnica del sandbox.

Paso 3: Configura el plugin en el staging

En tu WordPress de staging (no en el de producción):

1. Instala y activa el plugin de B2Brouter como se indica en las secciones "Requisitos" e "Instalación".
2. En la configuración del plugin, introduce la clave test_… que has generado.
3. Configura el resto de parámetros (patrón de numeración, impuestos, PDFs, etc.) como lo harías en producción; puedes volver a la sección "Configuración inicial" para el detalle.

Paso 4: Configura los webhooks del sandbox

🚧 Los webhooks en el entorno sandbox estarán disponibles próximamente.

Paso 5: Lista de comprobación antes de pasar a producción

Haz un pedido de prueba en el staging y confirma:

• Se genera una factura en el sandbox de B2Brouter al finalizar el pedido.
• El número de factura sigue el patrón que has configurado.
• Los impuestos son correctos, incluyendo la inversión del sujeto pasivo si haces ventas B2B intracomunitarias.
• Si el cliente introduce un NIF/VAT, queda registrado en la factura.
• El PDF se descarga correctamente desde "Mi cuenta" (llevará la marca "No válida"; es normal en sandbox).
• Los correos se envían con los adjuntos correctos.

Paso 6: Paso a producción

Cuando todo funcione en el staging:

1. En tu WordPress de producción, instala el plugin (si aún no lo has hecho) y configúralo desde cero con la clave prod_… de tu cuenta real.
2. Configura los webhooks en la cuenta de producción de B2Brouter apuntando a la URL del WordPress de producción.
3. No migres datos del staging a producción: las facturas de prueba (las marcadas como "No válida") deben quedarse solo en el sandbox.
4. Haz un pedido real de prueba pequeño para confirmar que todo el flujo también funciona en producción.

---

Configuración inicial

Paso 1: Obtener credenciales de B2Brouter

1. Regístrate en app.b2brouter.net.
2. Contrata una suscripción a eDocExchange.
3. Ve a Developers → API Keys en el panel de B2Brouter.
4. Copia la clave API y guárdala de forma segura.

Estás configurando el entorno de producción

Si todavía no has probado el plugin, te recomendamos hacerlo antes en un entorno de staging con una clave de sandbox. Consulta la sección "Probar el plugin en un entorno de prueba".

Paso 2: Configurar el plugin

1. Accede a la configuración:

   • En WordPress, ve a Facturas → Configuración.

2. Introduce la clave API:

   • Pega tu clave API de B2Brouter.
   • Haz clic en Validar Clave.
   • Si la clave API es correcta, el plugin mostrará la información de tu cuenta.

3. Configura el modo de generación:

   • Automático: el plugin genera la factura de forma automática cuando un pedido pasa al estado Completado. Es la opción recomendada si quieres garantizar que todos los pedidos tengan su factura asociada.
   • Manual: el plugin no genera la factura automáticamente. La factura se puede generar manualmente desde la ficha de cada pedido y, una vez el pedido está en estado Completado, también la puede generar el cliente desde la página «Mi cuenta». Es la opción recomendada si prefieres que sea el usuario quien decida cuándo generar la factura.

Paso 3: Configurar la numeración de facturas

1. Códigos de serie:

   • Código de serie de facturas: prefijo para facturas ordinarias (por ejemplo, "FAC", "INV")
   • Código de serie de notas de crédito: prefijo para notas de crédito (por ejemplo, "NC", "CN")

2. Patrón de numeración: hay cuatro opciones para definir cómo se numeran las facturas.

   a) Automático Recomendado

   • B2Brouter genera números secuenciales automáticamente.
   • No es necesario gestionar contadores.

   b) Número de pedido de WooCommerce:

   • Utiliza el número de pedido nativo de WooCommerce.
   • Ejemplo: si el pedido es #1234, la factura será FAC-1234.

   c) Secuencial:

   • El plugin mantiene un contador independiente.
   • Genera números como FAC-00001, FAC-00002, FAC-00003.

   d) Patrón personalizado:

   • Define tu propio formato utilizando marcadores:
     • {order_id}: ID del pedido
     • {order_number}: número de pedido de WooCommerce
     • {year}: año actual (YYYY)
     • {month}: mes actual (MM)
     • {day}: día actual (DD)

   Ejemplos de patrones personalizados:

   • FAC-{year}-{order_id} → FAC-2025-123
   • {year}/{month}/{order_number} → 2025/12/1234
   • INV{year}{month}{day}-{order_id} → INV20251211-123

Paso 4: Configurar PDFs

1. Caché automática de PDF:

   • Activa esta opción para descargar y guardar los PDFs en el servidor, dentro de la carpeta wp-content/uploads/b2brouter-Facturas/.
   • Mejora el tiempo de respuesta para descargas del cliente.
   • Reduce las llamadas a la API de B2Brouter.

2. Limpieza automática:

   • Activa la limpieza programada para borrar los PDFs que superen el número de días definido en el período de retención.
   • Configura el período de retención (por defecto: 90 días).
   • La limpieza se ejecuta diariamente mediante el cron de WordPress.

3. Adjuntar PDFs a los correos:

   • Adjuntar al correo de pedido completado: incluye el PDF cuando se envía el correo de confirmación.
   • Adjuntar al correo de factura del cliente: incluye el PDF en los correos de factura de WooCommerce.
   • Adjuntar al correo de reembolso: incluye la nota de crédito en los correos de reembolso.

---

Modo de generación de facturas

Generación automática

Si has activado el modo Automático:

1. El cliente completa una compra.
2. Procesa el pedido y márcalo como Completado.
3. El plugin:
   • Genera automáticamente la factura en B2Brouter.
   • Guarda los metadatos de la factura (ID, número, fecha).
   • Añade una nota al pedido.
   • Genera y guarda el PDF (si está activado).
   • Envía el correo con el PDF adjunto (si está configurado).

Generación manual - pedido individual

Si has activado el modo Manual y necesitas generar una factura:

1. Ve a WooCommerce → Pedidos.
2. Abre el pedido que deseas facturar.
3. Localiza el meta box B2Brouter Invoice.
4. Haz clic en el botón Generar Factura.
5. En el metabox se mostrará el estado y los detalles principales de la factura.
6. Puedes descargar el PDF directamente desde aquí.

Generación manual - acciones masivas

Para procesar múltiples pedidos a la vez:

1. Ve a WooCommerce → Pedidos.
2. Selecciona los pedidos completados que deseas facturar.
3. En el menú desplegable de acciones masivas, elige Generar Facturas B2Brouter.
4. Haz clic en Aplicar.
5. Verás un mensaje con el resultado de cada pedido:
   • Facturas generadas correctamente
   • Facturas que ya existían
   • Errores durante la generación

Generación de notas de crédito

Las notas de crédito se generan para los reembolsos de WooCommerce:

1. Abre el pedido en WooCommerce → Pedidos.
2. En el meta box 'Artículo', haz clic en Reembolsar (el pedido debe tener una factura).
3. Introduce el importe del reembolso, que puede ser total o parcial.
4. Confirma el reembolso.
5. La nota de crédito se genera automáticamente en el formato específico del país (por ejemplo, facturas rectificativas españolas).

---

Configuración de impuestos

El plugin lee la configuración de los impuestos de WooCommerce y la convierte automáticamente en categorías fiscales Peppol.

Categorías fiscales Peppol

• S (Standard rate): tipo general - Aplicada cuando existen tipos impositivos.
• E (Exempt from tax): exento de impuesto - Productos imponibles con tipo del 0%.
• Z (Zero-rated goods): bienes con tipo cero - Productos con clase fiscal de tipo cero explícita.
• NS (Not subject to tax): no sujeto a impuesto - Productos no imponibles.
• AE (VAT Reverse Charge): inversión del sujeto pasivo - Detectada automáticamente para transacciones intra-UE B2B.

Configuración de impuestos en WooCommerce

1. Activar el cálculo de impuestos:

   • Ve a WooCommerce → Opciones → General.
   • En la sección Impuestos y cupones, activa "Activa los tipos y los cálculos impositivos".

2. Configurar impuestos

   • Una vez activados los impuestos, ve a WooCommerce → Opciones → Impuestos. Desde esta sección puedes configurar las diferentes tarifas de impuestos:

   • Configurar tarifas estándar:

     • Haz clic en la pestaña Tarifas estándar.
     • Añade tus tipos impositivos por país:
       • Código de país
       • Porcentaje
       • Nombre del impuesto (IVA, VAT, etc.)
       • Si se aplica al envío

   • Configurar tarifas de tipo cero:

     • Haz clic en la pestaña Tarifas tasa cero.
     • Añade tus tipos impositivos por país:
       • Código de país
       • Nombre del impuesto (IVA, VAT, etc.)
       • Si se aplica al envío

   • Configurar tarifas de tipo reducido:

     • Haz clic en la pestaña Tarifas tasa reducida.
     • Añade tus tipos impositivos por país:
       • Código de país
       • Porcentaje
       • Nombre del impuesto (IVA, VAT, etc.)
       • Si se aplica al envío

Inversión del sujeto pasivo intra-UE

El plugin detecta automáticamente cuándo se aplica la inversión del sujeto pasivo:

Condiciones:

• El cliente proporciona un NIF válido.
• El país del cliente es diferente al país del comerciante.
• Ambos países son miembros de la UE (27 Estados).

Qué hace el plugin:

• Marca la transacción como inversión del sujeto pasivo (categoría AE).
• Genera la factura sin impuestos aplicados al cliente.
• Indica que el cliente debe declarar los impuestos en su país.

---

Recogida de NIF/VAT

Configuración del campo de NIF

El plugin añade automáticamente un campo de NIF al checkout de WooCommerce. Compatible con:

• Checkout por bloques (WooCommerce 8.6+)
• Checkout clásico basado en shortcodes

Cómo funciona

1. En el checkout:

   • El campo "NIF / VAT Number" aparece en la sección de información de contacto.
   • Es opcional por defecto.
   • El cliente puede introducir su NIF para facturas B2B/B2C.

2. Almacenamiento:

   • El NIF se guarda como _billing_tin en el cuadro de metadatos del pedido.
   • También se guarda en el perfil del cliente para su reutilización.

3. Facturación:

   • Si el cliente proporciona un NIF, se genera una factura estándar (IssuedInvoice).
   • Si no hay NIF, se genera una factura simplificada (IssuedSimplifiedInvoice).
   • Para transacciones intra-UE con NIF, se aplica la inversión del sujeto pasivo.

Validación del NIF

Actualmente el plugin no valida el formato del NIF. La validación se puede añadir mediante:

• Plugins de validación de terceros
• Validación personalizada con hooks de WooCommerce
• Validación a través de la API de B2Brouter

---

Configuración de webhooks

¿Por qué utilizar webhooks?

• Actualizaciones instantáneas: el estado de la factura aparece inmediatamente en la administración de WordPress.
• Menos carga: reduce las llamadas a la API.
• Más fiable: con una comprobación de fallback cada hora.

Configuración paso a paso

Paso 1: Obtener la URL en el panel de administración de WordPress

1. Ve a Facturas → Settings.
2. Desplázate hasta "Configuración de Webhooks".
3. Activa "Habilitar Webhooks".
4. Copia la URL del webhook del campo de solo lectura.
   • Se parece a: https://tusitioweb.com/wp-json/b2brouter/v1/webhook
5. Guarda la configuración.

Paso 2: Crear el endpoint en el panel de B2Brouter

1. Accede a app.b2brouter.net.
2. Ve a la pestaña Developers.
3. Haz clic en Webhooks en el menú principal.
4. Haz clic en "Añadir webhook".
5. Introduce una descripción, por ejemplo "Tienda WooCommerce".
6. Pega la URL del webhook copiada de WordPress.
7. Selecciona los eventos a enviar. Recomendado: seleccionarlo todo.
8. Guarda el endpoint y copia la clave de firma del webhook generado.

Paso 3: Finalizar la configuración en el panel de administración de WordPress

1. Vuelve a Facturas → Configuración → Configuración de Webhooks.
2. Pega la clave de firma de B2Brouter.
3. Deja activada la opción "Habilitar Comprobación de Seguridad".
4. Haz clic en "Guardar Configuración".

Verificación

Para verificar que los webhooks funcionan correctamente:

1. Genera una factura de prueba.
2. El estado debería aparecer en menos de 1 segundo.
3. Si hay problemas:
   • Verifica que la URL del webhook coincide exactamente.
   • Asegúrate de que el Secret está pegado correctamente (sin espacios extra).
   • Comprueba que tu sitio WordPress es accesible desde Internet.

Seguridad de los webhooks

• Todas las peticiones están firmadas criptográficamente con HMAC-SHA256.
• Las peticiones con firmas inválidas son rechazadas.
• Validación de la marca de tiempo (5 minutos) para prevenir ataques de repetición.
• El secreto se guarda de forma segura en las opciones de WordPress.

---

Gestión de PDFs

Almacenamiento en el servidor

Cuando actives "Caché automática de PDF":

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

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

Limpieza automática

El plugin incluye una tarea programada para limpiar PDFs antiguos:

1. Configuración:

   • Activa el checkbox de "Limpieza automática".
   • Establece el período de retención (por defecto: 90 días).

2. Funcionamiento:

   • Se ejecuta diariamente mediante el cron de WordPress.
   • Elimina archivos más antiguos que el período de retención.
   • Mantiene la estructura de carpetas.
   • Registra las limpiezas en el log de WordPress.

3. Desactivación de la limpieza:

   • Si desactivas la limpieza, los PDFs se mantienen indefinidamente.
   • Tendrás que gestionar el espacio en disco manualmente.

Descarga manual de facturas desde la administración de WordPress

1. Accede a WooCommerce → Pedidos y selecciona el pedido del que desees descargar la factura.
2. Desde el metabox "B2Brouter Invoice" del pedido, haz clic en Descargar PDF.
3. Si el PDF está en caché, se descarga inmediatamente.
4. Si no, el plugin:
   • Solicita el PDF a B2Brouter.
   • Lo guarda en caché (si está activado).
   • Lo descarga en tu navegador.

---

Experiencia del cliente

Descarga de facturas

Los clientes pueden acceder a sus facturas de varias formas:

1. Desde Mi cuenta → Pedidos:

   • Se muestra el listado de pedidos.
     • Si la factura ya ha sido generada, en la columna Acciones del listado de pedidos, se mostrará el botón Descargar factura. Haz clic para descargar la factura.
     • Si la factura no ha sido generada, en la columna Acciones del listado de pedidos, se mostrará el botón Generar factura. Haz clic para generar la factura. Una vez generada, el botón cambiará a Descargar factura. Haz clic para descargar la factura.

2. Desde Mi cuenta → Pedidos → Pedido:

   • Desde el listado de pedidos, en la columna Acciones de un pedido, haz clic en Ver en el pedido.
   • En la página de detalles del pedido, encontrarás:
     • Botón Descargar Factura.
     • Botón Descargar Nota de Crédito (si existe).

3. Desde el correo electrónico:

   • Si has activado "Adjuntar a correos".
   • El PDF se incluye como adjunto en el correo de confirmación.

4. Generación por parte del cliente (modo Manual):

   • Si el modo es Manual, los clientes pueden generar facturas ellos mismos.
   • En la página de detalles del pedido, verán un botón Generar Factura.
   • Después de hacer clic, la página se recarga y el PDF está disponible.

Seguridad

El plugin implementa varias medidas de seguridad:

1. Verificación de propiedad: los clientes solo pueden acceder a sus propias facturas.
2. Validación de estado: solo se pueden generar facturas para pedidos completados.
3. Protección CSRF: todas las acciones utilizan nonces de WordPress.
4. Validación de modo: la generación por parte del cliente solo funciona en modo Manual.

---

Buenas prácticas

Entorno de prueba

• Empieza con el sandbox y tu staging de WordPress, tal como se explica en «Probar el plugin en un entorno de prueba».
• Prueba todo el flujo de facturación antes de pasar a producción.
• Genera pedidos de prueba con diferentes configuraciones (con/sin NIF, varios países, etc.).

Copias de seguridad

• Realiza copias de seguridad regulares de tu base de datos de WordPress.
• Incluye el directorio wp-content/uploads/b2brouter-Facturas/ en las copias.
• Prueba la restauración de copias periódicamente.

Monitorización

• Revisa regularmente la página B2Brouter → Facturas para ver el estado.
• Configura notificaciones para errores de generación de facturas.
• Comprueba los logs de WordPress periódicamente.

Actualizaciones

• Mantén el plugin actualizado a la última versión.
• Revisa el changelog antes de actualizar.
• Prueba las actualizaciones en el entorno de staging primero.

Rendimiento

• Activa "Auto-guardar PDFs" para mejorar el tiempo de respuesta.
• Configura la limpieza automática para gestionar el espacio en disco.
• Utiliza webhooks para actualizaciones de estado en tiempo real.

---

Requisitos legales

Cumplimiento fiscal

El plugin ayuda con el cumplimiento fiscal, pero:

• Responsabilidad: el comerciante es responsable del cumplimiento fiscal.
• Configuración: asegúrate de que la configuración de impuestos es correcta para tu país.
• Asesoramiento: consulta con un asesor fiscal para los requisitos específicos de tu país.

Protección de datos (RGPD)

El plugin procesa datos personales:

• Base legal: necesario para el cumplimiento de obligaciones legales.
• Datos procesados: nombre, dirección, NIF, información del pedido.
• Almacenamiento: los datos se guardan en WordPress y se envían a B2Brouter.
• Retención: configura el período de retención según tus requisitos legales.

Actualiza tu política de privacidad para incluir:

• El uso de B2Brouter para la generación de facturas.
• Los datos que se envían a B2Brouter.
• Cómo los clientes pueden ejercer sus derechos.

---

Problemas frecuentes

Aquí tienes los problemas más habituales al configurar y usar el plugin, con la causa probable y cómo resolverlos. Si tu caso no aparece, o quieres más detalle del error, activa antes el modo de depuración.

Activa el modo de depuración

1. Añade estas líneas a tu wp-config.php:

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

2. Los errores se registrarán en wp-content/debug.log.

3. Busca entradas que contengan "B2Brouter" para ver los errores del plugin.

1. Error de validación de clave API

Síntomas: mensaje "Error al validar la clave API"

Soluciones:

• Verifica que la clave API es correcta.
• Asegúrate de que tu suscripción a eDocExchange está activa.
• Comprueba que tu servidor puede conectar con B2Brouter (no bloqueado por firewall).

2. Las facturas no se generan automáticamente

Síntomas: los pedidos se completan pero no se generan facturas.

Soluciones:

• Verifica que el modo es Automático en la configuración.
• Comprueba que el estado del pedido es Completado.
• Revisa las notas del pedido para ver si hay errores.
• Comprueba los logs de WordPress para ver errores detallados.

3. Los PDFs no se adjuntan a los correos

Síntomas: los correos se envían pero sin el PDF adjunto

Soluciones:

• Verifica que "Auto-guardar PDFs" está activado.
• Comprueba que "Adjuntar a correos" está activado.
• Asegúrate de que la factura se ha generado antes de enviar el correo.
• Revisa los logs del servidor SMTP para ver si hay errores en el envío.

4. Los webhooks no funcionan

Síntomas: el estado de las facturas no se actualiza inmediatamente

Soluciones:

• Verifica que la URL del webhook coincide exactamente.
• Comprueba que el Secret del webhook es correcto.
• Asegúrate de que tu sitio es accesible desde Internet (los webhooks no funcionan en localhost sin un túnel).
• Revisa los logs de WordPress para ver si llegan peticiones.
• Comprueba que no hay errores SSL en el certificado de tu sitio.

5. Error "No se ha podido generar el PDF"

Síntomas: la factura se crea pero el PDF no se puede descargar

Soluciones:

• Comprueba que el directorio wp-content/uploads/ tiene permisos de escritura.
• Revisa el estado de la factura en B2Brouter (puede que no esté procesada aún).
• Fuerza la regeneración del PDF (Mayús + clic).
• Verifica que la API de B2Brouter está operativa.

6. Los PDFs llevan la marca "No válida" o los webhooks no llegan

Síntoma: las facturas generadas se descargan con una marca de agua que dice "No válida", o el estado de los pedidos en WooCommerce no se actualiza después de procesar el pago.

Causa más probable: estás usando una clave API de sandbox (empieza por test_) en lugar de una clave de producción (empieza por prod_), o bien tienes los webhooks configurados en el sandbox en lugar de la cuenta real.

Solución:

1. Comprueba el prefijo de la clave API en la configuración del plugin:
   • test_… → estás en sandbox. Los documentos no tienen validez legal y los webhooks de producción no llegarán.
   • prod_… → estás en producción. Es lo que quieres en la tienda real.
2. Si has confirmado que la clave es prod_… pero los webhooks no llegan, ve a la cuenta de producción de B2Brouter (no al sandbox) y revisa la configuración de webhooks.
3. Si usas la clave test_… voluntariamente para probar, asegúrate de que lo estás haciendo en un entorno de staging y no en la tienda real. Consulta la sección "Probar el plugin en un entorno de prueba".

7. Categorías de impuestos incorrectas

Síntomas: las categorías fiscales no son correctas en las facturas

Soluciones:

• Revisa la configuración de impuestos en WooCommerce → Configuración → Impuestos.
• Asegúrate de que las clases fiscales están configuradas correctamente.
• Verifica que los productos tienen asignada la clase fiscal correcta.
• Para productos no imponibles, establece "Estado de la tasa" en "Ninguno".

---

Obtener ayuda

Si ninguna de las soluciones de «Problemas frecuentes» te funciona, tienes dos vías para pedir ayuda. Para resolverlo más rápido, adjunta las entradas de debug.log relacionadas con B2Brouter e indica la versión del plugin, de WordPress y de WooCommerce.

1. Soporte B2Brouter: abre un ticket de soporte desde tu cuenta. Los clientes de eDocExchange tienen acceso al soporte premium, con prioridad en la resolución de tickets y atención siete días a la semana.
2. Problemas en GitHub: github.com/B2Brouter/b2brouter-woocommerce/issues