UBL/Peppol-factuurvalidator

Controleer de structuur voordat het netwerk het voor je doet

De dure manier om erachter te komen dat een factuurbestand kapot is, is hem versturen: hij reist naar je klant of een toegangspunt, wordt uren of dagen later afgewezen, en de betalingsklok begint opnieuw. De goedkope manier is eerst dertig seconden hier. Deze validator beantwoordt de botte, nuttige vragen: is het bestand überhaupt wel goedgevormde XML, is het echt een UBL-factuur, en zijn de velden aanwezig die elke leesbare factuur nodig heeft — nummer, datums, beide partijen, regels en totalen. Bestanden worden gecontroleerd in het servergeheugen en meteen daarna weggegooid, wat de gepaste manier is om een document met namen, bedragen en bankgegevens te behandelen. Hij verdient zijn plaats vooral in twee situaties: een klein bedrijf dat zijn eerste UBL-facturen genereert vanuit een sjabloon of een onbekende ERP-module, en een ontwikkelaar die een exportpijplijn test en snel een onafhankelijke mening over de uitvoer wil voordat hij ermee richting het echte netwerk gaat.

Wat een structurele check is — en wat Schematron is

Eerlijkheid is hier belangrijk. De officiële Peppol BIS Billing 3.0-validatie is een Schematron-regelset: honderden bedrijfsregels die controleren of bijvoorbeeld btw-categoriecodes consistent zijn en of de belastingtotalen optellen tot de regeltotalen. Deze tool voert die regels niet uit. Lees de twee uitkomsten daarnaar: een mislukking hier is definitief — een bestand dat niet parseert, of verplichte velden mist, zal overal falen, dus fix het voordat je het verstuurt. Een geslaagd resultaat hier betekent dat de structuur bruikbaar is, niet dat aan elke bedrijfsregel is voldaan; het netwerk kan het nog steeds afwijzen wegens een schending op regelniveau. Eerst structureel, daarna Schematron, is de natuurlijke volgorde van controleren. De grens is bewust, niet lui: de officiële regelsets zijn geversioneerd en centraal onderhouden, en ze correct uitvoeren is de taak van de Peppol-infrastructuur zelf — dat slecht nabootsen zou je slechter dienen dan de grens gewoon eerlijk benoemen.

De mislukkingen die we in de praktijk zien

De meeste afgewezen bestanden vallen in een handjevol patronen. Het bestand is een creditnota in plaats van een factuur — een ander UBL-documenttype dat deze validator nog niet dekt. Het is een Factur-X-PDF in plaats van rauwe XML — de factuur zit ingesloten in een PDF en moet eerst geëxtraheerd worden met de Factur-X-tool op deze site. Hij is ergens onderweg via e-mail afgekapt of opnieuw gecodeerd, waardoor de XML niet meer parseert. Of een ERP-export liet verplichte partij- of totaalvelden leeg omdat een stamgegevensrecord onvolledig was. De validator benoemt wat er ontbreekt, wat meestal rechtstreeks aanwijst welke van deze het was. Een subtielere variant is de moeite waard om te kennen: een bestand dat in een teksteditor prima opent, kan alsnog niet parseren omdat een e-mailgateway of een kopieer-plak-stap de tekencodering veranderde — onzichtbaar voor het oog, fataal voor XML. Exporteer opnieuw vanuit het bronsysteem in plaats van met de hand te repareren.

Dezelfde parser als de PDF-renderer — en wanneer je je leverancier moet bellen

Deze validator deelt zijn parser, regel voor regel, met de tool UBL/Peppol-factuur naar PDF hier op de site. Dat levert je een betrouwbare kleine werkwijze op: valideer het bestand, render het vervolgens en lees de factuur zoals een mens dat zou doen — een verkeerd IBAN of een absurd totaal is vaak makkelijker te herkennen op een pagina dan in XML. En weet waar de grens ligt: slaagt een bestand hier, rendert het netjes, en wordt het toch afgewezen door het Peppol-netwerk, dan zit het probleem op het niveau van bedrijfsregels of transmissie. Dat gesprek hoort bij je toegangspunt of softwareleverancier, die het officiële validatierapport kan inzien — neem hun foutmelding mee, want die noemt de exacte regel die geactiveerd werd.

Wat er precies gecontroleerd wordt

Dit bevestigt dat het bestand welgevormde XML is, een UBL-Invoice-root heeft, en de velden bevat die een leesbare factuur nodig heeft: een factuurnummer, datums, leverancier- en klantpartijen, factuurregels en totalen. Het is een structurele sanity-check, geen officiële Peppol BIS Billing 3.0 Schematron-validatie — niet elke schending van een bedrijfsregel wordt opgemerkt (bijvoorbeeld btw-totalen die niet correct optellen), enkel of de structuur op zich bruikbaar is.