Configuración de informes fiscales

Configura tus ajustes de informes fiscales para habilitar el envío de informes fiscales a la autoridad tributaria de tu país. Puedes listar, crear, actualizar y eliminar estos ajustes según sea necesario.

Actualmente, la API de B2Brouter soporta ajustes de informes fiscales para los siguientes países:

[BETA] Francia (DGFiP - Direction Générale des Finances Publiques)
España (Verifactu y TicketBAI)
Italia (SDI - Sistema di Interscambio)
Malasia (LHDN - Lembaga Hasil Dalam Negeri)

Configurar ajustes de informes fiscales

B2Brouter solo permite configurar ajustes de informes fiscales para autoridades tributarias de tu propio país. Debes establecer el campo start_date para definir cuándo comenzará la presentación de informes fiscales. Si el campo start_date no se establece, B2Brouter asumirá el día actual.

Generación automática

Puedes generar automáticamente informes fiscales después de que la factura haya sido enviada configurando auto_generate mediante JSON Payload. Algunas autoridades tributarias, para cumplir con los requisitos legales, obligan a generar el informe fiscal tan pronto como se haya enviado la factura. En ese caso no podrás configurar la generación automática del informe fiscal.

Si deseas generar manualmente cada informe fiscal, establece auto_generate en false.

Envío automático

Si has configurado la generación automática de informes fiscales, también puedes automatizar el proceso de envío con auto_send. Una vez creado el informe fiscal, se enviará automáticamente a la autoridad tributaria.

Requisitos especiales

Cada autoridad tributaria de cada país puede tener diferentes ajustes especiales para cumplir con la normativa.

[BETA] Francia

Crear una configuración de informe fiscal DGFiP inicia el proceso completo de onboarding para la reforma francesa de facturación electrónica. Cuando la configuración se crea con enabled: true, B2Brouter registra automáticamente tu empresa en el Annuaire (directorio) del PPF y crea un transporte Peppol 0225 para recibir facturas.

No puedes configurar el parámetro auto_generate, ya que se establece automáticamente en true por cumplimiento legal. Del mismo modo, auto_send también se establece por defecto en true.

Para instrucciones detalladas sobre el flujo completo de facturación electrónica en Francia, consulta la guía [BETA] DGFiP e-Invoicing and e-Reporting.

Ejemplo:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "dgfip",
      "start_date": "2026-09-01",
      "type_operation": "services",
      "email": "tax-notifications@exemplar.fr",
      "enterprise_size": "pme",
      "naf_code": "62"
    }
  }'

Explicación de los campos:

type_operation: Tipo de operaciones de tu negocio (services, goods o mixed). Determina el código de proceso utilizado en el flujo PPF.
email: Correo de contacto para notificaciones fiscales.
enterprise_size: Tamaño de la empresa. Valores aceptados: ge (gran empresa), eti (mediana), pme (PYME), micro. Obligatorio salvo que annuaire_only sea true.
naf_code: Código NAF francés de actividad de 2 dígitos (por ejemplo 62 para servicios IT). Obligatorio salvo que annuaire_only sea true.
annuaire_only (booleano, opcional): Cuando es true, B2Brouter solo registra la empresa en el Annuaire del PPF y habilita la recepción por Peppol, sin generar informes fiscales.

Italia

SDI no tiene requisitos especiales para configurar los ajustes de informes fiscales; simplemente debes crear la configuración y comenzar a reportar tus impuestos.

Ejemplo:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "sdi",
      "start_date": "2024-06-06",
      "auto_generate": true,
      "auto_send": true
    }
  }'

España

Verifactu

Verifactu acepta varios ajustes especiales relacionados con valores predeterminados para ciertos elementos, como special_regime_key. No puedes configurar el parámetro auto_generate, ya que por obligación legal de Verifactu se establece automáticamente en true y generará el informe fiscal antes de emitir la factura.

