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.
De PSB biedt twee manieren om self-billing facturen te verzenden via het Peppol-netwerk:
Bij deze variant wijzig je alleen het InvoiceTypeCode in je bestaande NLCIUS-factuur:
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.
Dit is een apart Peppol-profiel met eigen identifiers:
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0389 (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.
queryRecipientPartyVoordat 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.
De technische details voor het verzenden en ontvangen van self-billing facturen staan in aparte artikelen:
AccountingSupplierParty-element bevat de gegevens van de leverancier (die de factuur "ontvangt"), niet van de koper die de factuur opstelt.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.
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.
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