Xarxa Peppol - Enviar autofacturació

Disponible a partir de la versió 2025-10-13

L’autofacturació permet als compradors emetre factures en nom dels proveïdors. B2Brouter representa l’autofacturació com:

Sortida: IssuedSelfInvoice via Peppol BIS3 Self-Billing. Entrada: ReceivedSelfInvoice rebuda per Peppol amb la recepció activada al compte del proveïdor.

1. Preparació

Consulteu la guia principal Enviar una factura per Peppol per a una visió general i detalls de configuració del transport.

2. Crear una autofactura (IssuedSelfInvoice)

Per emetre una autofactura via API:

1. Useu POST /accounts/{account}/invoices.
2. Establiu invoice.type a IssuedSelfInvoice.
3. Assegureu-vos que el Contact tingui transport_type_code a peppol i proporcioneu els camps pin_scheme i pin_value.

Comportament:

• B2Brouter crea un IssuedSelfInvoice.
• En enviar per Peppol, B2Brouter genera una UBL BIS3 Self-Billing Invoice (xml.ubl.invoice.bis3.selfbilling):
  • El proveïdor a l’UBL és el vostre contacte.
  • El client a l’UBL és la vostra empresa (compte).
• La resposta JSON inclou:
  • "type": "IssuedSelfInvoice"
  • "document_type_code": "xml.ubl.invoice.bis3.selfbilling" (camp de només lectura que mostra el format usat)

També podeu enviar autofactures a través d’altres transports (per exemple, B2Brouter intern). No obstant això, si la configuració del contacte i del país suporta l’autofacturació per Peppol, recomanem usar Peppol perquè ofereix millor interoperabilitat i traçabilitat.

3. Llistar i obtenir autofactures

Useu els endpoints estàndard de factures amb el filtre type:

• type=IssuedSelfInvoice – Llistar autofactures emeses
• type=ReceivedSelfInvoice – Llistar autofactures rebudes

Llistar factures: GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSelfInvoice

Obtenir factura: GET /invoices/{INVOICE_ID}

4. Declaració fiscal

Les autofactures s’inclouen als informes fiscals (Verifactu, etc.) sota les mateixes regles que les factures normals:

• Si un informe fiscal està activat per a l’empresa (p. ex., Verifactu a Espanya), les autofactures es declaren automàticament quan escau.
• A Verifactu, l’autofacturació es declara en nom de l’empresa emissora (Buyer).
• Es pot aplicar un comportament addicional de declaració fiscal a les autofactures en funció de la configuració d’informes fiscals del compte emissor.
• Les autofactures de venedors no subjectes a Verifactu queden excloses de la declaració.

5. Restriccions i limitacions conegudes

• Tipus de factura vs tipus de document

  • L’autofacturació usa sempre invoice.type = IssuedSelfInvoice per a documents sortints.
  • Intentar enviar una IssuedInvoice normal usant un tipus de document d’autofacturació fallarà amb un error 4xx:
    • "The self-billing document type cannot be used for ordinary invoices."

• Selecció del tipus de document

  • document_type_code a la factura és de només lectura.
  • El tipus de document efectiu el determina la configuració del contacte i/o les capacitats SMP de Peppol del proveïdor.

Recomanacions per a l’ús en producció:

• Proveu d’extrem a extrem al sandbox entre dos comptes de prova (useu staging per a fluxos grans o entre sistemes).
• Verifiqueu tant les respostes JSON de l’API com els fitxers UBL enviats.
• Superviseu els registres d’integració (peticions API) per a càrregues útils, respostes i detalls d’error.