Elke factuur die je via de PSB API verstuurt is een XML-document in een gestandaardiseerd formaat. Deze pagina vat samen wat je als ontwikkelaar over die formaten moet weten om te kunnen starten: welk formaat je kiest, hoe de PSB ermee omgaat en waar de volledige specificaties staan. De inhoudelijke achtergrond (semantiek, velden, compliance per land) staat onder Leren → Documentformaten.

Vrijwel elke Nederlandse integratie begint met een van deze twee formaten. Beide zijn gebaseerd op UBL 2.1 en de Europese norm EN 16931; het verschil zit in het profiel (de CIUS) dat aanvullende regels oplegt.

De CustomizationID in je XML bepaalt tegen welk profiel wordt gevalideerd. Zet je die verkeerd, dan valideert je document tegen de verkeerde regelset en wordt het geweigerd.

Vuistregel voor je keuze: verstuur je uitsluitend binnen Nederland, gebruik NLCIUS. Verstuur je (ook) internationaal, gebruik BIS Billing 3.0. Twijfel je, begin dan met NLCIUS: de PSB transformeert automatisch naar wat de ontvanger verwacht.

Je hoeft niet elk formaat zelf te implementeren. De PSB herkent het aangeleverde formaat en transformeert het waar nodig naar het formaat dat de ontvanger verwacht — bijvoorbeeld van NLCIUS naar XRechnung voor een Duitse overheidsontvanger. De conversie loopt via het gedeelde semantische model van EN 16931. In de praktijk betekent dit:

• Eén uitvoerformaat in je eigen software volstaat voor de meeste scenario's.
• Aanleveren in een correct, valide formaat blijft jouw verantwoordelijkheid — transformatie repareert geen validatiefouten.
• Voor conversie in je eigen pipeline (zonder verzending) is er de Transform API.

Voor internationale scenario's en specifieke sectoren ondersteunt de PSB onder meer:

Het volledige overzicht met 25+ formaatartikelen staat onder Formaten.

1. Kies je formaat op basis van je ontvangers (zie vuistregel hierboven).
2. Neem een voorbeeldbestand als vertrekpunt — de voorbeeldfacturen tonen complete, valide XML voor NLCIUS en BIS Billing 3.0 inline; meer varianten staan bij Voorbeeldbestanden.
3. Bouw je eigen XML en let vooral op CustomizationID, EndpointID (bepaalt de ontvanger), BTW-totalen en de gebruikte codelijsten. Veldniveau-uitleg staat in Opbouw van een UBL-factuur en de praktijkartikelen (BTW-verlegd, creditnota's, kortingen, G-rekening).
4. Valideer voordat je verstuurt — zie Je eerste bestand valideren.