Met deze gratis UBL-validator kan je UBL valideren in twee stappen: eerst tegen het schema van UBL 2.1, daarna tegen EN 16931 en Peppol BIS 3.0. De validator gebruikt de officiële Schematron-regels van OpenPeppol en CEN, en neemt elke nieuwe release automatisch over.
Sleep je XML-bestand hierheen of klik om een bestand te kiezen
UBL, CII of een ander e-factuurformaat (.xml, .p7m), of een pdf met ingesloten XML (Factur-X, ZUGFeRD). Het bestand blijft op je eigen computer.
UBL valideren in twee lagen
Een UBL-factuur kan op twee manieren fout zijn: in de vorm of in de inhoud. Daarom controleert de validator eerst het schema en daarna de regels.
- XML-schema (XSD): past het bestand in het officiële schema van UBL 2.1? Het gaat om de juiste elementen, in de juiste volgorde en met het juiste datatype.
- Businessregels (Schematron): klopt de inhoud met EN 16931 en Peppol BIS 3.0? Denk aan verplichte velden, codelijsten en berekeningen.
Een Access Point weigert een bestand dat niet aan het schema voldoet, nog voor de businessregels aan bod komen. Los daarom eerst de schemafouten op en valideer daarna opnieuw.
Veelvoorkomende schemafouten in UBL 2.1
Deze fouten zien we het vaakst bij een eigen UBL-export. Elk voorbeeld hebben we getest in de validator hierboven.
- Verkeerde volgorde: UBL legt de volgorde van de elementen vast. Zo hoort
cac:TaxTotalvóórcac:LegalMonetaryTotalte staan. - Tikfout in een elementnaam: het schema kent bijvoorbeeld geen
cbc:InvoiceTypecode. Hoofdletters tellen dus mee. - Verkeerd datatype: een datum schrijf je als
2026-10-09en een bedrag met een punt, zoals363.00. - Ontbrekende munt: elk bedrag heeft het attribuut
currencyIDnodig, bijvoorbeeldcurrencyID="EUR". - Ontbrekende namespace: zonder de declaratie van
cbcofcacbovenaan is het bestand zelfs geen geldige XML.
UBL of CII?
UBL en CII zijn de twee XML-syntaxen van de Europese norm EN 16931. Peppol BIS Billing 3.0, de standaard in België, gebruikt UBL. CII zie je vooral bij Factur-X en ZUGFeRD, en XRechnung kan beide. De validator herkent de syntax zelf. Meer uitleg over de Peppol-regels lees je bij de Peppol-validator. Een kant-en-klaar bestand om mee te testen vind je bij de testfacturen.
Welke regels controleert de UBL-validator?
- EN 16931 (CEN, UBL-syntax): de Europese kernregels voor elke e-factuur (BR-, BR-CO-, BR-S-, enz.)
- Peppol BIS Billing 3.0: de bijkomende Peppol-regels (PEPPOL-EN16931-R…) en de landspecifieke Peppol-regels (onder meer Nederland, Duitsland, Scandinavië, Italië en Griekenland)
- Peppol self-billing: voor facturen die de klant opmaakt in naam van de leverancier
- Andere Peppol BIS-documenten: bestelling, orderbevestiging, verzendbericht, catalogus en meer
Bij elke nieuwe release van OpenPeppol worden de regels automatisch opgehaald. Tijdens een overgangsperiode kan je ook nog tegen de vorige versie testen via Toon verouderde versies.
Fouten lezen en oplossen
Elke melding toont de regel-ID, de uitleg en de plaats in het bestand. Een fout (fatal) betekent dat een Access Point de factuur waarschijnlijk weigert. Een waarschuwing blokkeert niet, maar wijst op iets dat beter kan. Typische fouten zijn een ontbrekend btw-nummer van de koper, een totaal dat niet klopt met de lijnen, of een verkeerde btw-categorie bij een vrijstelling.
Kan je klant de factuur ook ontvangen?
Controleer met de Peppol-checker of de ontvanger op Peppol staat en welke documenttypes hij aanvaardt.
Veelgestelde vragen over de UBL-validator
Wat is het verschil tussen EN 16931 en Peppol BIS 3.0?
EN 16931 is de Europese norm met de kernregels voor e-facturen. Peppol BIS Billing 3.0 bouwt daarop verder met extra regels voor het Peppol-netwerk. Een geldige Peppol-factuur voldoet aan allebei.
Controleert de validator ook het XML-schema (XSD)?
Ja. De validator controleert eerst of het bestand voldoet aan het officiële schema (UBL 2.1, CII of het nationale schema), daarna de Schematron-regels van EN 16931 en Peppol. Beide controles gebeuren in je browser.
Hoe actueel zijn de regels?
We kijken elke week of OpenPeppol nieuwe regels heeft gepubliceerd en zetten die dan automatisch klaar. De gebruikte versie zie je in de keuzelijst bij elke validatie.
Ondersteunt de validator ook CII, XRechnung of ZUGFeRD?
Ja. De validator herkent CII-, XRechnung- en ZUGFeRD / Factur-X-facturen automatisch, ook de XML in een Factur-X-pdf. Onder ‘Geavanceerd’ kies je zelf een andere regelset. In België gebruikt Peppol wel UBL.