Für Entwickler
Die ZUGFeRD-API und MCP für agentische KI-Workflows
Die Browser-Tools sind für Hände gebaut, die API dahinter für Code. Erstellen, validieren und konvertieren Sie E-Rechnungen mit einem HTTPS-Aufruf, aus jeder Sprache.
Jedes Werkzeug auf dieser Website läuft auf der InvoiceXML-ZUGFeRD-API: Die Formulare sammeln die Eingaben, die API erzeugt und prüft die Dateien. Für gelegentliche Rechnungen sind die Formulare die richtige Schnittstelle, und es gibt keinen Grund, Code zu schreiben. Sobald Rechnungen aus Ihrer eigenen Software kommen, nach Zeitplan oder durch eine CI-Pipeline, wird das Formular zum Umweg, und dieselbe Engine ist einen HTTPS-Aufruf entfernt.
ZUGFeRD-Rechnung programmatisch erzeugen
Ein POST mit der Rechnung als strukturiertem JSON liefert das fertige hybride PDF/A-3 zurück. Das Modell folgt EN 16931 Feld für Feld; das Standardprofil ist EN 16931, und eine offizielle Profil-URN wählt ein anderes, einschließlich XRechnung für öffentliche Auftraggeber. Die Referenz zu create/zugferd dokumentiert das vollständige Rechnungsmodell.
create-invoice.sh
HTTP API
# Konforme E-Rechnung in einem Aufruf erstellen
curl -X POST https://api.invoicexml.com/v1/create/zugferd \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"invoice": {
"invoiceNumber": "INV-2026-001",
"issueDate": "2026-10-01",
"currency": "EUR",
"seller": {
"name": "Acme GmbH",
"vatIdentifier": "DE123456789",
"postalAddress": {
"line1": "Hauptstrasse 1",
"city": "Berlin",
"postCode": "10115",
"country": "DE"
}
},
"buyer": {
"name": "Beispiel AG",
"postalAddress": {
"line1": "Marktplatz 5",
"city": "Hamburg",
"postCode": "20095",
"country": "DE"
}
},
"lines": [
{
"item": { "name": "Consulting" },
"quantity": 1,
"priceDetails": { "netPrice": 1000 },
"vatInformation": { "categoryCode": "S", "rate": 19 }
}
]
}
}'
# 200 OK · application/pdf
Datei aus der eigenen Pipeline validieren
Der Validierungs-Endpunkt nimmt die Datei als Multipart-Upload an und antwortet mit einem JSON-Bericht: das Urteil, das erkannte Profil und jede verletzte Regel mit ihrem Code. Jeder Endpunkt hat einen /report-Zwilling, der dieselben Prüfungen ausführt und stattdessen mit einem druckbaren PDF-Bericht antwortet, das Urteil im Antwort-Header X-Invoice-Valid. Die Referenz zu validate/zugferd zeigt vollständige Request- und Response-Beispiele.
validate-invoice.sh
HTTP API
# E-Rechnung in einem Aufruf validieren
curl -X POST https://api.invoicexml.com/v1/validate/zugferd \
-H "Authorization: Bearer sk_live_..." \
-F "[email protected]"
# { "valid": true, "data": { "profile": "en16931" }, "errors": [] }
Dieses curl-Skript ist zugleich die ehrliche Antwort auf die Suche nach einem ZUGFeRD-CLI: Ein offizielles Kommandozeilen-Tool gibt es nicht, und es braucht auch keines. Drei Zeilen in einem Shell-Skript validieren jede Datei eines Ordners, sichern einen nächtlichen Export ab oder lassen einen CI-Build an der ersten kaputten Rechnung scheitern.
Aus C#, .NET oder jeder anderen Sprache
Die API spricht schlichtes HTTPS mit JSON- und Multipart-Bodies, die Standardbibliothek jeder Sprache genügt also. In C# und .NET ist der Aufruf ein paar Zeilen HttpClient, ohne SDK und ohne NuGet-Abhängigkeit:
ValidateInvoice.cs
C# / .NET
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new("Bearer", apiKey);
using var form = new MultipartFormDataContent();
form.Add(new StreamContent(File.OpenRead("rechnung.pdf")), "file", "rechnung.pdf");
var response = await http.PostAsync("https://api.invoicexml.com/v1/validate/zugferd", form);
var report = await response.Content.ReadAsStringAsync();
Was die API abdeckt
- Erzeugen: hybride ZUGFeRD- und Factur-X-PDFs, XRechnung in CII- oder UBL-Syntax, Gutschriften und Order-X-Bestellungen, alles aus demselben JSON-Modell.
- Validieren: EN 16931, die deutsche XRechnung-CIUS und das Profil, das die Datei deklariert, als JSON oder als druckbarer PDF-Bericht.
- Konvertieren: zwischen CII, UBL, XRechnung und Factur-X, in beide Richtungen.
- Extrahieren und Einbetten: das XML aus einem hybriden PDF auslesen oder eigenes CII-XML in ein konformes PDF/A-3 verpacken.
- Rendern: E-Rechnungs-XML in ein sauberes, lesbares PDF verwandeln.
Authentifiziert wird mit einem Bearer-API-Schlüssel, abgerechnet nutzungsbasiert, und die vollständige Referenz mit Request- und Response-Schemata steht auf der InvoiceXML-Website: Zur API-Dokumentation
Wann der Browser reicht
Eine API verdient ihren Platz bei regelmäßigem Volumen, nicht vorher. Eine Handvoll Rechnungen im Monat ist Formular-Gebiet, und die gelegentliche Eingangsprüfung braucht keine Pipeline. Die Faustregel: Wiederkehrende Aufgaben, Rechnungen aus dem eigenen System oder Compliance-Gates in der CI rechtfertigen Code; alles darunter geht von Hand schneller. Die Entscheidungshilfe ZUGFeRD-Software vergleicht alle vier Wege.
Aus Claude, ChatGPT und anderen KI-Agenten nutzen
Der InvoiceXML-MCP-Server bringt dieselbe Engine über das Model Context Protocol zu KI-Assistenten. Verbinden Sie ihn mit Claude, ChatGPT oder einem anderen MCP-Client, und der Assistent kann ZUGFeRD- und XRechnung-Rechnungen als Teil einer größeren Aufgabe erstellen, validieren, konvertieren und auslesen, ganz ohne eigenen Integrationscode.
So wird die Rechnung zu einem Schritt in einem agentischen Workflow: eine Rechnung aus einer E-Mail oder Bestellung entwerfen, eine eingehende Lieferantendatei prüfen und ihre Fehler zusammenfassen oder einen Stapel konvertieren, bevor er in die Buchhaltung geht. Den InvoiceXML-MCP-Server einrichten