Diese Seite ist auf Deutsch. English version: Factur-X / ZUGFeRD API

Was ist eine ZUGFeRD-Rechnung?

Eine ZUGFeRD-Rechnung ist eine hybride E-Rechnung: eine einzige PDF-Datei, die ein Mensch wie eine gewöhnliche Rechnung liest — und in der gleichzeitig die strukturierten Rechnungsdaten als XML stecken, das Buchhaltungssoftware automatisch verarbeitet. Technisch: ein PDF/A-3-Dokument mit einer eingebetteten Datei namens factur-x.xml im UN/CEFACT-CII-Format. Factur-X (Frankreich) und ZUGFeRD 2.x (Deutschland) sind derselbe Standard unter zwei Namen.

Beispiel: so sieht eine ZUGFeRD-Rechnung aus

Von außen ein ganz normales Rechnungs-PDF — genau das ist die Idee. Hier ist ein echtes, generiertes Beispiel samt dem XML, das darin eingebettet ist:

Muster gefällig, ohne irgendetwas zu installieren? Die Sandbox auf der Startseite nimmt eingefügtes Rechnungs-XML entgegen und liefert ein echtes Factur-X-PDF mit Wasserzeichen zurück — ohne Konto, direkt im Browser.

Das Format technisch, in drei Sätzen

Der Träger ist PDF/A-3, das Archivformat, das eingebettete Dateien erlaubt. Die Rechnungsdaten liegen als factur-x.xml (UN/CEFACT Cross-Industry Invoice) im PDF, dazu deklarieren XMP-Metadaten das Profil. Es gibt fünf Profile — Minimum, Basic WL, Basic, EN 16931 und Extended — die festlegen, wie viele strukturierte Felder das XML tragen muss; das XML wird gegen die offizielle XSD des deklarierten Profils geprüft.

ZUGFeRD oder XRechnung?

Beides sind E-Rechnungen, aber verschiedene Formate. Die XRechnung ist reines XML ohne PDF-Anteil und vor allem im Geschäft mit öffentlichen Auftraggebern zu Hause. ZUGFeRD/Factur-X ist der hybride Weg: ein Dokument, das beide Welten bedient — Menschen und Software. PDFik erzeugt ZUGFeRD/Factur-X und bewusst keine XRechnung; was wir nicht können, behaupten wir nicht.

Wie erstellt man eine ZUGFeRD-Rechnung?

  • Buchhaltungssoftware: viele Pakete exportieren ZUGFeRD direkt — der einfachste Weg, wenn die Rechnung ohnehin dort entsteht.
  • Open-Source-Bibliotheken: Mustangproject (Java), horstoeko/zugferd (PHP), factur-x von Akretion (Python) — volle Kontrolle, eigene Wartung.
  • Rechnungsdesign ohne Code: Im PDFik-Dashboard gestalten Sie das Rechnungs-PDF selbst — Logo, Farben, 8 Schriften, Seitenformate von A4 bis Legal, eigene Feldbezeichnungen, Live-Vorschau und 10 Sprachvorlagen. Dieses Design verwendet die API dann für jede ZUGFeRD-Rechnung.
  • Per API: Sie liefern das CII-XML, PDFik baut die hybride PDF/A-3 mit eingebettetem factur-x.xml darum. Validierung gegen die offizielle XSD passiert vor dem Rendern — ungültiges XML kostet keine Quota. Eigenes Rechnungsdesign bleibt erhalten: das XML lässt sich auch an eine URL- oder HTML-Render-Anfrage anhängen.

Der API-Weg ist bei PDFik auf jedem Plan enthalten, auch im kostenlosen — 100 PDFs und 0,5 GB im Monat, ohne Kreditkarte. Das Rendering läuft auf AWS in der EU (Frankfurt).

In der Sandbox testen — ohne KontoTechnische Details (EN)

Häufige Fragen

Was ist eine ZUGFeRD-Rechnung?

Eine hybride elektronische Rechnung: eine einzige PDF/A-3-Datei, die ein Mensch wie eine gewöhnliche Rechnung liest, während Buchhaltungssoftware die strukturierten Daten aus einer eingebetteten XML-Datei (factur-x.xml, UN/CEFACT Cross-Industry Invoice) verarbeitet. Factur-X (Frankreich) und ZUGFeRD 2.x (Deutschland) sind derselbe Standard unter zwei Namen.

Wie sieht eine ZUGFeRD-Rechnung aus?

Wie ein normales Rechnungs-PDF — das ist der Punkt. Der Unterschied steckt innen: PDF/A-3 als Container, eine eingebettete factur-x.xml mit den Rechnungsdaten und XMP-Metadaten, die das Profil deklarieren. Oben auf dieser Seite gibt es ein Beispiel-PDF und das zugehörige XML zum Herunterladen.

Welche ZUGFeRD-Profile gibt es?

Fünf: Minimum, Basic WL, Basic, EN 16931 (der übliche Standard) und Extended. Das Profil bestimmt, wie viele strukturierte Daten das XML tragen muss. Das eingebettete XML wird gegen die offizielle XSD des deklarierten Profils geprüft — ungültiges XML ergibt eine klare Fehlermeldung statt einer kaputten Rechnung.

Ist ZUGFeRD dasselbe wie XRechnung?

Nein. Die XRechnung ist ein reines XML-Format ohne PDF-Anteil, vor allem für öffentliche Auftraggeber in Deutschland. ZUGFeRD/Factur-X ist hybrid: PDF plus XML in einer Datei. PDFik erzeugt ZUGFeRD/Factur-X-PDFs und keine XRechnung — wer eine reine XRechnung braucht, braucht ein anderes Werkzeug.

Wie erstelle ich eine ZUGFeRD-Rechnung aus meinem eigenen System?

Drei übliche Wege: eine Buchhaltungssoftware mit ZUGFeRD-Export; eine Open-Source-Bibliothek wie Mustangproject (Java), horstoeko/zugferd (PHP) oder factur-x (Python); oder eine API wie PDFik — Sie liefern das CII-XML, zurück kommt die fertige hybride PDF/A-3. Bei PDFik ist das auf jedem Plan enthalten, auch im kostenlosen, ohne Kreditkarte.

Technische Referenz (Englisch): docs.pdfik.net/einvoicing. Etwas unklar oder veraltet? [email protected]