E-Rechnung API für Entwickler
XRechnung, ZUGFeRD / Factur-X und Peppol BIS mit einem HTTP-Aufruf prüfen, umwandeln und erzeugen. Dazu IBAN- und USt-IdNr.-Prüfung (VIES). Für ERP-, Shop- und Buchhaltungssoftware, die die E-Rechnungspflicht in Deutschland (2025–2028), Frankreich, Belgien und Polen erfüllen muss.
- Kein SDK nötig: XML, PDF oder JSON senden, JSON, XML oder PDF zurück
- Rechnungen werden nur im Arbeitsspeicher verarbeitet und nie gespeichert
- Fehlermeldungen auf Deutsch, Englisch und Französisch, mit Regelnummer der EN 16931
- Läuft im Netz von Cloudflare, nah an Ihren Servern
Schnellstart
1. Schlüssel holen (Gratis: 100 Aufrufe pro Monat). Der Schlüssel kommt per E-Mail.
2. Rechnung senden:
curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/validate?lang=de" \ -H "X-API-Key: YOUR_KEY" \ -H "Content-Type: application/xml" \ --data-binary @invoice.xml
3. Ergebnis lesen:
{
"valid": false,
"syntax": "CII",
"profile": "xrechnung",
"errors": [
{ "rule": "BR-DE-15", "field": "buyerReference",
"message": "XRechnung: Käuferreferenz / Leitweg-ID (BT-10) fehlt." }
],
"warnings": [],
"summary": { "number": "RE-2027-0042", "total_with_vat": 1339.07, ... }
}Endpunkte
Anmeldung: Header X-API-Key: IHR_SCHLÜSSEL (oder Authorization: Bearer …). Jede Antwort enthält X-RateLimit-Limit und X-RateLimit-Remaining. Vollständige Spezifikation: openapi.json.
XRechnung (CII oder UBL), ZUGFeRD / Factur-X (PDF oder XML) oder Peppol BIS prüfen. Body: die XML-Datei, die PDF-Datei oder JSON {"xml": "..."}. Optional: profile=auto|xrechnung|en16931|peppol, lang=de|en|fr.
Zwischen Formaten umwandeln. to=xrechnung-cii|xrechnung-ubl|peppol-ubl|en16931-cii|zugferd-xml|zugferd-pdf|json. ZUGFeRD-PDF rein, XRechnung raus (oder umgekehrt). Wandelt nicht um, wenn die Summen der Quelle nicht stimmen: Beträge ändern sich nie.
Rechnung aus JSON erzeugen. format= wie oben. Prüft vorher die Regeln des Zielformats und antwortet sonst mit 422 und der Fehlerliste.
IBAN-Prüfung: Länge je Land, Prüfziffer, SEPA, Bankleitzahl.
USt-IdNr.-Prüfung: Format und Prüfziffer offline, dann live im VIES (Name und Anschrift, wenn das Land sie freigibt). vies=false nur offline.
Bis zu 100 USt-IdNr. pro Aufruf: {"vat_ids": ["DE…", "FR…"]}. Zählt einen Aufruf pro Nummer.
Verbrauchte und verbleibende Aufrufe im Monat. Kostenlos.
Rechnungs-JSON (für /v1/invoices)
Feldnamen nach EN 16931. USt-Kategorien: S (Standard), Z, E (befreit, z. B. § 19 UStG), AE (Reverse Charge), K (innergemeinschaftlich), G (Ausfuhr), O. Elektronische Adresse: endpoint_id + endpoint_scheme (z. B. 0204 Leitweg-ID, 9930 USt-IdNr.); ohne diese Felder wird die E-Mail verwendet.
{
"number": "RE-2027-0042",
"issue_date": "2027-01-15",
"due_date": "2027-01-29",
"currency": "EUR",
"buyer_reference": "04011000-12345-34",
"seller": {
"name": "Muster Design Studio",
"street": "Lindenstraße 12",
"postcode": "10115",
"city": "Berlin",
"country": "DE",
"vat_id": "DE123456788",
"email": "rechnung@muster-design.example",
"contact_name": "Mia Muster",
"phone": "+49 30 1234567"
},
"buyer": {
"name": "Stadtverwaltung Musterstadt",
"street": "Rathausplatz 1",
"postcode": "12345",
"city": "Musterstadt",
"country": "DE",
"email": "eingang@musterstadt.example",
"endpoint_id": "04011000-12345-34",
"endpoint_scheme": "0204"
},
"payment": {
"means_code": "58",
"iban": "DE02120300000000202051"
},
"lines": [
{
"name": "Webdesign",
"quantity": 12.5,
"unit_code": "HUR",
"price": 85,
"vat_category": "S",
"vat_rate": 19
}
]
}# ZUGFeRD / Factur-X PDF -> XRechnung UBL curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/convert?to=xrechnung-ubl" \ -H "X-API-Key: YOUR_KEY" --data-binary @invoice.pdf -o xrechnung.xml # JSON -> ZUGFeRD PDF curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/invoices?format=zugferd-pdf" \ -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \ --data @invoice.json -o invoice.pdf # IBAN and VAT ID curl -H "X-API-Key: YOUR_KEY" https://rechnix-api.mbanzagroup.workers.dev/v1/iban/DE02120300000000202051 curl -H "X-API-Key: YOUR_KEY" https://rechnix-api.mbanzagroup.workers.dev/v1/vat/FR32123456789
Ausprobieren
Nutzt den öffentlichen Demo-Schlüssel (30 Aufrufe pro Tag). Das Beispiel ist eine gültige XRechnung; bauen Sie einen Fehler ein und sehen Sie die Antwort.
Preise
Monatstarife, jederzeit kündbar. Zahlung, Umsatzsteuer und Rechnungen übernimmt Polar (Merchant of Record). Ein Aufruf ist eine Anfrage; ein USt-Stapel zählt einen Aufruf pro Nummer.
Gratis
0 € / Monat
100 Aufrufe / Monat
- Alle Endpunkte
- PDF mit Hinweis „Erstellt mit“
- Community-Support
Business
199 € / Monat
100.000 Aufrufe / Monat
- Alle Endpunkte
- Ohne Hinweis
- AV-Vertrag auf Anfrage
- Bevorzugter Support
Mehr als 100.000 Aufrufe? Schreiben Sie uns. mbanzagroup@proton.me · Abo und Schlüssel verwalten
FAQ
Ist das der offizielle Validator?
Es sind dieselben Regeln. Jede Anfrage wird mit dem vollständigen offiziellen Schematron-Regelwerk geprüft, das auch der KoSIT-Validator nutzt: EN 16931 (CEN 1.3.16), XRechnung 3.0.2 (KoSIT) und für Peppol die Peppol BIS Billing 3.0.21. Jeder Fehler hat die offizielle Regelnummer und die Stelle im XML. Nicht enthalten ist die Schema-Prüfung (XSD).
Speichern Sie meine Rechnungen?
Nein. Rechnungen werden im Arbeitsspeicher gelesen und nach der Antwort verworfen. Gespeichert werden nur ein Aufrufzähler je Schlüssel und ein Hash des Schlüssels. Keine Rechnungsinhalte in Logs.
Welche Formate?
XRechnung 3.0 (CII und UBL), ZUGFeRD 2.x / Factur-X 1.0 Profil EN 16931 (PDF/A-3 oder XML), Peppol BIS Billing 3.0 (UBL), EN 16931 CII. Lesen: auch andere ZUGFeRD-Profile (nur Grundregeln).
Was geht noch nicht?
Zu- und Abschläge auf Belegebene beim Umwandeln (die API lehnt ab, statt sie wegzulassen), UBL-Gutschrift als eigenes Dokument und der Versand über das Peppol-Netz.
Was passiert, wenn das Kontingent verbraucht ist?
Aufrufe antworten mit HTTP 429 bis zum nächsten Monat oder bis zum Wechsel des Tarifs. Keine Überraschungsrechnungen.