Z E-Rechnung API
Startseite › E-Rechnung Wissen › Automatisierung › PDF-OVERLAY (/EMBED)
Automatisierung • PDF-OVERLAY (/EMBED)

Bestehende PDF-Rechnung in ZUGFeRD umwandeln: Factur-X XML per API einbetten

Wenn dein ERP, CRM oder Shop bereits perfekte Kunden-PDFs erzeugt, musst du dein Layout nicht neu bauen. Über den Endpunkt /v1/invoice/embed bettest du das EN-16931 XML unsichtbar ein und konvertierst es in PDF/A-3.

Eigene Rechnung hier hineinziehen

oder Datei vom Computer auswählen (.pdf oder .xml bis 10 MB)

🔒 100 % flüchtige RAM-Prüfung auf deutschen Servern (Frankfurt) – keine Speicherung.

Code-Vergleich: Falsches vs. Korrektes CII-XML

✗ Häufiger Fehler / Falsches XML Nicht konform
<!-- PROBLEM: Das bisherige PDF besitzt ein eigenes, schönes Corporate Design, aber kein XML -->
<!-- Bisheriger Ansatz: Aufwändiges Neudesign im neuen Rechnungsgenerator notwendig -->
✓ Valide nach EN 16931 / KoSIT Normkonform
<!-- LÖSUNG: POST /v1/invoice/embed bettet factur-x.xml nahtlos in dein Original-PDF ein -->
<!-- Das PDF bleibt optisch 100% identisch, ist aber ab sofort nach ISO 19005-3 (PDF/A-3) konform -->

Technische Ursache & Lösung

Viele Unternehmen investieren viel Zeit in das Design ihrer Rechnungen (Briefpapier, Typografie, Tabellenlayouts). Die Einführung der E-Rechnungspflicht bedeutet nicht, dass du dein Design aufgeben musst.

Mit unserem Endpunkt `POST /v1/invoice/embed` lädst du einfach dein bestehendes Kunden-PDF zusammen mit den Rechnungsdaten hoch.

Unsere Engine konvertiert das Dokument verlustfrei in ein standardkonformes PDF/A-3, generiert das EN 16931 Factur-X XML und bettet es mit dem Attribut `/AFRelationship /Alternative` im PDF-Katalog ein. Das Ergebnis besteht jede Schematron- und PDF/A-3 Validierung.

⚡ Die schlüsselfertige Abkürzung für Entwickler & No-Code

Keine Lust auf XML-Schematron-Fehler und Rundungsdifferenzen?

Unsere E-Rechnung Cloud API übernimmt alle mathematischen Berechnungen, Steuerregeln, XSD-Schemata und die PDF/A-3 Konvertierung vollautomatisch im Hintergrund.

Häufig gestellte Fragen (FAQ)

Wird mein bestehendes PDF-Layout verändert?

Nein. Die visuellen Seiten bleiben zu 100% unverändert. Es werden lediglich die PDF/A-3 XMP-Metadaten und der unsichtbare XML-Anhang hinzugefügt.

Welche PDF-Versionen werden für /embed unterstützt?

Wir unterstützen alle gängigen PDF-Versionen (PDF 1.3 bis PDF 2.0) bis zu einer Dateigröße von 10 MB.

Wie teste ich den /embed Endpunkt?

Du kannst ihn direkt über unsere interaktive OpenAPI-Dokumentation (/docs) mit dem Test-Key zg_test_ouroboros_001 testen.

Passende Themen & Normen

Alle 12 Themen ansehen →