Skip to main content

Guide · 2026-08-29

Markdown export

E-Invoice Ruleset Validation Guide

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.