ZUGFeRD 2.5.2 / Factur-X 1.09.2 (PDF/A-3 mit eingebettetem XML)
download_invoice_zugferdTarif: in jedem Tarif (Free, Pro, Business).
ZUGFeRD 2.5.2 / Factur-X 1.09.2 (PDF/A-3 mit eingebettetem XML)
Das Rechnungs-PDF als PDF/A-3 (ISO 19005-3) mit eingebettetem CII-XML (factur-x.xml) nach ZUGFeRD 2.5.2 / Factur-X 1.09.2. Profil je Rechnung: BASIC, EN 16931 (COMFORT, Vorgabe) oder EXTENDED. Mit Accept: application/json: { filename, warnings }. Gegen den Mustang-Validator (veraPDF + Profil-Schematron) geprüft; abwärtskompatibel bis ZUGFeRD 2.0.1 (BMF-Untergrenze § 14 UStG). Das eingebettete XML wird beim Festschreiben eingefroren.
Asynchron. Die Wandlung läuft in einer Warteschlange; bereits erzeugte Dateien kommen sofort (Cache nach Inhalt, festgeschriebene Belege werden beim Festschreiben vorab erzeugt). Ist die Datei nicht binnen wait Sekunden fertig, antwortet der Endpunkt mit 202 + Job-Objekt und Location: /api/v1/jobs/{id} — dort pollen oder auf das Webhook-Event invoice.zugferd_ready warten, danach diesen Endpunkt erneut abrufen. Höchstens 100 offene Aufträge je Konto (sonst 429).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "download_invoice_zugferd"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Interne `id` der Rechnung (UUID), nicht die Belegnummer. Zu einer Nummer (z. B. `RE-2026-0004`) liefert `GET /invoices?number=…` (MCP: `list_invoices` mit `number`) die `id`. | |
| wait | No | Sekunden, die der Aufruf auf die fertige Datei wartet, bevor er mit 202 antwortet (0–60, Vorgabe 30). |