Gratis Peppol BIS Billing 3.0-validator
De gratis validator van Valinvo controleert een Peppol BIS Billing 3.0-factuur of -creditnota (UBL-XML) op de officiële regels en toont elk probleem met het regel-ID, de plaats in het bestand en een melding. Je hebt geen account of API-sleutel nodig, en je bestand wordt alleen in het geheugen verwerkt en niet opgeslagen.
Validator openen · Gebruiken vanuit code (API-snelstart)
Wat wordt gecontroleerd
- Peppol BIS Billing 3.0: UBL Invoice en UBL CreditNote, nu release 3.0.21.
- Het XML-schema en de Schematron-bedrijfsregels: de Europese norm EN 16931 (regels
BR-…) plus de Peppol-regels daarbovenop (PEPPOL-EN16931-…). - De regelset wordt uit het document herkend, je hoeft dus niet eerst een formaat te kiezen. Het resultaat noemt de toegepaste set, bijvoorbeeld
peppol-bis-3.0.21-ubl-invoice.
De regels komen van OpenPeppol en CEN en worden toegepast zoals ze zijn gepubliceerd.
Zo werkt het
- Open de validator, plak de XML of upload het bestand.
- Klik op Valideren. Je kunt eerst het geldige Peppol-voorbeeld of het foutieve XRechnung-voorbeeld proberen.
- Lees de lijst: elke fout toont het regel-ID, de plaats en wat er niet klopt. Pas de factuur aan in je systeem en valideer opnieuw.
Vanuit code: dezelfde controle als API
curl -X POST https://valinvo.bmk-hub.com/v1/validate \
-H 'X-Accept-Terms: 1.0' \
-H 'Content-Type: application/xml' \
--data-binary @invoice.xml
Een geldige factuur geeft:
{"ruleSet": "peppol-bis-3.0.21-ubl-invoice", "valid": true, "errors": [], "warnings": []}
Een factuur met problemen is een gewoon 200-antwoord met valid: false en de lijst met fouten. Waarschuwingen maken een factuur niet ongeldig. Meer in de snelstart.
Veelvoorkomende Peppol-fouten
| Regel | Betekenis | Gebruikelijke oplossing |
|---|---|---|
PEPPOL-EN16931-R001 | Het bedrijfsproces (ProfileID) ontbreekt. | De Peppol-bedrijfsprocesidentifier toevoegen. |
PEPPOL-EN16931-R003 | Een koperreferentie of orderreferentie is verplicht. | Een van beide invullen. |
PEPPOL-EN16931-R010 | Het elektronische adres van de koper ontbreekt. | Het Peppol-eindpunt-ID van de koper met schema toevoegen. |
PEPPOL-EN16931-R020 | Het elektronische adres van de verkoper ontbreekt. | Het Peppol-eindpunt-ID van de verkoper met schema toevoegen. |
PEPPOL-EN16931-R004 | De specificatie-identifier (CustomizationID) is niet die van Peppol BIS 3.0. | De identifier uit de Peppol BIS Billing 3.0-specificatie gebruiken. |
PEPPOL-EN16931-R002 | Meer dan één opmerking op documentniveau. | Eén opmerking houden, of de tekst naar een regel of bijlage verplaatsen. |
Voor Belgische bedrijven gebruikt het eindpunt-ID normaal het schema 0208 met het tiencijferige ondernemingsnummer (zonder punten). Andere landen gebruiken andere schema's: zie de landnotities in de snelstart.
Vragen
Is de validator echt gratis? Ja. De online validator vraagt geen account of API-sleutel. De API kun je ook zonder sleutel proberen, met een kleine dagelijkse limiet voor het maken van facturen.
Wordt mijn factuur opgeslagen? Nee. Het bestand wordt alleen in het geheugen verwerkt en niet opgeslagen. Gebruik voorbeeldgegevens of facturen die je mag delen.
Betekent "geldig" dat de koper de factuur ontvangt? Nee. De controle past de officiële regels toe zoals ze zijn gepubliceerd. Verzenden vraagt een Peppol-toegangspunt, en een geldig bestand garandeert niet dat een ontvanger het accepteert. Het is geen fiscaal of juridisch advies.
Kan Valinvo de factuur ook maken? Ja. Je stuurt één factuur als JSON en krijgt Peppol BIS- of XRechnung-XML terug die op dezelfde regels is gecontroleerd. Zie de snelstart.
Door de validator te gebruiken accepteer je de gebruiksvoorwaarden (voorlopig alleen in het Engels).