# Programmatische afhandeling van e-factuurschemafouten

- 2026-08-29

Lees validatiefouten, vind structurele XML- en namespaceproblemen en pas alleen correcties toe die door brongegevens zijn bevestigd.

## De validatie-payload analyseren

Als een factuur niet door de schemavalidatie komt, geeft de API gestructureerde JSON-fouten terug in plaats van geconverteerde XML. Koppel bekende foutcodes aan velden, maar wijzig een waarde alleen als goedgekeurde bron- of stamgegevens dit ondersteunen. Stuur onduidelijke of belangrijke wijzigingen naar een menselijke reviewer.

De foutrespons bevat een `VALIDATION_FAILED`-statuscode samen met een array van foutobjecten. Elk object biedt een specifiek pad naar het falende veld, de waarde die de fout heeft veroorzaakt en een voor mensen leesbare beschrijving van de nalevingsregel die is geschonden (bijv. `BR-CO-13`).

## Veelvoorkomende oplossingen automatiseren

- Gebruik bij een ontbrekende `BuyerReference` de waarde voor deze order uit goedgekeurde klant- of ordergegevens. Vraag de koper als die ontbreekt; voeg geen standaard-`Leitweg-ID` in.
- Voor afrondingsverschillen (bijv. `PayableAmount`-verschillen), controleert u het brondocument en corrigeert u de onderliggende regelbedragen of btw-cijfers; accepteer alleen waarden die overeenkomen met de factuur.
- Bij een ontbrekende eenheidscode stelt Invoice Converter de regel standaard in op `C62` en markeert deze voor controle; bevestig vóór acceptatie dat de gemarkeerde eenheid overeenkomt met de bronfactuur.

## Opnieuw proberen vs. handmatige escalatie

- Probeer alleen automatisch opnieuw na een tijdelijke verbindings- of rate-limitfout, of na een eenduidige correctie die door brongegevens is bevestigd.
- Handmatige beoordeling: Vereist wanneer de totalen aanzienlijk verschillen, bankgegevens ontbreken of belastingcategorieën dubbelzinnig zijn.
