# E-Invoice Ruleset Validation Guide

- 2026-08-29

Resolve validator warnings and timeouts, then read ruleset results without treating them as legal or delivery approval.

## What profile validation checks

A validator checks one XML file against the schema and Schematron rules for the selected profile and ruleset version, such as KoSIT XRechnung or Peppol BIS Billing.

A pass means that the file met those machine-readable rules. It does not prove that the invoice facts are correct, that the tax treatment is lawful, or that a buyer or portal will accept delivery.

## Handling temporary outages

- The selected ruleset or validation service is starting or down for maintenance.
- A network or startup delay causes a timeout between the app and validator service.
- Temporary service load returns a 504 Gateway Timeout.

## Developer resilience policy

If the profile validator service is unreachable, Invoice Converter returns a 503 response with the AUTHORITATIVE_VALIDATION_UNAVAILABLE error code.

Put this state in a retry queue. Do not send a production file while required profile validation is pending, and confirm the recipient channel separately.

## Troubleshooting validation errors

- Check that the BuyerReference or Leitweg-ID matches the buyer’s instructions.
- Verify that currency codes conform to standard ISO 4217.
- Compare each tax subtotal with the related line amounts and document-level allowances or charges.
- Review the returned XML report in the response payload for exact Schematron rule IDs like BR-DE-15.