Guía de usuario de B2Brouter para WooCommerce

Índice

1. Introducción
2. Requisitos e Instalación
3. Probar el plugin en un entorno de prueba
4. Configuración Inicial
5. Generación de Facturas
6. Configuración de impuestos
7. Recogida de NIF/VAT
8. Configuración de Webhooks
9. Gestión de PDFs
10. Experiencia del Cliente
11. Resolución de Problemas

---

Introducción

B2Brouter for WooCommerce es un plugin que automatiza la generación y el envío de facturas electrónicas desde tu tienda WooCommerce utilizando la plataforma B2Brouter.

Principales beneficios

• Cumplimiento Legal: Cumplimiento automático con las normativas de facturación electrónica de múltiples países.
• Ahorro de Tiempo: Generación automática de facturas electrónicas sin intervención manual.
• Profesionalidad: Facturas estructuradas en formatos estándar (UBL, CII, XML, etc.)
• Transfronteriza: Soporte para transacciones B2B y B2C internacionales.
• Integración Total: Funciona perfectamente con WooCommerce sin afectar el flujo de trabajo.

---

Requisitos e instalación

Requisitos previos

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 del plugin B2Brouter

Opción recomendada — desde el repositorio oficial de WordPress

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.

Alternativas — descarga manual

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.

A partir de aquí puedes proceder con la configuración inicial.

---

Probar el plugin en un entorno de prueba

⚠️ Importante — no uses el Sandbox en tu tienda de producción

El Sandbox de B2BRouter genera documentos marcados como “No válida” y sus webhooks son completamente independientes de los de producción. 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 el reverse charge intracomunitario) se calculan como esperas.
• Que el campo de NIF/VAT se recoge en el checkout y se propaga a la factura.
• Que los webhooks actualizan correctamente el estado del pedido en WooCommerce.
• Que los PDFs se generan y se pueden descargar desde “Mi cuenta”.
• Que los emails 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 la sección “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

🚧 El soporte de webhooks en el entorno sandbox estará disponible 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 el reverse charge si haces ventas B2B intracomunitarias.
• Si el cliente introduce un NIF/VAT, queda registrado en la factura.
• El webhook llega al staging y el estado del pedido se actualiza en WooCommerce.
• El PDF se descarga correctamente desde “Mi cuenta” (llevará la marca “No válida” — es normal en sandbox).
• Los emails se disparan 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 WP de producción.
3. No migres datos del staging a producción — las facturas de pruebas (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 de tu 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 regulares (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 (elige una opción):

   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 vía 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, 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): Tasa estándar - Aplicada cuando existen tasas.
• E (Exempt from tax): Exento de tasa - Productos imponibles con tasa del 0%.
• Z (Zero-rated goods): Bienes con tasa cero - Productos con clase fiscal de tasa cero explícita.
• NS (Not subject to tax): No sujeto a tasa - Productos no imponibles.
• AE (VAT Reverse Charge): Inversión del sujeto pasivo - Detectado 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 tasas por país:
       • Código de país
       • Porcentaje de tasa
       • Nombre de la tasa (IVA, VAT, etc.)
       • Si se aplica al envío

   • Configurar tarifas tasa cero:

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

   • Configurar tarifas tasa reducida:

     • Haz clic en la pestaña Tarifas tasa reducida.
     • Añade tus tasas por país:
       • Código de país
       • Porcentaje de tasa
       • Nombre de la tasa (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

Los webhooks de producción y de sandbox son completamente independientes: cada uno tiene su propia configuración y los eventos no se comunican entre entornos. Si estás probando el plugin en staging con una clave de sandbox, configura los webhooks dentro del sandbox apuntando a la URL del staging. Cuando pases a producción, tendrás que configurarlos de nuevo en la cuenta de producción.

Los webhooks permiten actualizaciones de estado de facturas en tiempo real (< 1 segundo) en lugar de esperar la comprobación horaria.

¿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 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://susitioweb.com/wp-json/b2brouter/v1/webhook
5. Guarda la configuración.

Paso 2: Crear el endpoint en el Dashboard 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 timestamp de 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 vía WordPress cron.
   • 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 tu 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 tu 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).

2. Desde el correo electrónico:

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

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

---

Resolución de Problemas

Problemas Comunes

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 tunneling).
• 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).
• Intenta regenerar el PDF forzosamente (Shift + 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”, y/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. Errores de impuestos incorrectos

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

Activar el modo de depuración

Para obtener más información sobre errores:

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

Obtener ayuda

Si no puedes resolver el problema:

1. Soporte B2Brouter: Los clientes de eDocExchange tienen acceso al soporte premium con:
   • Prioridad en la resolución de tickets.
   • Atención siete días a la semana.
2. Problemas en GitHub: github.com/B2Brouter/b2brouter-woocommerce/issues

---

Mejores Prácticas

Entorno de Prueba

• Empieza con el sandbox — es el entorno recomendado para la mayoría de pruebas y el trabajo de desarrollo inicial. Utiliza el entorno de staging completo solo para integraciones a gran escala o pruebas exhaustivas de extremo a extremo.
• 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 (GDPR)

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.

---

Conclusión

Este plugin proporciona una integración completa entre WooCommerce y B2Brouter para la gestión automatizada de facturas electrónicas. Siguiendo esta guía, podrás configurar y utilizar todas las funcionalidades del plugin de forma efectiva.

Para cualquier pregunta o problema, no dudes en contactar con el soporte de B2Brouter o abrir un issue en el repositorio de GitHub.

¡Disfruta de la facturación electrónica automatizada con B2Brouter! 🎉