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)
Vorausgefüllter, normkonformer JSON-Payload gegen unser InvoiceRequest-Modell. Du kannst die Werte direkt editieren:
zg_test_ouroboros_001 (sofortige PDF/A-3 Generierung).
Code-Vergleich: Falsches vs. Korrektes CII-XML
<!-- PROBLEM: Das bisherige PDF besitzt ein eigenes, schönes Corporate Design, aber kein XML -->
<!-- Bisheriger Ansatz: Aufwändiges Neudesign im neuen Rechnungsgenerator notwendig -->
<!-- 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.
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 →Stripe Invoices zu ZUGFeRD & XRechnung automatisieren (EN 16931)
Wandle Stripe-Zahlungen und Invoices automatisch in rechtskonforme ZUGFeRD PDF/A-3 Rechnungen um. No-Code Blueprint für Make.com & n8n oder per REST-API.
SHOPIFY → E-RECHNUNGShopify-Bestellungen zu ZUGFeRD E-Rechnungen automatisieren (Make & API)
E-Rechnungspflicht für Shopify: Wandle Bestellungen per Make.com Blueprint oder REST-API automatisch in EN 16931-konforme ZUGFeRD PDF/A-3 Rechnungen um.
BR-DE-21Fehler BR-DE-21 beheben: Ungültiger Rechnungsartcode (BT-3) nach KoSIT
Löse Fehler BR-DE-21 in deiner E-Rechnung. Gültige UNTDID 1001 Codes für Rechnungen (380), Gutschriften (381) und Korrekturrechnungen (384) im Überblick.
BT-3BT-3 Rechnungsarten: Rechnung (380), Gutschrift (381) & Korrektur (384)
Die UNTDID 1001 Rechnungsart-Codes in BT-3 verstehen: Wann nutzt man Code 380, 381 oder 384 in ZUGFeRD & XRechnung? Mit Praxis-Beispielen und XML-Tags.