Zo controleren we e-facturen
Elk e-factuurbestand dat de app van Clockaroo maakt, wordt gecontroleerd door een validator voordat de factuur definitief wordt. Mislukt de controle, dan wordt de factuur niet definitief en blijft het nummer vrij. Hier lees je welke validators we gebruiken, in welke versie, en wat onze tests dekken.
Deze pagina beschrijft technische controles. Het is geen juridisch of fiscaal advies.
Welke validator welk formaat controleert
| Bestand | Gecontroleerd met | Wat er gecontroleerd wordt |
|---|---|---|
| Peppol BIS Billing 3.0 (UBL), voor bedrijven in Nederland | KoSIT-validator 1.6.3 met de OpenPeppol-regels van BIS 3.0.21 | Het UBL-schema, de regels van EN 16931 en de Peppol-regels |
| XRechnung (CII en UBL) | KoSIT-validator 1.6.3 met de configuratie voor XRechnung 3.0.2, release van 31 augustus 2026 | Het XML-schema, de regels van EN 16931 en de regels van XRechnung |
| ZUGFeRD (profiel EN 16931) | Mustang 2.26.0 met veraPDF 1.30.2 | veraPDF controleert het PDF/A-3-bestand, Mustang de ingesloten XML volgens de regels van EN 16931 |
De KoSIT-validator en de officiële configuratie voor XRechnung komen van de Duitse Koordinierungsstelle für IT-Standards (KoSIT). Mustang en veraPDF zijn open source. Een factuur als gewone pdf is geen e-factuur, dus die controleert geen validator. XRechnung en ZUGFeRD maakt de app voor bedrijven in Duitsland, Oostenrijk, het Verenigd Koninkrijk, Ierland en de Verenigde Staten.
De versies in deze tabel leest de pagina uit het bestand waarmee onze server de validators downloadt. Daar staat elke versie vast, met een controlegetal. Als we een validator bijwerken, verandert deze pagina mee.
Wanneer een bestand gecontroleerd wordt
- Als je een factuur of een creditfactuur definitief maakt, maakt de app het bestand en controleert de validator het. Alleen als het bestand de controle doorstaat, wordt de factuur definitief.
- Vindt de controle een fout, dan wordt er niets definitief gemaakt en geen nummer gebruikt. De app laat zien wat je moet aanpassen.
- Is een validator niet bereikbaar, dan wordt de factuur ook niet definitief, en kun je het opnieuw proberen.
- Een definitief bestand verandert daarna niet meer. Het blijft het bestand dat de controle heeft doorstaan.
Wat onze tests dekken
Naast de controle bij het definitief maken maakt een testmatrix facturen zoals de app dat doet, voor verkopers en klanten in verschillende landen, en controleert elk bestand met dezelfde validators. Elk geval wordt gecontroleerd als factuur en als bijbehorende creditfactuur.
| Verkoper in | Btw-gevallen | Gecontroleerde e-factuurbestanden |
|---|---|---|
| Duitsland | Standaardtarief (S), Nultarief (Z), Vrijgesteld (E), Btw verlegd (AE), Niet onderworpen aan btw (O) | ZUGFeRD, XRechnung CII en XRechnung UBL |
| Oostenrijk | Standaardtarief (S), Vrijgesteld (E), Btw verlegd (AE), Niet onderworpen aan btw (O) | ZUGFeRD, XRechnung CII en XRechnung UBL |
| Nederland | Standaardtarief (S), Nultarief (Z), Vrijgesteld (E), Btw verlegd (AE), Niet onderworpen aan btw (O) | Peppol BIS |
| Verenigd Koninkrijk | Standaardtarief (S), Niet onderworpen aan btw (O) | ZUGFeRD, XRechnung CII en XRechnung UBL |
| Ierland | Standaardtarief (S), Btw verlegd (AE), Niet onderworpen aan btw (O) | ZUGFeRD, XRechnung CII en XRechnung UBL |
| Verenigde Staten | Niet onderworpen aan btw (O) | ZUGFeRD, XRechnung CII en XRechnung UBL |
Kleine ondernemers in de matrix: de KOR in Nederland, § 19 UStG in Duitsland en de Kleinunternehmerregelung in Oostenrijk. Facturen met de KOR zijn gewone pdf's zonder e-factuurbestand. Voor elk geval controleert de matrix ook dat de pdf van de factuur gemaakt wordt.
De matrix draait mee bij elke volledige testrun, samen met alle andere tests van de app. Op onze testserver telt een ontbrekende validator als fout, dus een volledige testrun kan niet slagen zonder de bestanden te controleren.
Laatste volledige testrun geslaagd:
Wat een geslaagde controle betekent
Een geslaagde controle betekent dat het bestand voldoet aan de technische regels die deze validators testen. Het zegt niets over:
- de inhoud van de factuur. Bedragen, de btw-behandeling en de beschreven dienst controleer je zelf.
- een certificering. Clockaroo heeft geen certificaat voor e-facturen.
- juridisch of fiscaal advies.
- versturen via het Peppol-netwerk. De app maakt het Peppol BIS-bestand en controleert het; het bestand gaat mee met je e-mail en je kunt het downloaden.
Zelf een bestand controleren
- Een e-factuur controleren (Engelstalig) met onze gratis validator, zonder account. XRechnung controleert die met dezelfde KoSIT-validator. Andere bestanden volgens EN 16931, ook Peppol BIS, controleert die met Mustang op de regels van EN 16931, zonder de Peppol-regels.
De tools
- Peppol BIS Billing 3.0 (OpenPeppol; regels van BIS 3.0.21, Engelstalig)
- KoSIT-validator 1.6.3 (GitHub, KoSIT)
- Configuratie voor XRechnung 3.0.2, release van 31 augustus 2026 (GitHub, KoSIT)
- Mustang 2.26.0 (GitHub, Mustang-project)
- veraPDF (de versie in Mustang: 1.30.2)