llms.txt Content
# ZUGFeRD Validator
> Gehostete REST API und MCP-Client zum Validieren UND Erstellen von ZUGFeRD-, Factur-X- und XRechnung-E-Rechnungen gegen den europäischen Standard EN 16931.
## Was ist ZUGFeRD Validator?
ZUGFeRD Validator ist ein API-Dienst, der es KI-Agenten und Entwicklern ermöglicht, deutsche und europäische E-Rechnungen automatisch auf Konformität zu prüfen UND aus strukturierten Daten valide E-Rechnungen zu erzeugen. Die Validierung erfolgt gegen EN 16931 (europäischer Standard für elektronische Rechnungen) mit dem Mustang Project als Validierungsengine.
Unterstützte Formate:
- ZUGFeRD 2.x (alle Profile: MINIMUM, BASIC-WL, BASIC, EN16931, EXTENDED)
- Factur-X (französisches Äquivalent zu ZUGFeRD)
- XRechnung (deutsche Verwaltungsstandard)
## API-Endpunkte
Basis-URL: `https://api.zugferd-validator.de`
### POST /v1/validate
Validiert eine E-Rechnung (PDF oder XML) gegen EN 16931.
- Input: `{ file_content: string (base64), file_type: "pdf"|"xml" }`
- Output: Validierungsergebnis mit Fehlern, Warnungen, Korrekturvorschlägen und Metadaten
- Auth: `X-Api-Key` Header
### POST /v1/extract
Extrahiert das eingebettete XML aus einem ZUGFeRD/Factur-X PDF.
- Input: `{ pdf_content: string (base64) }`
- Output: `{ xml: string }`
### POST /v1/consistency
Prüft ob die sichtbaren PDF-Daten mit den eingebetteten XML-Daten übereinstimmen.
- Input: `{ pdf_content: string (base64) }`
- Output: Konsistenzprüfung mit gefundenen Abweichungen
### POST /v1/create
Erstellt aus strukturierten Daten eine valide E-Rechnung (ZUGFeRD-PDF oder XRechnung-XML).
- Input: `{ format: "zugferd"|"xrechnung", number, date, seller, buyer, lines[], ... }` (Beträge in Cent)
- Output: `{ format, profile, pdf_base64? (nur zugferd), xml, branding }`
- Auth: `X-Api-Key` Header. Stateless — es wird nichts gespeichert.
- Unterstützt mehrere Positionen, alle USt-Kategorien (S/Z/E/AE), Rabatte/Zuschläge, Leitweg-ID für B2G.
- Belegtypen (`document_type`): Rechnung, Gutschrift/Sto