API für Softwareanbieter: E-Rechnungen prüfen, anzeigen und erzeugen
Die E-Rechnung API für Softwareanbieter prüft XRechnung und ZUGFeRD, rendert XML als lesbare Rechnung und erzeugt ZUGFeRD-PDF aus Rechnungsdaten, jeweils per HTTP und im Arbeitsspeicher. Dieselbe Engine läuft in den kostenlosen Tools. Der Zugang ist noch nicht öffentlich: Tragen Sie sich auf die Warteliste ein.
Was die API kann
| Endpunkt | Eingabe | Ausgabe |
|---|---|---|
POST /api/validate | Datei (multipart): XML oder ZUGFeRD-PDF | JSON: gültig oder ungültig, Meldungen mit Regel-ID, Fundstelle, deutscher Erklärung |
POST /api/view | Datei (multipart): XML oder ZUGFeRD-PDF | HTML der lesbaren Rechnung (KoSIT-Stylesheets) |
POST /api/create | Rechnungsdaten als JSON, optional ein PDF | JSON mit ZUGFeRD-PDF (Base64) und XML, nur wenn die Prüfung besteht |
GET /api/health | – | Status und Versionen der Regelwerke |
Beispiel
curl -X POST https://api.rechnungxml.de/api/validate \
-F "file=@rechnung.xml"Die Antwort enthält valid, verdict_de, counts und die Liste issues. Jede Meldung hat rule_id, severity, location, explanation_de und die Originalmeldung der Regel.
Grenzen
- 10 MB je Datei, Standard-Begrenzung von 60 Anfragen je Minute und IP-Adresse (einstellbar).
- Verarbeitung nur im Arbeitsspeicher. Es werden keine Inhalte protokolliert.
- Der Zugang ist noch nicht öffentlich.
Warteliste für den API-Zugang
Tragen Sie Ihre E-Mail-Adresse ein. Wir melden uns, sobald der Zugang für Softwareanbieter startet. Es besteht kein Anspruch auf Teilnahme.
Zuerst ausprobieren: E-Rechnung prüfen, XRechnung Viewer, ZUGFeRD-Rechnung erstellen.
Quellen
Stand: . Funktionsumfang und Preise sind Planungsstand und können sich ändern.
Häufige Fragen
Für wen ist die API gedacht?
Für Software- und Marktplatzanbieter, Shop-Erweiterungen und Buchhaltungstools, die E-Rechnungen prüfen, anzeigen oder erzeugen müssen, ohne selbst Schematron, XSLT und PDF/A-Technik zu betreiben.
Welche Regelwerke nutzt die API?
Die offizielle Validator-Konfiguration der KoSIT für XRechnung 3.0.2 mit EN 16931 (Schematron 1.3.16) und XRechnung-Regeln (Schematron 2.6.0). Die Darstellung nutzt die XSLT-Stylesheets der KoSIT.
Werden die Daten gespeichert?
Nein. Dateien werden im Arbeitsspeicher verarbeitet und nach der Antwort verworfen. Das Limit liegt bei 10 MB je Datei.
Was kostet die API?
Das ist noch nicht entschieden. Die kostenlosen Tools auf dieser Seite bleiben kostenlos. Für die API ist ein nutzungsabhängiges Modell geplant, Details nennen wir den Personen auf der Warteliste.
Gibt es eine Dokumentation?
Die Schnittstelle ist mit OpenAPI beschrieben und unter API für Softwareanbieter/docs des API-Servers abrufbar, sobald dieser öffentlich ist.