XRechnung per API erstellen und prüfen

Zwei kostenlose Endpunkte für Entwickler: einer prüft E-Rechnungen mit den offiziellen Regeln, einer erstellt gültige XRechnung-, ZUGFeRD- und Peppol-Dateien aus JSON. Ohne Anmeldung und ohne API-Schlüssel.

E-Rechnung prüfen

POST https://invoiceer.io/api/validate mit der Datei im Feld file (multipart/form-data). Angenommen werden XRechnung (UBL und CII), ZUGFeRD / Factur-X als PDF oder XML und Peppol BIS 3.0.

curl -F "file=@rechnung.xml" https://invoiceer.io/api/validate

Die Antwort enthält valid, das erkannte Format, alle Fehler und Warnungen mit Regelcode (z. B. BR-DE-15), bei häufigen Rechenfehlern den korrigierten Wert, die Pflichtangaben nach §14 UStG (ustg14) und die verwendeten Regelwerk-Versionen (rulesets). Bei ZUGFeRD-PDFs vergleichen wir außerdem PDF und XML (IBAN, Rechnungsnummer, Betrag).

E-Rechnung erstellen

POST https://invoiceer.io/api/einvoice mit JSON. Jede Datei wird vor der Rückgabe mit dem offiziellen Validator geprüft; ist sie ungültig, erhalten Sie HTTP 422 mit den Regelfehlern statt einer Datei. Mit ?raw=1 kommt direkt die Datei zurück.

curl -s "https://invoiceer.io/api/einvoice?raw=1" -H "Content-Type: application/json" -o rechnung.xml -d '{
  "format": "xrechnung-ubl", "number": "RE-2026-17", "buyer_reference": "991-33333TEST-33",
  "iban": "DE89370400440532013000",
  "seller": {"name": "Muster GmbH", "street": "Hauptstr. 1", "zip": "10115", "city": "Berlin", "country": "DE",
             "vat": "DE123456789", "email": "rechnung@muster.de", "contact": "Max Muster", "phone": "+49 30 123456"},
  "buyer":  {"name": "Kunde AG", "street": "Weg 2", "zip": "80331", "city": "München", "country": "DE",
             "email": "ap@kunde.de"},
  "lines":  [{"name": "Beratung", "qty": 10, "unit": "HUR", "price": 100, "vat_category": "S", "vat_rate": 19}]
}'

Formate: xrechnung-ubl (Standard), xrechnung-cii, zugferd (PDF/A-3 mit XML) und peppol. Alle Felder: API-Dokumentation (Englisch).

Was die XRechnung verlangt

Die deutschen Regeln (BR-DE) verlangen mehr als die EN 16931: einen Ansprechpartner beim Verkäufer mit Telefon und E-Mail, eine Käuferreferenz (BT-10, bei Behörden die Leitweg-ID), Zahlungsinformationen (z. B. IBAN) und die elektronische Adresse des Käufers (E-Mail oder Peppol-ID). Fehlt etwas, nennt die API die Regel; jede Regel ist auf unseren Regelseiten erklärt.

Grenzen und Datenschutz

Kostenlos und ohne Anmeldung, faire Nutzung: 40 Aufrufe pro Stunde und IP-Adresse (darüber HTTP 429). Dateien werden nur im Arbeitsspeicher verarbeitet und nicht gespeichert; der Server steht in der EU. Für größere Mengen oder eine SLA schreiben Sie an [email protected].

Für KI-Assistenten: MCP-Server

Dieselben Funktionen gibt es als MCP-Server für Claude, Cursor und andere KI-Assistenten: https://invoiceer.io/mcp (Einrichtung: API-Seite).