Voordat je een e-factuur verstuurt, wil je zeker weten dat het XML-bestand technisch correct is. De eConnect Validator controleert je factuur op XML-schema's, Schematron-regels en landspecifieke validaties. De tool is gratis beschikbaar als online validator.

De eConnect Validator voert meerdere controles uit op je e-factuurbestand:

XML-schemavalidatie. Klopt de basisstructuur van het bestand? Zijn alle verplichte XML-elementen aanwezig en correct genest?

Schematron-validatie. Voldoet de factuur aan de business rules van het gekozen profiel? Denk aan regels voor BTW-berekeningen, verplichte velden en codelijsten.

Profielcontrole. Het systeem herkent automatisch welk profiel je factuur volgt (BIS Billing V3, NLCIUS, PINT, XRechnung) en past de bijbehorende validatieregels toe.

Landspecifieke regels. Per land gelden aanvullende validatieregels. Voor Nederland zijn dat de NL-R regels, voor Duitsland de DE-R regels, voor Denemarken de DK-R regels, enzovoort. De validator past deze automatisch toe op basis van de landcode in de factuur.

De validator ondersteunt alle gangbare e-factuurformaten:

De online validator staat op /nl/validator. Je hoeft geen account aan te maken.

1. Open de Document Validator.
2. Upload je XML-bestand of plak de XML-inhoud.
3. De validator herkent automatisch het formaat en past de juiste regels toe.
4. Bekijk het resultaat: per regel zie je of de controle is geslaagd, een waarschuwing geeft of een fout bevat.

Bij fouten geeft de validator de exacte foutcode, een beschrijving van het probleem en de locatie in het XML-bestand (XPath). Zo weet je precies wat je moet aanpassen.

De validator geeft drie typen meldingen:

• Fout (error): de factuur voldoet niet aan de specificatie en wordt geweigerd op het Peppol-netwerk. Dit moet je oplossen voor verzending.
• Waarschuwing (warning): de factuur wordt niet geweigerd, maar er is een aandachtspunt. Waarschuwingen kunnen in een toekomstige release verplicht worden.
• Informatief: een opmerking zonder gevolgen voor de verzending.

Veelvoorkomende foutcodes beginnen met een prefix die het domein aangeeft: PEPPOL- voor Peppol-brede regels, NL-R- voor Nederlandse regels, BR- voor basisregels uit EN 16931. De foutbeschrijving geeft altijd aan wat het verwachte gedrag is.

Bij het versturen van een creditnota komen enkele specifieke validatiefouten regelmatig voor. De foutmelding verschijnt op Peppol-niveau (bij API-verzending bijvoorbeeld als [API400.AT04] Invalid payload). Per regel de oorzaak en oplossing:

BR-IC-11 en BR-IC-12 zijn EN 16931-basisregels die uitsluitend gelden wanneer de creditnota een intracommunautaire BTW-categorie bevat; voor binnenlandse leveringen treden ze niet op.

Een factuur kan op twee niveaus een periode bevatten: een factuurperiode op documentniveau (BG-14) en een regelperiode per factuurregel (BG-26, voor terugkerende diensten of abonnementen op regelniveau). Wanneer beide worden gebruikt, eist Peppol dat elke regelperiode binnen de overkoepelende factuurperiode valt. De volgende fouten verschijnen als die voorwaarde niet klopt:

De onderliggende controle van R110 is dat de regelperiode-startdatum gelijk is aan of later dan de factuurperiode-startdatum. Komt de fout terug terwijl de regelperiode klopt, controleer dan of het probleem op het documentniveau zit: óf de factuurperiode (BT-73) is te laat ingesteld, óf de regelperiode is per ongeluk ruimer dan bedoeld. Beide periodes moeten elkaar omvatten: de factuurperiode is de buitenste grens, elke regelperiode valt daarbinnen.

BR-30 (EN 16931) is een andere regel dan R110/R111: R110/R111 toetsen of de regelperiode binnen de factuurperiode valt, BR-30 toetst alleen de volgorde van twee aanwezige regelperiodedatums (BT-135 groter dan of gelijk aan BT-134).

Aanvullende periode-regels die in dezelfde context kunnen optreden:

• BR-CO-19 / BR-CO-20: als een factuurperiode (BG-14) respectievelijk regelperiode (BG-26) wordt gebruikt, moet ten minste de startdatum óf de einddatum zijn ingevuld (één van beide volstaat, beide mag ook).
• PEPPOL-EN16931-F001: alle datums moeten als YYYY-MM-DD worden geformatteerd.

Deze regels gelden voor zowel facturen (ubl:Invoice) als creditnota's (ubl:CreditNote).

Naast de handmatige validator voert het eConnect-platform ook automatisch validatie uit op het moment van verzending. Als een factuur niet voldoet aan de vereisten, wordt de verzending geblokkeerd en krijg je een foutmelding met de betreffende validatieregel.

Voor API-gebruikers: de PSB valideert elke factuur bij het instuurmoment en retourneert de validatieresultaten in de API-response. Zo kun je validatie ook inbouwen in je eigen softwareproces.

De validatieregels worden bijgewerkt bij elke nieuwe release van de Peppol BIS Billing-specificatie. eConnect werkt de Schematron-artefacten en codelijsten bij zodra een nieuwe versie verplicht wordt. De online validator valideert altijd tegen de actuele release.

Tip: controleer na een specificatie-update of je facturen nog steeds valide zijn. Nieuwe regels kunnen strengere eisen stellen aan velden die eerder optioneel waren.

Tip: softwarepakketten die "UBL Ready" zijn gecertificeerd (via de UBL Ketentest van Onderzoeksbureau GBNED), hebben aangetoond dat hun UBL-output technisch correct is. Krijg je toch validatiefouten van zo'n pakket? Vraag dan de softwareleverancier om het probleem te onderzoeken.

Wil je voorbeeldbestanden bekijken om je eigen XML-opbouw te controleren? Download voorbeeldbestanden.