Start › API für Entwickler

E-Rechnungsprüfung für Ihre Software, in einer Stunde eingebaut

Ein POST mit der Datei, zurück kommt JSON mit Regel, Feld, Zeile und Korrekturvorschlag. Ohne Java auf Ihrem Server, ohne eigene Regelpflege, mit kostenlosem Schlüssel zum Entwickeln.

Kostenlosen Schlüssel holen Dokumentation lesen

Dauerhaft kostenlos bis 20 Prüfungen pro Woche, ohne Kreditkarte.

Mustang 2.26 und KoSIT-Validator 1.6.3 in jeder Prüfung, XRechnung 3.0.2.
Antwort im Median nach 2,2 Sekunden, gemessen über die letzten 30 Tage.
Rechnungen speichern wir nicht. Server in Nürnberg.
Anfrage und AntwortPOST /v1/validate
# Rechnung gegen EN 16931 prüfen curl -X POST https://api.zugferd-validator.de/v1/validate \ -H "X-Api-Key: $ZV_KEY" \ -H "Content-Type: application/json" \ -d '{"file_type":"pdf","file_content":"JVBERi0xLjcK…"}' # Antwort { "valid": false, "format": "ZUGFeRD 2.3.2 (Factur-X 1.0.07)", "profile": "EN16931", "errors": [{ "rule_id": "BR-DE-16", "field": "BT-31", "line": 42, "message": "… eines der Elemente … (BT-31), … (BT-32) …", "fix_suggestion": "… USt-ID (BT-31) ODER Steuernummer (BT-32) …", "xpath": "/rsm:CrossIndustryInvoice/…/ram:SellerTradeParty" }], "metadata": { "invoice_number": "RE-2026-0815", "total_amount": "1190.00", "currency": "EUR" } }
über 13.000Aufrufe der API in den letzten 90 Tagen
2,2 Sek.Antwortzeit im Median, letzte 30 Tage
99 %Verfügbarkeit als Ziel, mit SLA
0gespeicherte Rechnungen

Stand: 3. November 2026, aus unserer Nutzungsstatistik.

Prüfkerne, Regelstände und Java betreiben wir, Sie schicken nur die Datei

Wer selbst prüft, betreibt Mustang und den KoSIT-Validator, hält Java aktuell und zieht jede neue Fassung der Regeln nach. Bei uns ist das ein HTTP-Aufruf.

  • Beide Syntaxen, alle ProfileCII und UBL, ZUGFeRD von MINIMUM bis EXTENDED, Factur-X und XRechnung. Format und Profil erkennen wir selbst.
  • Neue Regeln ohne neuen CodeNeue Fassungen von XRechnung und ZUGFeRD spielen wir ein. An Ihrem Aufruf ändert sich nichts.
  • Zwei Prüfkerne in einem ErgebnisWas Mustang oder der KoSIT-Validator findet, steht in derselben Antwort.

Regelstand und Grenzen

PrüfkerneMustang 2.26.0 · KoSIT 1.6.3
NormEN 16931, CII und UBL
XRechnung3.0.2
ZUGFeRD / Factur-Xbis 2.5.2 / 1.09.2
Größe je Anfrage50 MB JSON, rund 35 MB Dateien
Zeitlimit je Prüfung30 s
Gespeicherte Rechnungenkeine
ServerstandortNürnberg, Deutschland

Die Antwort sagt Ihrem Programm, welches Feld in welcher Zeile falsch ist und was hinein muss

Strukturiertes JSON statt eines Prüfprotokolls zum Lesen. Sie entscheiden im Code, ob eine Rechnung rausgeht, und zeigen Ihren Nutzern die Meldung auf Deutsch.

valid

true oder false. Gültig heißt: kein Fehler. Warnungen und Hinweise kann es trotzdem geben.

format, profile

Erkanntes Format mit Fassung, etwa ZUGFeRD 2.3.2, und das Profil.

errors, warnings, notices

Je Meldung rule_id, field als BT- oder BG-Nummer, message, fix_suggestion und xpath.

