E-Rechnung API: XRechnung und ZUGFeRD per REST prüfen

Schnellstart mit curl

XRechnung-XML direkt als Body senden:

curl -X POST https://erechnung-konverter.vercel.app/api/v1/validate \
  -H "Authorization: Bearer $ERECHNUNG_API_KEY" \
  -H "Content-Type: application/xml" \
  --data-binary @rechnung.xml

ZUGFeRD-/Factur-X-PDF oder XML als Datei-Upload (Multipart). Bei PDFs wird die erste eingebettete XML geprüft:

curl -X POST https://erechnung-konverter.vercel.app/api/v1/validate \
  -H "Authorization: Bearer $ERECHNUNG_API_KEY" \
  -F "file=@rechnung-zugferd.pdf"

JavaScript (Node.js 18+)

import { readFile } from "node:fs/promises";

const xml = await readFile("rechnung.xml");
const res = await fetch("https://erechnung-konverter.vercel.app/api/v1/validate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ERECHNUNG_API_KEY}`,
    "Content-Type": "application/xml",
  },
  body: xml,
});
const result = await res.json();
if (!res.ok) throw new Error(result.error.code + ": " + result.error.message);
console.log(result.valid, result.format, result.errors.map(e => e.rule));

Den Schlüssel nur serverseitig verwenden (Umgebungsvariable), nie im Browser-Code ausliefern. Die API sendet keine CORS-Header.

Antwort

valid ist true, wenn keine Regel mit Fehlerstufe verletzt ist; Warnungen stehen separat in warnings. format ist CII oder UBL; XML ohne CII- oder UBL-Rechnungswurzel wird mit 400 not_an_einvoice abgelehnt (zählt nicht). message_de ist null, wenn es für eine Regel noch keine deutsche Erklärung gibt. Jede Regel-ID ist in unseren Fehlercodes erklärt.

{
  "valid": false,
  "format": "CII",
  "document": "invoice",
  "profile": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
  "rules": "KoSIT XRechnung 3.0.2 Schematron (CII: en16931 + xrechnung)",
  "errors": [
    {
      "rule": "BR-DE-15",
      "message": "Das Element \"Buyer reference\" (BT-10) muss übermittelt werden.",
      "message_de": "Die Leitweg-ID bzw. Käuferreferenz (BT-10) fehlt."
    }
  ],
  "warnings": [
    {
      "rule": "BR-DE-TMP-32",
      "message": "Eine Rechnung sollte zur Angabe des Liefer-/Leistungsdatums …",
      "message_de": "Für das Liefer-/Leistungsdatum sollten entweder das Lieferdatum (BT-72) …"
    }
  ],
  "invoice": { "number": "123456XX", "total": "336.9" },
  "usage": { "plan": "free", "limit": 50, "used": 3, "remaining": 47, "reset": "2026-11-01T00:00:00.000Z" }
}

Header: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix-Sekunden, Beginn des nächsten Monats UTC).

OpenAPI-Spezifikation

Die vollständige Beschreibung aller Endpunkte, Felder, Header und Fehlercodes gibt es als OpenAPI 3.1: /openapi.json (JSON) und /openapi.yaml (YAML).

• Postman: Import → Link → https://erechnung-konverter.vercel.app/openapi.json einfügen; den Schlüssel unter Authorization als Bearer Token setzen.
• Insomnia: Import → From URL → dieselbe Adresse.
• Clients generieren: z. B. mit OpenAPI Generator oder openapi-typescript.

Fehlerformat und Statuscodes

{ "error": { "code": "quota_exceeded", "message": "Freikontingent (50/Monat) aufgebraucht, …" } }

Gezählt wird jede Prüfung, die tatsächlich läuft (auch mit Ergebnis valid: false). Anfragen mit 4xx-Fehlern vor der Prüfung (400, 401, 413, 415, 429) zählen nicht.

Limits und Tarife

Free ist jetzt verfügbar. Bezahlte Tarife sind geplant und noch nicht buchbar; Preise pro Monat, Endpreise inkl. 19 % USt, Änderungen vorbehalten. Wer beim Schlüssel das Häkchen setzt, bekommt eine einmalige Nachricht zum Start (nach Bestätigung per Link).

Was die API prüft und was nicht

• Geprüft werden die veröffentlichten Schematron-Regeln der KoSIT (EN 16931 und, bei XRechnung-Kennung, XRechnung 3.0.2) für CII und UBL. Eine XSD-Schemaprüfung findet nicht statt; das Ergebnis ist daher nicht identisch mit dem vollständigen KoSIT-Prüftool.
• Bei ZUGFeRD/Factur-X wird nur die eingebettete XML geprüft, nicht PDF/A-3 oder XMP-Metadaten.
• Rechnungsdateien werden nur im Arbeitsspeicher verarbeitet, nicht gespeichert und nicht an KI-Dienste übermittelt.
• Beta: kostenlos, ohne Verfügbarkeitszusage. Bei Missbrauch können Schlüssel gesperrt werden. Schlüssel verloren? Mail an stoertebeker@mail.grokbot.com.

Lieber im Browser prüfen? Zum kostenlosen Validator. Überblick für Suchende und Entscheider: XRechnung API im Überblick · ZUGFeRD API im Überblick · Factur-X API im Überblick.