Configuració d'informes fiscals

Configura la Configuració d’informes fiscals per habilitar l’enviament d’informes fiscals a l’autoritat fiscal del teu país. Pots 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 et permet configurar els paràmetres d’informes fiscals només per a les autoritats fiscals que es troben al teu país. El camp start_date defineix quan començarà la comunicació fiscal. En crear els paràmetres és opcional: si no es defineix, B2Brouter assumirà que és el dia actual, excepte per a la DGFiP, on per defecte és l’endemà. Per a la DGFiP, una start_date anterior a l’endemà es rebutja amb un error 422. Si modifiques els paràmetres sense enviar el camp start_date, la data desada no canvia.

Generació automàtica

Pots 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 podràs configurar la generació automàtica de l’informe fiscal.

Si vols generar manualment cada informe fiscal, defineix auto_generate a false.

Quan generes un informe fiscal manualment amb el mètode de generar l’informe fiscal (POST /invoices/{id}/generate_tax_report), B2Brouter valida primer la factura emesa amb les mateixes regles que en enviar-la. Si alguna regla d’enviament no es compleix, la crida respon 422 amb el missatge «Error generating document: …» i no es crea cap informe fiscal. L’error és de la factura, no de l’informe fiscal: corregeix la factura (per exemple, afegeix-hi la data de venciment) i torna a generar l’informe. Dues factures amb les mateixes dades poden donar resultats diferents si els seus contactes fan servir mètodes d’enviament diferents.

Enviament automàtic

Si has configurat la generació automàtica d’informes fiscals, també pots 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 teva empresa a l’Annuaire del PPF i crea un transport Peppol 0225 per rebre factures.

No pots 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, consulta 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 teves 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 has de crear la configuració i començar a reportar els teus 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 pots 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 has d’especificar la delegation a la qual reportaràs els teus impostos (Araba, Gipuzkoa, Bizkaia) i definir els camps especials per a TicketBAI.

No pots 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: Has de definir l’epigraph de la teva empresa per poder generar l’informe fiscal correcte.
• Gipuzkoa: Per enviar informes fiscals has 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
  • Has d’incorporar les dades d’aquests formularis als fitxers informàtics de la Hisenda Foral per a finalitats fiscals. Si no inclous 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 teus 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 teu. Pots trobar instruccions detallades aquí.

Un cop B2Brouter estigui registrat com a ERP intermediari per al teu perfil fiscal al Portal MyInvois, pots habilitar la configuració d’informes fiscals LHDN al teu 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 teves operacions de negoci (serveis o béns). Valor predeterminat si no s’especifica a la teva factura.
• classification_code: Codi específic relacionat amb la categoria de la teva línia de productes. Valor predeterminat si no s’especifica a la teva factura.

Modificar la Configuració d’informes fiscals

Un cop hagis configurat els paràmetres, pots modificar-los en cas d’haver comès un error o simplement voler canviar alguns dels paràmetres. Tanmateix, tingues en compte que un cop assoleixis la start_date no podràs modificar alguns dels paràmetres.

TicketBAI

Si el teu període de comunicació fiscal ha començat, no podràs modificar la delegation que hagis 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, has de saber que un cop hagis creat el primer informe fiscal a partir de qualsevol de les teves factures, no podràs eliminar la Configuració. Aquesta restricció s’aplica per als requisits legals de les Autoritats Fiscals. Quan llistes tots o recuperes 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 teus paràmetres d’informes fiscals, podràs generar i enviar informes fiscals a partir del dia start_date. Per a més informació sobre cada tipus d’informe fiscal, consulta les guies rellevants:

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