line, snippet

Zeile in der Datei und der Ausschnitt drumherum, auch bei XML in einer PDF.

metadata

Rechnungsnummer, Datum, Absender, Empfänger, Betrag und Währung.

Alle Felder in der Dokumentation

Mit einem Schlüssel prüfen, auslesen, reparieren, erzeugen und belegen

Dieselben Endpunkte nutzt unser Werkzeug im Browser. Was dort geht, geht auch aus Ihrem Code.

POST /v1/validate

Prüft PDF und XML gegen EN 16931, XRechnung und Factur-X.

POST /v1/validate/batch

Bis zu zehn Rechnungen in einem Aufruf.ab Automatisieren

POST /v1/extract

Holt das XML aus einer ZUGFeRD-PDF.

POST /v1/consistency

Vergleicht Nummer, Datum und Betrag der sichtbaren PDF mit dem XML.

POST /v1/repair

Behebt, was sich sicher ableiten lässt, und fragt den Rest ab.ab Automatisieren

POST /v1/create

Erzeugt aus JSON eine gültige ZUGFeRD-PDF oder XRechnung, zustandslos.

POST /v1/report

Liefert den Bericht als PDF/A-3, auf Wunsch mit der geprüften Datei.ab Automatisieren

Für KI-Agenten

  • Als MCP-ServerMit npx zugferd-mcp-client und Ihrem Schlüssel in ZUGFERD_API_KEY ruft ein KI-Agent wie Claude die Werkzeuge selbst auf.
  • Aus der Kommandozeilecurl, Mustang-CLI und CI-Pipeline, Schritt für Schritt unter ZUGFeRD per CLI prüfen.

Softwarehersteller prüfen die Rechnungen ihrer Software, Firmen ihren Rechnungslauf aus dem ERP

So nutzen Kunden die Schnittstelle heute. In den letzten 90 Tagen kamen mehr als 13.000 Aufrufe über die API.

In Ihrem Produkt

Hersteller von Kassen- und Branchensoftware prüfen die Rechnungen, die ihre Software erzeugt, beim Entwickeln und im Betrieb. Fällt eine durch, sieht es der Support, bevor der Kunde anruft.

Im eigenen Rechnungslauf

Ein Nachtlauf schickt alle Ausgangsrechnungen aus dem ERP durch die Prüfung. Was durchfällt, liegt morgens bei der Buchhaltung statt beim Kunden.

Testen ohne Kosten: kostenloser Schlüssel, Sandbox und Demo-Schlüssel

Bezahlt wird erst, wenn Ihre Software in Betrieb geht.

  • Kostenloser Schlüssel20 Prüfungen pro Woche, dauerhaft und ohne Kreditkarte.
  • Sandbox für das ErzeugenMit dem Sandbox-Schlüssel (zv_test_…) erzeugen Sie bis zu 100 Testrechnungen am Tag mit DEMO-Wasserzeichen. Prüfungen zählen normal.
  • Demo-Schlüssel ohne Anmeldungzv_demo_public_zugferd_2026, eine Anfrage am Tag je IP, für den ersten Versuch.
  • Beispiele in der Dokucurl, MCP und CI-Pipeline, dazu Fehlerfälle wie eine PDF ohne XML.

Von null zur ersten Prüfung in drei Schritten, meist in zehn Minuten

Den Rest der Stunde brauchen Sie, um die Meldungen in Ihrer Software anzuzeigen.

  1. Schlüssel holen

    E-Mail eintragen, Link anklicken, Schlüssel im Konto kopieren.

    etwa 2 Minuten
  2. Datei schicken

    Base64 in file_content, pdf oder xml in file_type, Schlüssel in X-Api-Key.

    etwa 5 Minuten
  3. Antwort auswerten

    Bei valid: false die Rechnung zurückhalten und die Meldungen anzeigen.

    je nach Programm

Preise

Entwickeln kostet nichts, im Betrieb ab 19 € im Monat mit SLA