Ejemplo:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "verifactu",
      "start_date": "2025-06-06",
      "auto_generate": true,
      "auto_send": true,
      "reason_vat_exempt": "E1",
      "special_regime_key": "01",
      "reason_no_subject": "N1",
      "credit_note_code": "R1",
      "type_operation": "services"
    }
  }'

TicketBAI

TicketBAI tiene algunos ajustes especiales. Al crear la configuración del informe fiscal debes especificar la delegation a la que reportarás tus impuestos (Araba, Gipuzkoa, Bizkaia) y establecer los campos especiales de TicketBAI.

No puedes configurar el parámetro auto_generate, ya que por obligación legal de TicketBAI se establece automáticamente en true y generará el informe fiscal una vez que la factura entre en estado sent.

Además, cada delegación vasca tiene requisitos especiales:

Bizkaia: Debes establecer el epigraph de tu empresa para poder generar correctamente el informe fiscal.
Gipuzkoa: Para enviar informes fiscales debes completar y enviar la siguiente documentación a la Diputación Foral de Gipuzkoa:
- Orden Foral que aprueba los términos de colaboración social en el envío de ficheros TicketBAI generados en cumplimiento de la obligación TicketBAI. Descargar
- Autorización para enviar los ficheros TicketBAI generados para el cumplimiento de la obligación TicketBAI. Descargar
- Debes incorporar los datos de estos formularios en los archivos informáticos de la Hacienda Foral a efectos fiscales. Si no incluyes los datos indicados, los documentos enviados serán rechazados por la Diputación Foral de Gipuzkoa.

Ejemplo:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "tbai",
      "start_date": "2024-06-06",
      "auto_generate": true,
      "auto_send": true,
      "delegation": "gipuzkoa",
      "reason_vat_exempt": "E1",
      "special_regime_key": "01",
      "reason_no_subject": "OT",
      "credit_note_code": "R1",
      "type_operation": "services",
      "epigraph": "147410"
    }
  }'

Malasia

Para enviar tus informes fiscales a LHDN, B2Brouter debe estar registrado como ERP intermediario en el portal MyInvois. Este registro es necesario para autorizarnos a enviar informes fiscales en tu nombre. Puedes encontrar instrucciones detalladas aquí.

Una vez que B2Brouter esté registrado como ERP intermediario para tu perfil fiscal en el portal MyInvois, podrás habilitar los ajustes de informes fiscales LHDN en tu cuenta de B2Brouter para comenzar a reportar facturas a LHDN.

Ejemplo:

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/tax_report_settings \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_report_setting": {
      "code": "lhdn",
      "msic": "01111",
      "type_operation": "services",
      "classification_code": "001"
    }
  }'

Explicación de los campos:

msic: Código de clasificación empresarial malasio, requerido por LHDN.
type_operation: Tipo de operaciones de tu negocio (servicios o bienes). Se rellenará por defecto con este valor si no se especifica en la factura.
classification_code: Código específico relacionado con la categoría de tu línea de productos. Se rellenará por defecto con este valor si no se especifica en la factura.

Modificar ajustes de informes fiscales

Una vez configurados tus ajustes, puedes modificarlos en caso de error o si deseas cambiar algunos parámetros. Sin embargo, ten en cuenta que una vez alcanzada la start_date no podrás modificar algunos parámetros.

TicketBAI

Si tu período de reporte fiscal ya ha comenzado, no podrás modificar la delegation configurada para TicketBAI.

Eliminar ajustes de informes fiscales

Si deseas eliminar tu configuración de informes fiscales por cualquier motivo, debes tener en cuenta que una vez creado el primer informe fiscal a partir de cualquiera de tus facturas, ya no podrás eliminar la configuración. Esta restricción se aplica debido a los requisitos legales de las autoridades tributarias.

Al listar todas o recuperar una configuración de informes fiscales, el campo locked indicará si se han creado informes fiscales con esa configuración.

Envío de informes fiscales

Después de configurar tus ajustes de informes fiscales podrás generar y enviar informes fiscales en la fecha indicada en start_date. Para más información sobre cada tipo de informe fiscal, consulta las guías correspondientes: