Come fornitore riceve fatture self-billing dai Suoi acquirenti. L'acquirente emette la fattura per Suo conto e la invia tramite la rete Peppol. Questo articolo descrive quale registrazione è necessaria e come elaborare i documenti ricevuti.

Le fatture self-billing vengono consegnate allo stesso modo delle fatture d'acquisto regolari. La PSB invia una notifica webhook e il documento può essere scaricato tramite l'endpoint PurchaseInvoice. La differenza sta nella registrazione e nel tipo di documento.

Il flusso di ricezione:

1. L'acquirente invia una fattura self-billing (InvoiceTypeCode 389) tramite la PSB
2. La rete Peppol instrada il documento verso il Suo Access Point
3. La PSB invia un evento InvoiceReceived al Suo webhook
4. Lei scarica e elabora il documento

Per poter ricevere fatture self-billing, la Sua organizzazione deve essere registrata nel Peppol SMP. La registrazione necessaria dipende dalla variante:

Se è già registrato per la ricezione di fatture NLCIUS regolari, non è necessario fare nulla di aggiuntivo. Le fatture self-billing con InvoiceTypeCode 389 vengono consegnate tramite lo stesso profilo. La PSB riconosce automaticamente il tipo di documento.

Per il profilo BIS Self-Billing 3.0 è necessaria una registrazione separata. Questo profilo ha un proprio CustomizationID e ProfileID e richiede una configurazione SMP specifica.

Configuri la capability self-billing tramite la Peppol config API:

PUT /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "selfBilling": {
    "state": "on"
  }
}

Senza questa registrazione, gli acquirenti che utilizzano il profilo BIS Self-Billing 3.0 non possono trovarLa tramite un Peppol SMP lookup.

Utilizzi lo stesso topic delle fatture d'acquisto regolari:

{
  "action": "https://mijn-systeem.nl/webhook/invoices#mijnSecretKey",
  "topics": ["InvoiceReceived"]
}

Le fatture self-billing arrivano come eventi InvoiceReceived. Può distinguerle dalle fatture regolari controllando l'InvoiceTypeCode nel documento XML: 389 per una fattura self-billing, 261 per una nota di credito self-billing.

Scarichi il documento allo stesso modo di una fattura d'acquisto regolare:

GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}

Opzionalmente può richiedere il documento in un altro formato con targetDocumentTypeId se il Suo sistema lo richiede.

Dopo il download può verificare nel documento XML se si tratta di una fattura self-billing:

<!-- InvoiceTypeCode 389 = self-billing factuur -->
<InvoiceTypeCode>389</InvoiceTypeCode>

<!-- InvoiceTypeCode 261 = self-billing creditnota -->
<InvoiceTypeCode>261</InvoiceTypeCode>

In una fattura self-billing l'AccountingSupplierParty è la Sua organizzazione (il fornitore), mentre l'AccountingCustomerParty è l'acquirente che ha emesso la fattura.

Dopo la ricezione può inviare un Invoice Response all'acquirente per confermare l'elaborazione o rifiutare la fattura. Il flusso è identico a quello per le fatture regolari:

POST /api/v1/{partyId}/purchaseInvoice/{documentId}/response HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "status": "AP",
  "clarificationCode": "NON",
  "actionCode": "NOA"
}

Consulti Inviare un Invoice Response per la panoramica completa dei codici di stato e dei clarification code.

Le regole di retention per i documenti self-billing sono le stesse delle fatture d'acquisto regolari: 90 giorni di conservazione dopo la ricezione, 7 giorni dopo il download. Recuperi i documenti tempestivamente e li salvi nel Suo sistema.

Se come fornitore riceve NLCIUS o BIS Self-Billing 3.0 dipende da cosa invia l'acquirente. Si assicuri di avere la registrazione SMP corretta per le varianti utilizzate dai Suoi acquirenti. In caso di dubbio: si registri per entrambe.