Über dem Stundenlimit sperren wir nicht. Weitere Aufrufe laufen in einer langsameren Spur.

Prüfenzum Entwickeln
0 €im Monat

dauerhaft kostenlos

  • 20 Prüfungen pro Woche
  • Eine erzeugte Rechnung im Monat
  • Sandbox-Schlüssel für Testrechnungen
  • Prüfen, Auslesen, Abgleichen, Erzeugen, auch über MCP
Schlüssel holen
Automatisierenfür den Betrieb
19 €im Monat

jährlich abgerechnet, 228 € im Jahr · monatlich 22,80 €

  • 500 Prüfungen pro Woche
  • 60 Aufrufe in der Stunde mit voller Geschwindigkeit
  • Stapel, Reparatur und Bericht
  • Rechnungen erzeugen ohne Grenze und ohne unseren Hinweis
  • 99 % Verfügbarkeit als Ziel, Antwort binnen zwei Werktagen
Automatisieren buchen

Bei monatlicher Zahlung monatlich kündbar.

Skalierenfür große Mengen
69 €im Monat

jährlich abgerechnet, 828 € im Jahr · monatlich 82,80 €

  • Keine Wochengrenze
  • 300 Aufrufe in der Stunde mit voller Geschwindigkeit
  • Firmenkonto mit 10 Zugängen
  • Antwort binnen vier Stunden, wenn nichts mehr geht
Skalieren buchen

Bei monatlicher Zahlung monatlich kündbar.

Alle Preise zzgl. USt. Mehr als 300 Aufrufe in der Stunde? Enterprise mit Durchsatz nach Ihrer Menge. Die Fristen für Antworten gelten werktags von 9 bis 17 Uhr, alles Weitere unter Verfügbarkeit und Support.

Grenzen, Datenschutz, MCP: was Entwickler vor dem Einbau wissen wollen

Mehr steht in der Dokumentation. Oder schreib uns.

Was passiert über dem Stundenlimit?
Wir sperren nicht. Automatisieren läuft bis 60, Skalieren bis 300 Aufrufe in der Stunde mit voller Geschwindigkeit. Weitere Aufrufe laufen in einer langsameren Spur und bekommen freie Plätze. Ist der Server voll, antwortet er nach höchstens 20 Sekunden mit HTTP 503; dann versuchen Sie es später noch einmal.
Speichern Sie die Rechnungen?
Nein. Die Datei liegt nur für die Prüfung auf unserem Server in Nürnberg und wird danach gelöscht. Wir zählen, wann und wie oft Sie prüfen, nicht was in der Rechnung steht.
Wie viele Rechnungen passen in einen Aufruf?
Eine je /v1/validate, bis zu zehn je /v1/validate/batch. Eine Anfrage darf als JSON bis 50 MB groß sein, das sind rund 35 MB an Dateien.
Gibt es einen MCP-Server für KI-Agenten?
Ja: npx zugferd-mcp-client mit Ihrem Schlüssel in ZUGFERD_API_KEY. Er stellt validate_invoice, extract_xml, check_consistency, create_invoice und validation_report bereit.
Bekomme ich einen AVV und ein SLA?
Den Auftragsverarbeitungsvertrag schließen Sie im Konto ab, in jedem Tarif und ohne Unterschrift. Für Automatisieren und Skalieren gilt unser SLA mit 99 % Verfügbarkeit als Ziel.
Kann ich die Prüfung selbst betreiben?
Ja, mit dem Mustang-CLI und dem KoSIT-Validator; wie das geht, steht unter ZUGFeRD per CLI validieren. Die API nimmt Ihnen Betrieb, Java und Regelpflege ab.

Holen Sie sich den Schlüssel und schicken Sie noch heute die erste Rechnung durch die Prüfung

Kostenlos, ohne Kreditkarte, 20 Prüfungen pro Woche.

Kostenlosen Schlüssel holen Dokumentation lesen

Kein Abo nötig. Rechnungen speichern wir nicht.