Self-billing via de API

Self-billing (reverse billing) end-to-end via de PSB API: de twee varianten, registratie en keuze tussen NLCIUS en BIS.

Self-billing (zelffacturering, ook wel reverse billing genoemd) is het proces waarbij de koper de factuur opstelt namens de leverancier. Dit komt voor in sectoren waar de koper het geleverde nauwkeuriger kan berekenen dan de leverancier, bijvoorbeeld in de uitzendbranche of bij ingehuurde diensten. De PSB ondersteunt self-billing in twee varianten, elk met eigen technische kenmerken.

Twee varianten

De PSB biedt twee manieren om self-billing facturen te verzenden via het Peppol-netwerk:

1. NLCIUS / SI-UBL 2.0 (vereenvoudigd)

Bij deze variant wijzig je alleen het InvoiceTypeCode in je bestaande NLCIUS-factuur:

  • InvoiceTypeCode 389 voor een self-billing factuur
  • InvoiceTypeCode 261 voor een self-billing creditnota

De CustomizationID en ProfileID blijven identiek aan die van een reguliere NLCIUS-factuur. De PSB herkent automatisch het documenttype op basis van de InvoiceTypeCode en routeert het document correct. Als de leverancier al geregistreerd is voor ontvangst van reguliere NLCIUS-facturen, is geen extra registratie nodig.

Dit is de eenvoudigste variant en geschikt voor de meeste Nederlandse integraties.

2. Peppol BIS Self-Billing 3.0

Dit is een apart Peppol-profiel met eigen identifiers:

VeldWaardeCustomizationIDurn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0ProfileIDurn:fdc:peppol.eu:2017:poacc:selfbilling:3.0InvoiceTypeCode389 (factuur) of 261 (creditnota)

Bij deze variant moet de leverancier apart geregistreerd zijn in de Peppol SMP voor het ontvangen van self-billing documenten. De koper (verzender) verstuurt het document via het Generic endpoint van de PSB.

Gebruik deze variant als de leverancier expliciet het BIS Self-Billing 3.0-profiel ondersteunt, of als de ontvanger zich buiten Nederland bevindt en geen NLCIUS accepteert.

Welke variant kiezen?
SituatieAanbevelingNederlandse leverancier, al geregistreerd voor NLCIUSNLCIUS (variant 1)Internationale leverancier of expliciete BIS Self-Billing-ondersteuningBIS Self-Billing 3.0 (variant 2)Onzeker over de capabilities van de leverancierControleer via queryRecipientParty
Capabilities controleren

Voordat je een self-billing factuur verstuurt, controleer je of de leverancier het gewenste documenttype kan ontvangen:

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

De response bevat de ondersteunde documenttypen van de leverancier. Controleer of het self-billing profiel (BIS Self-Billing 3.0) of het standaard factuurprofiel (NLCIUS) beschikbaar is.

Verzenden en ontvangen

De technische details voor het verzenden en ontvangen van self-billing facturen staan in aparte artikelen:

Praktische aandachtspunten
  • Bij self-billing is de koper de opsteller en verzender van de factuur, terwijl de leverancier de ontvanger is. Dit is het omgekeerde van een reguliere factuur.
  • Op PDF-versies van self-billing facturen is de tekst "Factuur uitgereikt door afnemer" verplicht.
  • UBL-aanlevering heeft altijd de voorkeur boven PDF. Bij ongeldige UBL wordt een eventueel meegestuurde PDF als fallback opgepakt.
  • Het AccountingSupplierParty-element bevat de gegevens van de leverancier (die de factuur "ontvangt"), niet van de koper die de factuur opstelt.
Veelgestelde vragen
Wat is het verschil tussen de NLCIUS- en de BIS Self-Billing 3.0-variant?

Bij NLCIUS wijzig je vooral het InvoiceTypeCode naar 389 (factuur) of 261 (creditnota); CustomizationID en ProfileID blijven gelijk aan reguliere NLCIUS. BIS Self-Billing 3.0 gebruikt vaste CustomizationID- en ProfileID-waarden voor het self-billing-profiel en vereist dat de leverancier in de SMP voor dat profiel is geregistreerd; verzenden gaat via het Generic endpoint.

Hoe kies ik welke variant ik moet gebruiken?

Voor een Nederlandse leverancier die al NLCIUS ontvangt is de NLCIUS-variant meestal het eenvoudigst. Kies BIS Self-Billing 3.0 als de leverancier dat profiel expliciet ondersteunt of internationaal werkt zonder NLCIUS. Bij twijfel kun je met queryRecipientParty zien welke documenttypen de tegenpartij ondersteunt.

Waar moet ik op letten bij PDF en UBL bij self-billing?

UBL-levering heeft de voorkeur; bij ongeldige UBL kan een meegestuurde PDF als fallback worden gebruikt. Op PDF-versies hoort de verplichte tekst "Factuur uitgereikt door afnemer". In het XML blijft AccountingSupplierParty de leverancier (ontvanger van de factuur), ook al stelt de koper het document op.


De PSB handelt de routering en validatie van self-billing documenten automatisch af. De technische implementatie verschilt per variant, maar in beide gevallen verzend je het document via de PSB API en ontvangt de leverancier het via zijn Peppol-registratie.

Open de API-referentie

Gerelateerd