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.

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.

POST/v1/validate

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.

POST/v1/convert

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.

POST/v1/invoices

Rechnung aus JSON erzeugen. format= wie oben. Prüft vorher die Regeln des Zielformats und antwortet sonst mit 422 und der Fehlerliste.

GET/v1/iban/{iban}

IBAN-Prüfung: Länge je Land, Prüfziffer, SEPA, Bankleitzahl.

GET/v1/vat/{vat_id}

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.

POST/v1/vat/batch

Bis zu 100 USt-IdNr. pro Aufruf: {"vat_ids": ["DE…", "FR…"]}. Zählt einen Aufruf pro Nummer.

GET/v1/usage

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
Gratis-Schlüssel

Starter

19 € / Monat

2.000 Aufrufe / Monat

  • Alle Endpunkte
  • PDFs ohne Hinweis
  • E-Mail-Support
Wählen

Pro

59 € / Monat

15.000 Aufrufe / Monat

  • Alle Endpunkte
  • Ohne Hinweis
  • Bevorzugter E-Mail-Support
Wählen

Business

199 € / Monat

100.000 Aufrufe / Monat

  • Alle Endpunkte
  • Ohne Hinweis
  • AV-Vertrag auf Anfrage
  • Bevorzugter Support
Wählen

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.