Z E-Rechnung API
Startseite › E-Rechnung Wissen › Automatisierung › VALIDATOR REST-API
Automatisierung • VALIDATOR REST-API

ZUGFeRD Validator REST-API: Eingehende E-Rechnungen in Echtzeit prüfen

Unternehmen müssen ab 2025/2026 tausende eingehende E-Rechnungen automatisiert auf Normkonformität prüfen. Unsere REST-API POST /v1/invoice/validate analysiert PDF/A-3 und XML flüchtig im RAM und liefert strukturierte JSON-Prüfberichte.

Eigene Rechnung hier hineinziehen

oder Datei vom Computer auswählen (.pdf oder .xml bis 10 MB)

🔒 100 % flüchtige RAM-Prüfung auf deutschen Servern (Frankfurt) – keine Speicherung.

Code-Vergleich: Falsches vs. Korrektes CII-XML

✗ Häufiger Fehler / Falsches XML Nicht konform
<!-- FEHLER: Ungültiger XML-Header oder fehlende FeRD-Namensräume führen zu Schema-Ablehnung -->
<CrossIndustryInvoice>
  <ExchangedDocument>
    <ID>RE-2026-001</ID>
  </ExchangedDocument>
</CrossIndustryInvoice>
✓ Valide nach EN 16931 / KoSIT Normkonform
<!-- KORREKT: Vollständige Namensraum-Deklarationen für Factur-X / ZUGFeRD 2.2 CII -->
<rsm:CrossIndustryInvoice 
  xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
  xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
  xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">
  <rsm:ExchangedDocument>
    <ram:ID>RE-2026-001</ram:ID>
    <ram:TypeCode>380</ram:TypeCode>
  </rsm:ExchangedDocument>
</rsm:CrossIndustryInvoice>

Technische Ursache & Lösung

Manuelle Rechnungsprüfung skaliert bei wachsendem Belegvolumen nicht. ERP-Systeme, Dokumentenmanagement-Lösungen (DMS) und Buchhaltungs-Workflows benötigen eine automatisierte Prüfung von Eingangsrechnungen bereits im Upload-Moment.

Über die REST-API `POST /v1/invoice/validate` übergibst du eine PDF- oder XML-Datei als Multipart-Formular. Die API führt innerhalb von <500ms folgende Prüfungen durch: 1. Ist die PDF eine gültige PDF/A-3 Datei mit ISO 19005-3 XMP-Metadaten? 2. Enthält die Datei eine eingebettete `factur-x.xml` oder `zugferd-invoice.xml`? 3. Ist das XML wohlgeformtes UTF-8 und entspricht dem offiziellen XSD-Schema? 4. Werden alle EN 16931 Berechnungs- und Rundungsregeln eingehalten?

Die Antwort erfolgt als klares JSON: `{"is_valid": true/false, "format_detected": "...", "errors": [...]}`.

⚡ Die schlüsselfertige Abkürzung für Entwickler & No-Code

Keine Lust auf XML-Schematron-Fehler und Rundungsdifferenzen?

Unsere E-Rechnung Cloud API übernimmt alle mathematischen Berechnungen, Steuerregeln, XSD-Schemata und die PDF/A-3 Konvertierung vollautomatisch im Hintergrund.

Häufig gestellte Fragen (FAQ)

Werden geprüfte Rechnungen auf dem Server zwischengespeichert?

Nein. Die Validierung erfolgt zu 100% flüchtig im Arbeitsspeicher (Stateless RAM Processing). Dateien werden nach Abschluss der HTTP-Antwort sofort unwiderruflich verworfen.

Kann die API sowohl hybride PDFs als auch reine XML-Dateien prüfen?

Ja. Die API erkennt das Dateiformat automatisch. PDFs werden auf PDF/A-3 und eingebettetes XML geprüft; reine XML-Dateien werden direkt gegen das Schematron- und XSD-Schema validiert.

Wie hoch ist die typische Antwortzeit des Validierungs-Endpunkts?

Typische Antwortzeiten liegen zwischen 150ms und 450ms, wodurch sich die Prüfung nahtlos in synchrone Web-Uploads und automatische E-Mail-Postfächer integrieren lässt.

Passende Themen & Normen

Alle 12 Themen ansehen →