Configuració d'informes fiscals

Configureu la Configuració d’informes fiscals per habilitar l’enviament d’informes fiscals a l’autoritat fiscal del vostre país. Podeu llistar, crear, actualitzar i eliminar aquesta configuració quan sigui necessari.

L’API de B2Brouter admet actualment la Configuració d’informes fiscals per als països següents:

• [BETA] França (DGFiP - Direction Générale des Finances Publiques)
• Espanya (Verifactu i TicketBAI)
• Itàlia (SDI - Sistema di Interscambio)
• Malàisia (LHDN - Lembaga Hasil Dalam Negeri)

Configurar els paràmetres d’informes fiscals

B2Brouter us permet configurar els paràmetres d’informes fiscals només per a les autoritats fiscals que es troben al vostre país. Heu de definir la start_date per configurar quan començarà la comunicació fiscal. Si el camp start_date no es defineix, B2Brouter assumirà que és el dia actual.

Generació automàtica

Podeu generar automàticament informes fiscals després que s’hagi enviat la factura configurant auto_generate usant el payload JSON. Algunes autoritats fiscals, per complir els requisits legals, obliguen a generar l’informe fiscal tan aviat com s’hagi enviat la factura. En aquest cas no podreu configurar la generació automàtica de l’informe fiscal.

Si voleu generar manualment cada informe fiscal, definiu auto_generate a false.

Enviament automàtic

Si heu configurat la generació automàtica d’informes fiscals, també podeu automatitzar el procés d’enviament amb auto_send. Un cop s’hagi creat l’informe fiscal, s’enviarà automàticament a l’autoritat fiscal.

Requisits especials

Cada autoritat fiscal de cada país pot tenir paràmetres especials per complir.

[BETA] França

Crear una Configuració d’informes fiscals DGFiP activa el procés complet d’incorporació a la reforma de la facturació electrònica francesa. Quan es crea la configuració amb enabled: true, B2Brouter registra automàticament la vostra empresa a l’Annuaire del PPF i crea un transport Peppol 0225 per rebre factures.

No podeu configurar el paràmetre auto_generate, ja que s’estableix automàticament a true per compliment legal. De la mateixa manera, auto_send és true per defecte.

Per a instruccions detallades sobre el flux de treball complet de la facturació electrònica a França, consulteu la [BETA] guia de facturació electrònica i e-Reporting DGFiP.

Exemple:

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

• type_operation: Tipus de les vostres operacions de negoci (services, goods o mixed). Determina el codi de procés usat al flux del PPF.
• email: Correu de contacte per a notificacions relacionades amb impostos.
• enterprise_size: Mida de l’empresa. Valors acceptats: ge (gran), eti (mitjana), pme (PIME), micro. Requerit tret que annuaire_only sigui true.
• naf_code: Codi d’activitat NAF francès de 2 dígits (per exemple, 62 per a serveis TIC). Requerit tret que annuaire_only sigui true.
• annuaire_only (booleà, opcional): Quan és true, B2Brouter només registra l’empresa a l’Annuaire del PPF i habilita la recepció Peppol, sense generar informes fiscals.

Itàlia

L’SDI no té requisits especials per configurar la Configuració d’informes fiscals; simplement heu de crear la configuració i començar a reportar els vostres impostos.

Exemple:

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
    }
  }'

Espanya

Verifactu

Verifactu accepta diversos paràmetres especials, que tracten els valors predeterminats per a alguns elements, com ara special_regime_key. No podeu configurar el paràmetre auto_generate, ja que per obligacions legals de Verifactu s’estableix automàticament a true i generarà l’informe fiscal abans d’emetre la factura.

Exemple:

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 té alguns paràmetres especials. En crear la Configuració d’informes fiscals heu d’especificar la delegation a la qual reportareu els vostres impostos (Araba, Gipuzkoa, Bizkaia) i definir els camps especials per a TicketBAI.

No podeu configurar el paràmetre auto_generate, ja que per obligacions legals de TicketBAI s’estableix automàticament a true i generarà l’informe fiscal un cop la factura hagi entrat en l’estat “sent”.

A més, cada delegació basca té alguns requisits especials:

• Bizkaia: Heu de definir l’epigraph de la vostra empresa per poder generar l’informe fiscal correcte.
• Gipuzkoa: Per enviar informes fiscals heu d’emplenar i enviar la documentació següent a la Diputació Foral de Gipuzkoa:
  • Ordre foral que aprova els termes de la col·laboració social en l’enviament de fitxers TicketBAI generats en compliment de l’obligació TicketBAI. Descarregar
  • Autorització per enviar els fitxers TicketBAI generats per al compliment de l’obligació TicketBAI. Descarregar
  • Heu d’incorporar les dades d’aquests formularis als fitxers informàtics de la Hisenda Foral per a finalitats fiscals. Si no incloeu les dades indicades, els documents enviats seran rebutjats per la Diputació Foral de Gipuzkoa.

Exemple:

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"
    }
  }'

Malàisia

Per enviar els vostres informes fiscals a LHDN, B2Brouter s’ha de registrar com a ERP intermediari al portal MyInvois. Aquest registre és necessari per autoritzar-nos a enviar informes fiscals en nom vostre. Podeu trobar instruccions detallades aquí.

Un cop B2Brouter estigui registrat com a ERP intermediari per al vostre perfil fiscal al Portal MyInvois, podeu habilitar la configuració d’informes fiscals LHDN al vostre compte de B2Brouter per començar a reportar factures a LHDN.

Exemple:

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

• msic: Codi de classificació empresarial malàisia, requerit per LHDN.
• type_operation: Tipus de les vostres operacions de negoci (serveis o béns). Valor predeterminat si no s’especifica a la vostra factura.
• classification_code: Codi específic relacionat amb la categoria de la vostra línia de productes. Valor predeterminat si no s’especifica a la vostra factura.

Modificar la Configuració d’informes fiscals

Un cop hàgiu configurat els paràmetres, podeu modificar-los en cas d’haver comès un error o simplement voler canviar alguns dels paràmetres. Tanmateix, tingueu en compte que un cop assoliu la start_date no podreu modificar alguns dels paràmetres.

TicketBAI

Si el vostre període de comunicació fiscal ha començat, no podreu modificar la delegation que hàgiu configurat per a la comunicació TicketBAI.

Eliminar la Configuració d’informes fiscals

En cas de voler eliminar la Configuració d’informes fiscals per qualsevol motiu, heu de saber que un cop hàgiu creat el primer informe fiscal a partir de qualsevol de les vostres factures, no podreu eliminar la Configuració. Aquesta restricció s’aplica per als requisits legals de les Autoritats Fiscals. Quan llisteu tots o recupereu un sol paràmetre d’informe fiscal, el camp locked indicarà si s’han creat informes fiscals amb aquesta configuració.

Enviar informes fiscals

Després de configurar els vostres paràmetres d’informes fiscals, podreu generar i enviar informes fiscals a partir del dia start_date. Per a més informació sobre cada tipus d’informe fiscal, consulteu les guies rellevants:

• [BETA] Facturació electrònica i e-Reporting DGFiP
• Verifactu
• TicketBAI
• LHDN