Valideer je XML voordat je iets via de API verstuurt. Dat kost een minuut en voorkomt dat je eerste sandbox-test strandt op een ontbrekend veld of een verkeerde BTW-berekening. eConnect biedt daarvoor een gratis online validator; dezelfde controles kun je later in je pipeline uitvoeren met de Validate API.

De eConnect Validator voert dezelfde soort controles uit die de PSB en het Peppol-netwerk bij verzending toepassen:

• XML-schema — klopt de structuur, zijn alle verplichte elementen aanwezig en correct genest?
• Schematron-regels — voldoet de inhoud aan de business rules van het profiel (BTW-berekeningen, verplichte velden, codelijsten)?
• Profielherkenning — het profiel (NLCIUS, BIS Billing V3, PINT, XRechnung, CII) wordt automatisch herkend op basis van de CustomizationID.
• Landspecifieke regels — per land gelden extra regels (voor Nederland de NL-R-regels), automatisch toegepast op basis van de landcode.

Een document dat hier zonder errors doorheen komt, wordt bij verzending vrijwel zeker geaccepteerd.

1. Pak een testbestand. Nog geen eigen XML? Kopieer een van de voorbeeldfacturen of download een variant bij Voorbeeldbestanden.
2. Open de Validator — geen account nodig.
3. Upload het bestand of plak de XML-inhoud.
4. Bekijk het rapport: per regel zie je of de controle slaagt, waarschuwt of faalt. Bij fouten krijg je de foutcode, een omschrijving en de locatie in het bestand (XPath).

Begin je met een ongewijzigd voorbeeldbestand, dan is het rapport groen. Pas daarna stap voor stap je eigen gegevens toe (partijen, bedragen, EndpointID) en valideer opnieuw; zo zie je direct welke wijziging een fout introduceert.

Foutcodes hebben een prefix die het domein aangeeft: BR- voor basisregels uit EN 16931, PEPPOL- voor Peppol-brede regels en NL-R- voor Nederlandse regels. Een uitgebreide toelichting op het interpreteren van meldingen staat in Factuur valideren.

Zodra je sandbox-credentials hebt, kun je dezelfde validatie geautomatiseerd uitvoeren met de Validate API: je stuurt het document in en ontvangt het validatierapport, zonder dat er iets wordt opgeslagen of verstuurd. Daarnaast valideert de PSB elk document nogmaals op het moment van verzending; bij fouten wordt de verzending geblokkeerd en ontvang je de validatieresultaten in de API-response.