# Programmatische afhandeling van e-factuurschemafouten

- Bijgewerkt in mei 2026

Analyseer validatiefout-arrays, los structurele XML-problemen op, handel `UBL`-/`CII`-namespace-mismatches af en automatiseer correcties programmatisch.

## De validatie-payload analyseren

Wanneer een factuur niet slaagt voor de schemavalidatie, retourneert de API een gestructureerde JSON-payload met een gedetailleerde lijst met fouten in plaats van een geconverteerd XML-bestand. Door de programmatische afhandeling kan uw systeem eenvoudige problemen automatisch oplossen of complexe fouten doorsturen naar menselijke controleurs.

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

- Als de `BuyerReference` ontbreekt, zoek dan in uw klantendatabase naar de standaard `Leitweg-ID` en probeer het opnieuw.
- 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

- Automatische nieuwe poging: Veilig voor tijdelijke verbindingsfouten, snelheidslimieten of snelle schema-correcties.
- Handmatige beoordeling: Vereist wanneer de totalen aanzienlijk verschillen, bankgegevens ontbreken of belastingcategorieën dubbelzinnig zijn.