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)
Vorausgefüllter, normkonformer JSON-Payload gegen unser InvoiceRequest-Modell. Du kannst die Werte direkt editieren:
zg_test_ouroboros_001 (sofortige PDF/A-3 Generierung).
Code-Vergleich: Falsches vs. Korrektes CII-XML
<!-- FEHLER: Ungültiger XML-Header oder fehlende FeRD-Namensräume führen zu Schema-Ablehnung -->
<CrossIndustryInvoice>
<ExchangedDocument>
<ID>RE-2026-001</ID>
</ExchangedDocument>
</CrossIndustryInvoice>
<!-- 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": [...]}`.
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 →KoSIT XRechnung validieren: Schematron-Prüfung ohne Java per API
Validiere XRechnung & ZUGFeRD gegen die offiziellen KoSIT Schematron-Regeln. Keine Java- oder Docker-Installation nötig – direkte Cloud-Validierung in <500ms.
XRECHNUNG 3.0 APIXRechnung REST-API: EN 16931 CII-XML per API erstellen & validieren
Erstelle valide XRechnung 3.0 XML-Dateien (CII / UBL) per REST-API. Automatische Prüfung gegen KoSIT Schematron und sofortiger Download ohne Java-Setup.
BR-CO-10Fehler BR-CO-10 beheben: Summenfehler der Positionen in EN 16931
Schematron-Fehler BR-CO-10 lösen: Warum die Summe der Positions-Nettobeträge (BT-106) exakt dem Gesamt-Nettobetrag (BT-109) entsprechen muss. Mit XML-Fix.
PYTHON SDKZUGFeRD in Python erstellen: E-Rechnung REST-API & zugferd-client
Erstelle ZUGFeRD 2.2 PDF/A-3 und XRechnung in Python mit nur 5 Zeilen Code. Schneller als lxml oder PyPDF – mit fertigem SDK 'zugferd-client' auf PyPI.