Deutsche Freiberufler
Freiberufler brauchen oft ein lesbares PDF, das zugleich maschinenlesbare Rechnungsdaten enthält. Das hilft, wenn Empfänger noch nicht alle auf derselben Infrastruktur sind.
Hybrider PDF-Workflow
ZUGFeRD API — Hybride PDF/A-3 Rechnungen
Teams in deutschen und französischen Rechnungsprozessen brauchen oft eine Datei, die Menschen lesen und Systeme automatisch verarbeiten können.
Die eigentliche Schwierigkeit ist nicht der Name des Standards, sondern die korrekte Erzeugung eines Hybrid-PDFs mit eingebettetem XML und sauberer Validierung.
PDF/A-3-AusgabeFactur-X = ZUGFeRDValidierung inklusive
01QuoteCash
Hybrides Ergebnis
POST /api/v1/invoices/zugferd liefert Base64-PDF und XML in einer Antwort zurück, nachdem das XML in das PDF/A-3-Dokument eingebettet wurde.
02QuoteCash
Validierungspfad
Auch bei Validierungsfehlern bleiben Artefakt und Fehlerdetails erhalten, was Reparatur- und Ausnahmeprozesse erleichtert.
03QuoteCash
Gemeinsames Zugriffsmodell
Wie bei den übrigen Public-API-Endpunkten gelten geschäftsbezogene Keys, Planlimits und optionales Stripe-Metering.
API details
Wie QuoteCash ZUGFeRD und Factur-X-PDFs erzeugt
QuoteCash stellt hybride Rechnungserzeugung über POST /api/v1/invoices/zugferd bereit. Der Endpoint wandelt JSON in CII-XML um, validiert dieses XML, erzeugt ein PDF und bettet das XML in die PDF/A-3-Ausgabe ein.
ZUGFeRD 2.x und Factur-X 1.x sind derselbe Standard, keine getrennten Produkte. Der Validierungs-Endpoint akzeptiert zugferd, factur-x, facturx und cii als Aliasnamen für dieselbe Validierungslogik.
Weil die Antwort Artefakt und Validierung gemeinsam enthält, können Teams Fehlerfälle sauber in Ausnahmebehandlung und Nacharbeit überführen, ohne PDF und XML lokal neu aufzubauen.
Audience fit
Für wen ist das gedacht?
Belgische KMU
Grenzüberschreitende Teams können Dokumentverzweigungen reduzieren, wenn sie einen hybriden Rechnungsweg statt mehrerer PDF-Varianten pflegen.
SaaS-Entwickler
Produkte mit Billing-Funktion brauchen ein Ergebnis, das direkt an Nutzer zurückgegeben oder archiviert werden kann. PDF und XML in einer Antwort halten die Pipeline einfach.
Agenturen und Reseller
Das Validierungsfeedback zeigt klar, ob das Problem im Request oder im erzeugten Dokument liegt. Das ist für Migrationen und Pilotphasen entscheidend.
ERP-Integratoren
Integratoren brauchen planbare Status- und Artefaktlogik. Validierungsergebnis plus Datei lassen sich besser in Ausnahme-Queues integrieren als ein Black-Box-PDF-Export.
Search intent
Häufige Fragen
- Was ist der Unterschied zwischen ZUGFeRD und Factur-X?
- ZUGFeRD und Factur-X sind derselbe Standard. ZUGFeRD ist der deutsche Name, Factur-X der französische Name für dasselbe EN-16931-basierte Hybridformat.
- Liefert QuoteCash ein Hybrid-PDF oder nur XML?
- Der ZUGFeRD-Endpoint liefert ein Hybrid-PDF zusammen mit dem erzeugten XML und Validierungsdetails. In diesem Projekt wird das XML vor der Antwort in eine PDF/A-3-Datei eingebettet.
- Kann ich Factur-X- oder ZUGFeRD-XML separat validieren?
- Ja. POST /api/v1/validate akzeptiert zugferd, factur-x, facturx und cii und liefert strukturierte Validierungsergebnisse zurück.
- Warum liefert eine ZUGFeRD-API 422, obwohl die Datei erzeugt wurde?
- Die API liefert 422, wenn der Request akzeptiert wurde, aber das erzeugte Dokument die Validierung nicht besteht. PDF, XML und Fehlerdetails bleiben dennoch verfügbar.
- Ist ZUGFeRD für Teams zwischen Deutschland und Frankreich geeignet?
- Ja, weil ZUGFeRD und Factur-X dasselbe Format unter unterschiedlichen lokalen Namen sind. Das ist nützlich, wenn eine Integration deutsch- und französischsprachige Kunden bedienen muss.