Self-billing tramite l'API

Self-billing end-to-end tramite la PSB API: le due varianti, registrazione e scelta tra NLCIUS e BIS.

Il self-billing (autofatturazione) è il processo in cui l'acquirente emette la fattura per conto del fornitore. Questo si verifica in settori in cui l'acquirente può calcolare con maggiore precisione quanto fornito, ad esempio nel lavoro interinale o nei servizi in appalto. La PSB supporta il self-billing in due varianti, ciascuna con proprie caratteristiche tecniche.

Due varianti

La PSB offre due modalità per inviare fatture self-billing tramite la rete Peppol:

1. NLCIUS / SI-UBL 2.0 (semplificato)

Con questa variante si modifica solo l'InvoiceTypeCode nella fattura NLCIUS esistente:

  • InvoiceTypeCode 389 per una fattura self-billing
  • InvoiceTypeCode 261 per una nota di credito self-billing

Il CustomizationID e il ProfileID rimangono identici a quelli di una fattura NLCIUS regolare. La PSB riconosce automaticamente il tipo di documento in base all'InvoiceTypeCode e instrada il documento correttamente. Se il fornitore è già registrato per la ricezione di fatture NLCIUS regolari, non è necessaria alcuna registrazione aggiuntiva.

Questa è la variante più semplice, adatta alla maggior parte delle integrazioni olandesi.

2. Peppol BIS Self-Billing 3.0

Questo è un profilo Peppol separato con propri identificatori:

CampoValoreCustomizationIDurn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0ProfileIDurn:fdc:peppol.eu:2017:poacc:selfbilling:01:1.0InvoiceTypeCode389 (fattura) o 261 (nota di credito)

Con questa variante il fornitore deve essere registrato separatamente nel Peppol SMP per la ricezione di documenti self-billing. L'acquirente (mittente) invia il documento tramite l'endpoint Generic della PSB.

Utilizzi questa variante se il fornitore supporta esplicitamente il profilo BIS Self-Billing 3.0, o se il destinatario si trova fuori dai Paesi Bassi e non accetta NLCIUS.

Quale variante scegliere?
SituazioneRaccomandazioneFornitore olandese, già registrato per NLCIUSNLCIUS (variante 1)Fornitore internazionale o supporto esplicito BIS Self-BillingBIS Self-Billing 3.0 (variante 2)Incerto sulle capabilities del fornitoreVerifichi tramite queryRecipientParty
Verificare le capabilities

Prima di inviare una fattura self-billing, verifichi se il fornitore può ricevere il tipo di documento desiderato:

GET /api/v1/queryRecipientParty?identifier={schemeID}:{id} HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}

La risposta contiene i tipi di documento supportati dal fornitore. Verifichi se il profilo self-billing (BIS Self-Billing 3.0) o il profilo fattura standard (NLCIUS) è disponibile.

Invio e ricezione

I dettagli tecnici per l'invio e la ricezione di fatture self-billing sono descritti in articoli separati:

Punti di attenzione pratici
  • Nel self-billing l'acquirente è l'estensore e il mittente della fattura, mentre il fornitore è il destinatario. Questo è l'inverso di una fattura regolare.
  • Sulle versioni PDF delle fatture self-billing il testo "Fattura emessa dal cliente" è obbligatorio.
  • La fornitura in UBL è sempre preferibile rispetto al PDF. In caso di UBL non valido, un eventuale PDF allegato viene utilizzato come fallback.
  • L'elemento AccountingSupplierParty contiene i dati del fornitore (che "riceve" la fattura), non dell'acquirente che la emette.
Domande frequenti
Qual è la differenza tra la variante NLCIUS e BIS Self-Billing 3.0?

Con NLCIUS si modifica principalmente l'InvoiceTypeCode in 389 (fattura) o 261 (nota di credito); CustomizationID e ProfileID rimangono uguali al NLCIUS standard. BIS Self-Billing 3.0 utilizza valori fissi di CustomizationID e ProfileID per il profilo self-billing e richiede che il fornitore sia registrato nella SMP per quel profilo; l'invio avviene tramite l'endpoint Generic.

Come scelgo quale variante utilizzare?

Per un fornitore olandese che già riceve NLCIUS, la variante NLCIUS è di solito l'opzione più semplice. Scelga BIS Self-Billing 3.0 se il fornitore supporta esplicitamente quel profilo o opera a livello internazionale senza NLCIUS. In caso di dubbio, può usare queryRecipientParty per verificare quali tipi di documento la controparte supporta.

A cosa prestare attenzione con PDF e UBL nel self-billing?

La consegna UBL è preferita; in caso di UBL non valido, un PDF allegato può fungere da alternativa. Le versioni PDF devono riportare la dicitura obbligatoria "Fattura emessa dall'acquirente". Nel XML, AccountingSupplierParty rimane il fornitore (destinatario della fattura), anche se è l'acquirente a redigere il documento.


La PSB gestisce automaticamente l'instradamento e la validazione dei documenti self-billing. L'implementazione tecnica differisce per variante, ma in entrambi i casi il documento viene inviato tramite la PSB API e il fornitore lo riceve tramite la sua registrazione Peppol.

Apra il riferimento API