Peppol-foutcodes

Peppol-foutcodes en validatiefouten: uitleg en oplossing

Op deze pagina leggen we de meest voorkomende Peppol-foutcodes uit. Weigerde een Access Point je e-factuur, of toont de validator een melding als BR-CO-15 of PEPPOL-EN16931-R120? Dan vind je hier per foutcode wat ze betekent, waar ze vandaan komt en hoe je ze oplost. Bovendien controleren we elke uitleg met de officiële Peppol-regels en een echte testfactuur.

De meest voorkomende Peppol-foutcodes en validatiefouten

Peppol-foutcodes over berekeningen en totalen

Deze regels (BR-CO-) rekenen de factuur na. Een verschil van één cent geeft dus al een fout.

Peppol-foutcodes over verplichte gegevens

Deze basisregels (BR-) controleren bijvoorbeeld of het factuurnummer, de datum en de partijen ingevuld zijn.

Peppol-foutcodes over btw-categorieën en codelijsten

Deze regels gaan onder meer over verlegging, vrijstelling, codes en decimalen.

Waarschuwingen over UBL-elementen

Deze regels (UBL-CR-) houden de factuur niet tegen, maar wijzen op elementen die de ontvanger mag negeren.

Peppol-foutcodes over het document, de partijen en het Peppol-adres

Deze regels (PEPPOL-) gelden enkel op het Peppol-netwerk. Ze controleren onder meer het proces, de notities, de referentie van de koper en het Peppol-adres.

Peppol-foutcodes over bedragen, prijzen en factuurlijnen

Ook deze regels gelden enkel op het Peppol-netwerk. Ze gaan vooral over lijnbedragen, kortingen, btw-totalen en periodes.

Van Europese norm tot Peppol: vier lagen

Access Points controleren een Peppol-factuur in lagen. Elke laag bouwt voort op de vorige en mag de regels alleen strenger maken, nooit soepeler. Daarom kan Peppol een factuur die perfect voldoet aan de Europese norm, toch weigeren. Bovendien vertelt het begin van de foutcode in welke laag het probleem zit.

1. De Europese norm EN 16931

Het semantische model: welke gegevens een e-factuur bevat (de BT- en BG-nummers) en de businessregels die voor elke Europese e-factuur gelden.

Begint metGaat overMeestal
BR-Verplichte velden en basisregels, zoals factuurnummer, datum en partijenfout
BR-CO-Berekeningen en samenhang tussen velden (totalen, btw)fout
BR-CL-Codelijsten: landcodes, munten, eenheden, bestandstypesfout
BR-DEC-Aantal decimalen: bedragen hebben er maximaal tweefout
BR-S-, BR-Z-, BR-E-, BR-AE-, BR-IC-, BR-G-, BR-O-Regels per btw-categorie: standaardtarief, nultarief, vrijstelling, verlegging, intracommunautaire levering, export buiten de EU, niet onderworpenfout
BR-AF-, BR-AG-, BR-B-Bijzondere btw-stelsels: Canarische Eilanden (IGIC), Ceuta en Melilla (IPSI), Italiaanse split paymentfout

2. De syntaxis: UBL

De norm zegt welke gegevens er moeten zijn, UBL 2.1 zegt hoe ze in XML staan. Deze regels controleren of de norm correct in UBL is uitgedrukt.

Begint metGaat overMeestal
UBL-SR-Syntaxregels, zoals elementen die maar één keer mogen voorkomenfout
UBL-DT-Datatypes en attributen, zoals decimalen en verplichte attributenfout of waarschuwing
UBL-CR-UBL-elementen die de norm niet gebruikt: ze horen niet in de factuurwaarschuwing

3. Peppol BIS Billing 3.0

De afspraken van OpenPeppol voor facturen op het Peppol-netwerk: een strengere invulling van de norm (een CIUS). Hier zitten de meeste fouten die specifiek zijn voor Peppol.

Begint metGaat overMeestal
PEPPOL-EN16931-RExtra regels bovenop de norm, zoals de referentie van de koper, het Peppol-adres en lijnbedragenfout of waarschuwing
PEPPOL-EN16931-CLPeppol-codelijsten, zoals het schema van het Peppol-adres en bestandstypesfout
PEPPOL-EN16931-PProfiel en documenttype: de factuurtypecode moet passen bij het profielfout
PEPPOL-EN16931-FFormaat: een datum staat als JJJJ-MM-DDfout
PEPPOL-COMMON-RIdentificatienummers, zoals het Belgische ondernemingsnummer (0208)fout of waarschuwing

4. Nationale regels in Peppol BIS

Enkele landen hebben extra regels in Peppol BIS. Ze gelden enkel als de leverancier (en soms ook de klant) in dat land gevestigd is. België heeft geen eigen regels in Peppol BIS.

Begint metGaat overMeestal
NL-R-, DE-R-, DK-R-, SE-R-, NO-R-, IT-R-, GR-R-, IS-R-Nederland, Duitsland, Denemarken, Zweden, Noorwegen, Italië, Griekenland en IJslandfout of waarschuwing

Nog vóór deze vier lagen controleert een Access Point of het bestand een geldig UBL-document is (het XML-schema). Zo’n fout heeft geen regelcode, maar een technische melding over een element of de volgorde.

Fout of waarschuwing?

Een fout (fatal) betekent dat de factuur niet conform is: het Access Point van de verzender of ontvanger weigert ze. Een waarschuwing (warning) houdt de factuur niet tegen, maar wijst op iets dat beter kan of dat de ontvanger kan storen. Los fouten dus altijd op, en kijk daarna de waarschuwingen na.

Staat jouw foutcode er niet bij?

Controleer eerst je factuur in de gratis validator. Bij elke melding staat een link naar de officiële regel en, waar we die al hebben, naar onze uitleg. Daarnaast staan de officiële regelteksten op docs.peppol.eu. We breiden deze lijst uit op basis van de fouten die het vaakst opduiken.

Factuur controleren?

De gratis validator toont alle fouten en waarschuwingen, met een link naar de uitleg bij elke melding. Je bestand blijft op je eigen computer.

Veelgestelde vragen over Peppol-foutcodes

Waarom staan de meldingen in het Engels?

De officiële regels van EN 16931 en Peppol BIS Billing 3.0 zijn in het Engels opgesteld. Elke validator en elk Access Point toont dezelfde tekst. Op deze pagina’s leggen we ze uit in gewone taal.

Wie moet de fout oplossen: de verzender of de ontvanger?

Altijd de verzender. Een ontvanger mag een niet-conforme factuur niet zelf aanpassen. Vraag een gecorrigeerde factuur aan de leverancier.

Mijn boekhoudpakket zegt dat de factuur goed is. Waarom geeft de validator toch een fout?

Sommige pakketten controleren alleen het XML-schema, niet de businessregels (Schematron). Een Access Point controleert beide. Onze validator gebruikt dezelfde officiële regels als de Access Points.

Zijn de regels nog actueel?

Ja. We gebruiken de officiële Peppol-release van mei 2026. Elke voorbeeldfout op deze pagina’s is met die regels getest. Wat er per release veranderde, lees je bij de wijzigingen in de Peppol-regels.