Belangrijke verzendvelden in een UBL-factuur

De velden die bepalen waar je factuur naartoe gaat: EndpointID, CompanyID en hun prioriteit.

Bij het versturen van een e-factuur via Peppol bepalen specifieke velden in de UBL-structuur waar het document naartoe wordt gerouteerd. Het correct invullen van deze velden is cruciaal: een fout in de routeringsvelden kan ertoe leiden dat je factuur niet aankomt of bij de verkeerde partij belandt.

Routeringsprioriteit

De eConnect PSB gebruikt de volgende velden om de ontvanger te bepalen, in aflopende prioriteit:

PrioriteitXML-padDoel1 (hoogst)cac:AccountingCustomerParty/cac:Party/cbc:EndpointIDPrimaire Peppol-routering2cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyIDJuridische identifier (KvK, OIN)3cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyIDBTW-nummer

Het systeem begint bij prioriteit 1 en controleert of de identifier is geregistreerd op het Peppol-netwerk (via een SMP-lookup). Als dat het geval is, wordt de factuur via Peppol afgeleverd. Zo niet, dan wordt het volgende veld in de prioriteitsvolgorde geprobeerd.

EndpointID: het belangrijkste veld

Het EndpointID is het primaire routeringsveld in Peppol BIS Billing V3. Dit veld bevat de Peppol-identifier van de ontvanger, inclusief het schemeID dat aangeeft welk type identifier wordt gebruikt.

<cac:AccountingCustomerParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0106">12345678</cbc:EndpointID>
  </cac:Party>
</cac:AccountingCustomerParty>

In dit voorbeeld wordt gerouteerd op KvK-nummer 12345678 (schemeID 0106). De PSB zoekt dit nummer op in de SMP en levert de factuur af bij het bijbehorende Access Point.

Belangrijk: het EndpointID is verplicht in Peppol BIS Billing V3. Een lege waarde of het ontbreken van dit element leidt tot een validatiefout. Gebruik altijd een geldig identificatienummer.

Tip: Wil je precies bepalen naar welke organisatie je factuur gaat? Vul dan het EndpointID in met de identifier die de ontvanger op Peppol heeft geregistreerd. Zonder EndpointID wordt teruggevallen op het KvK-nummer uit CompanyID.

CompanyID: de juridische identifier

Als het EndpointID niet is gevuld of de identifier niet is gevonden op Peppol, kijkt de PSB naar het CompanyID-veld binnen PartyLegalEntity. Dit bevat doorgaans het KvK-nummer of OIN:

<cac:PartyLegalEntity>
  <cbc:CompanyID schemeID="0106">12345678</cbc:CompanyID>
</cac:PartyLegalEntity>
PartyTaxScheme: het BTW-nummer

Als ook het CompanyID geen Peppol-registratie oplevert, wordt het BTW-nummer uit PartyTaxScheme gebruikt als laatste routeringsoptie via het netwerk:

<cac:PartyTaxScheme>
  <cbc:CompanyID>NL123456789B01</cbc:CompanyID>
</cac:PartyTaxScheme>
E-mail als fallback

Als geen van de bovenstaande identifiers een Peppol-registratie oplevert, kan de factuur via e-mail worden afgeleverd. Het platform zoekt hiervoor een e-mailadres in de volgende velden:

  1. cac:AccountingCustomerParty/cac:Party/cac:Contact/cbc:ElectronicMail
  2. cac:AccountingCustomerParty/cac:AccountingContact
  3. cac:AccountingCustomerParty/cac:BuyerContact

Meerdere e-mailadressen (komma- of puntkomma-gescheiden) worden ondersteund en worden als To + CC verstuurd.

Contactgegevens van de verzender

Het Contact-element van de verzender (AccountingSupplierParty) is ook functioneel belangrijk. Als het ElectronicMail-veld van de leverancier niet is ingevuld, voegt eConnect automatisch [email protected] toe. Dit zorgt ervoor dat afgewezen facturen (Invoice Response berichten) toch bij de verzender terechtkomen en doorgestuurd kunnen worden.

Tip: Vul altijd het e-mailadres van je organisatie in bij het leverancierscontact. Zo ontvang je afwijzingsberichten rechtstreeks in je eigen mailbox.

Veelvoorkomende fouten
FoutGevolgOplossingEndpointID leeg of ontbrekendValidatiefout bij Peppol BIS V3Vul altijd een geldig EndpointID inVerkeerd schemeIDFactuur wordt niet gevonden op PeppolGebruik 0106 voor KvK, 0190 voor OIN"NA" als identifier-waardeRouteringsfoutGebruik altijd een echt identificatienummerGeen e-mailadres bij ontvangerGeen fallback als Peppol-routering faaltVul het ElectronicMail-veld in als e-mail fallback
Veelgestelde vragen
Wat als ik niet weet welke identifier de ontvanger heeft geregistreerd?

Gebruik de queryRecipientParty-functie in de PSB API of zoek de organisatie op in de Peppol Directory. Beide tonen welke identifiers een organisatie op Peppol heeft geregistreerd en welke documenttypen zij ondersteunen.

Kan een factuur via e-mail worden afgeleverd als Peppol-routering mislukt?

Ja. Als geen van de identifiers een Peppol-registratie oplevert, zoekt het platform een e-mailadres in het ElectronicMail-veld van de ontvanger. De factuur wordt dan via e-mail afgeleverd als fallback.

Welk schemeID moet ik gebruiken voor Nederlandse ontvangers?

Voor bedrijven gebruik je schemeID 0106 (KvK-nummer). Voor overheidsorganisaties is schemeID 0190 (OIN) verplicht. Het BTW-nummer (9944) is een aanvullende identifier maar niet de primaire routeringsidentifier.


Twijfel je welke identifier bij een specifieke ontvanger is geregistreerd? Zoek de organisatie op in de Peppol Directory of gebruik de queryRecipientParty-functie in de PSB-API.

Download voorbeeldbestanden

Gerelateerd