Validatie en correctie

Automatische validatie van e-facturen tegen landspecifieke regels en correctie van veelvoorkomende fouten voordat documenten het netwerk opgaan.

Plan een kennismaking

API-documentatie

hoe het werkt
Validatie vóór verzending: geen afwijzingen achteraf

Een e-factuur die het netwerk niet haalt, kost tijd en vertrouwen. De PSB van eConnect valideert elk document automatisch voordat het het netwerk opgaat. Dat geldt voor XSD-schema's (structuurcontrole) én business rules (inhoudelijke validatieregels per standaard en per land).

De validatie werkt met een dubbele laag: het document wordt gecontroleerd tegen de meest recente artefacten én, indien van toepassing, tegen de vorige versie die nog op het netwerk wordt geaccepteerd. Zo zie je direct of een document verstuurd kan worden en of een upgrade noodzakelijk is.

Alle validatiemeldingen zijn beschikbaar in het Nederlands en Engels via de X-EConnect-Language header.

Structuurvalidatie (XSD)

Controle van de XML-structuur: zijn alle verplichte velden aanwezig en correct geformatteerd?

Business rules

Controle van inhoudelijke regels: kloppen berekeningen, zijn identifier-codes geldig en zijn veldcombinaties logisch?

Landspecifieke regels

Extra validatieregels per land en standaard, zoals NLCIUS, XRechnung of BIS Billing V3.

validatielagen
Twee validatielagen, één resultaat

Elk document doorloopt twee onafhankelijke validatiestappen vóór verzending.

standalone validator
Standalone Validate API en gratis online tool

Naast de automatische validatie bij verzending biedt eConnect een standalone Validate API. Via POST /api/v1/generic/validate valideer je een XML-document zonder het op te slaan of te verzenden. Er worden geen kosten in rekening gebracht en er worden geen webhooks getriggerd.

Het documentformaat wordt automatisch herkend op basis van de XML-inhoud. Je hoeft niet op te geven of het NLCIUS, BIS Billing V3 of een ander formaat is.

De validator is ook beschikbaar als gratis online tool op econnect.eu/nl/validator, zonder account, direct bruikbaar voor ontwikkelaars en implementatiepartners.

Ga naar de gratis validator

klantspecifieke regels
Klantspecifieke en branchegebonden regels

Standaard validatieregels dekken de generieke eisen van Peppol en de nationale standaarden. Voor organisaties met extra eisen (brancheregels, interne boekhoudvereisten of klantspecifieke controles) ondersteunt de Validate API aangepaste regelsets.

Via de parameter ?optionId={id} activeer je een vooraf gedefinieerde set validatieregels. Beschikbare opties zijn op te vragen via GET /api/v1/generic/validate/options. Zo valideer je niet alleen tegen de standaard, maar ook tegen de specifieke eisen van jouw sector of klant.

Automatische formaatdetectie

De Validate API herkent het documentformaat automatisch bij elke validatieaanroep.

Gratis online validator

Test documenten direct via de online validator op econnect.eu, geen account vereist.

NL en EN foutmeldingen

Validatiemeldingen zijn beschikbaar in het Nederlands en Engels.

Technische kenmerken
Veelgestelde vragen over validatie en correctie
Wat wordt er precies gevalideerd?

De PSB valideert elk document op twee niveaus: de XSD-structuur (zijn alle velden aanwezig en correct opgebouwd?) en de business rules (kloppen berekeningen, zijn identifier-codes uit de juiste codelijsten en zijn veldcombinaties inhoudelijk logisch?). Daarboven komen landspecifieke regels, zoals de extra NLCIUS-eisen voor Nederlandse facturatie aan de overheid.

Wanneer wordt een factuur tegengehouden?

Een factuur wordt tegengehouden als de validatie een error oplevert: een structuurprobleem of een overtreding van een business rule. Warnings worden gerapporteerd maar blokkeren de verzending niet. Je ontvangt een gedetailleerde assertion-lijst met per bevinding de vlag (error, warning, success), de regelnaam en een beschrijving.

Kan ik documenten valideren zonder ze te verzenden?

Ja. Via de standalone Validate API (POST /api/v1/generic/validate) valideer je XML-documenten zonder opslag of verzending. Er worden geen kosten in rekening gebracht. De gratis online validator op econnect.eu/nl/validator doet hetzelfde zonder API-integratie, handig voor testen tijdens implementatie.

Hoe werkt de dubbele validatielaag?

Het document wordt gecontroleerd tegen de meest recente validatieartefacten én, indien van toepassing, tegen de vorige versie die nog op het netwerk wordt geaccepteerd. Als het document niet voldoet aan de nieuwste versie maar wel aan de vorige, worden beide resultaten teruggegeven. Zo is direct zichtbaar of verzending nu nog mogelijk is en of een upgrade nodig is.

Kan ik klantspecifieke validatieregels instellen?

Ja. Via de parameter ?optionId={id} in de Validate API-aanroep activeer je een vooraf gedefinieerde regelset voor klantspecifieke eisen of branchestandaarden. Beschikbare opties zijn op te vragen via GET /api/v1/generic/validate/options. Deze uitbreiding is beschikbaar binnen het PSB-platform en via afspraken met eConnect.

Wil je factuurfouten structureel voorkomen?

Plan een kennismaking

Maak een offerte via Cora