W System / XRechnung und ZUGFeRD per API prüfen (EN 16931)

XRechnung und ZUGFeRD per API prüfen (EN 16931)

curl -s https://wsystem.dev/examples/broken-xrechnung.xml | curl -s -X POST https://api.wsystem.dev/einvoice/validate -H 'Content-Type: application/xml' --data-binary @-

Kurz: Senden Sie die Rechnung als Rohdaten (XML oder ZUGFeRD/Factur-X-PDF) an POST https://api.wsystem.dev/einvoice/validate. Sie erhalten valid und jeden Fehler mit offizieller Regel-ID, Meldung, XPath und Korrekturhinweis. Geprüft wird gegen die KoSIT-Konfiguration XRechnung 3.0.2 und die CEN-Artefakte EN 16931, unverändert, plus die XML-Schemas von UBL 2.1 und CII D16B. Meldungen und Feldnamen sind auf Englisch.

Fristen in Deutschland

Quelle: BMF, FAQ E-Rechnung. Details und das BMF-Schreiben vom 15. Oktober 2026: Germany e-invoicing deadlines.

Was geprüft wird

• Formate: UBL Invoice und CreditNote, UN/CEFACT CII, PDF mit eingebetteter factur-x.xml, zugferd-invoice.xml oder xrechnung.xml. Das Profil (EN 16931, XRechnung, Factur-X/ZUGFeRD) wird automatisch erkannt.
• Regelwerke: XSD, CEN EN 16931 (UBL und CII), KoSIT XRechnung 3.0.2. Peppol-BIS-3-spezifische Regeln (PEPPOL-EN16931-*) laufen noch nicht; das Feld checked nennt die gelaufenen Regelwerke.
• ZUGFeRD/Factur-X EXTENDED: CII-Syntaxeinschränkungen als Warnungen, Geschäftsregeln als Fehler (Details).
• XRechnung Extension (CustomizationID mit #conformant#urn:xeinkauf.de:kosit:extension:xrechnung_3.0): wird erkannt und mit den Stufen des KoSIT-Extension-Szenarios geprüft; die dort gelockerten Regeln (z. B. BR-CL-10, BR-CL-21) kommen als Warnung mit Hinweis statt als Fehler.
• Fällt der offizielle Regel-Download aus, antwortet die API mit HTTP 503 rules_unavailable und Retry-After statt mit einem falschen Ergebnis.

Beispiel

curl -s https://wsystem.dev/examples/broken-xrechnung.xml | curl -s -X POST https://api.wsystem.dev/einvoice/validate -H 'Content-Type: application/xml' --data-binary @-

Antwort (gekürzt): {"valid": false, "profile": "XRechnung", "errors": [{"rule_id": "BR-CO-16", "message": "Amount due for payment (BT-115) = ...", "location": "...", "fix": "..."}]}

Außerdem in derselben API

• POST /einvoice/create: aus einfachem JSON eine geprüfte XRechnung, EN-16931- oder Peppol-BIS-UBL erzeugen.
• POST /einvoice/parse: eingehende XRechnung, ZUGFeRD und Factur-X als JSON lesen (Anleitung).
• GET /einvoice/route: Peppol-ID, Peppol-Registrierung und Pflichtlage eines Käufers aus der USt-IdNr.
• Ohne Code: Browser-Validator für eigene Dateien.

Preise

Kostenlosen Testschlüssel holen

Fragen und Antworten

Ist das eine Zertifizierung?

Nein. Die API führt die offiziellen Prüfartefakte (KoSIT-Konfiguration XRechnung 3.0.2 und CEN EN 16931) unverändert aus und nennt in jeder Antwort, welche Regelwerke gelaufen sind. Das ist keine Zertifizierung und keine Rechts- oder Steuerberatung.

Werden meine Rechnungen gespeichert?

Nein. Rechnungen werden im Arbeitsspeicher geprüft und nicht gespeichert. Für die Abrechnung wird pro Aufruf nur Zeit, Endpunkt, Status und ein kurzer IP-Hash erfasst, nie XML, Rechnungsnummern, Beträge oder Parteien.

Was kostet es?

Die ersten 20 Aufrufe pro Tag und IP sind ohne Schlüssel frei. Der kostenlose API-Schlüssel (nur geschäftliche E-Mail, keine Karte) enthält 500 Einheiten pro Monat; eine Prüfung kostet 3 Einheiten. Starter kostet 19 € pro Monat (5.000 Einheiten), Pro 49 € pro Monat (25.000 Einheiten).

Kann ich auch versenden?

Ja. POST /einvoice/send erstellt, prüft und routet die Rechnung; im Sandbox-Modus mit signiertem Beleg, ohne echten Empfänger. Der Live-Versand über Peppol (mode=live) wird pro Unternehmen freigeschaltet, nach einem Peppol-Mandat und unserer KYC-Prüfung, mit einem Peppol-Tarif.

Werden ZUGFeRD EXTENDED-Dateien unterstützt?

Ja. Bei Dateien mit dem Profil EXTENDED kommen die CII-Syntaxeinschränkungen von EN 16931 (CII-SR-*, CII-DT-*) als Warnungen zurück; die Geschäftsregeln (BR-*) bleiben Fehler.

Weiter

• EU e-invoice validation API (English)
• Quickstart (English)
• API-Referenz (OpenAPI)

Fakten geprüft am 2026-11-09. W System ist der Hersteller dieses Produkts. Keine Verbindung zur Europäischen Kommission. Keine Rechts- oder Steuerberatung.