ZUGFeRD Ratgeber
Zusätzliche Dokumente im ZUGFeRD-Anhang einbetten
Das ZUGFeRD-Format erlaubt die Einbettung zusätzlicher Dokumente, wie z. B. Verträge, Lieferscheine oder technische Spezifikationen. In diesem Leitfaden erfahren Sie, wie genau Sie diese Anhänge korrekt integrieren, um den Standard einzuhalten.
Zusätzliche Dokumente werden im ZUGFeRD-XML (CII-Syntax) als rechnungsbegründende Unterlagen in ram:AdditionalReferencedDocument (BG-24) hinterlegt. Jede Unterlage erhält eine Kennung (ram:IssuerAssignedID, BT-122) und den Typcode 916; die Datei selbst wird Base64-codiert im Element ram:AttachmentBinaryObject (BT-125) übertragen, dessen Attribute mimeCode (z. B. 'application/pdf') und filename Dateityp und Dateinamen angeben. Sie können mehrere Anhänge hinzufügen, sofern die Gesamtgröße der Datei die technischen Limitierungen der Empfängerinfrastruktur nicht überschreitet.
Häufige Fragen
Welche Dateitypen kann ich im ZUGFeRD-Anhang einbetten?
Die EN 16931 lässt für eingebettete Anhänge (BT-125) nur bestimmte MIME-Typen zu: application/pdf, image/png, image/jpeg, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (XLSX) und application/vnd.oasis.opendocument.spreadsheet (ODS).
Gibt es eine Größenbeschränkung für Anhänge?
Technisch gibt es keine fixe Grenze im ZUGFeRD-Standard, jedoch kann die maximale Dateigröße durch die Infrastruktur Ihrer EDI-Plattform oder Ihres ERP-Systems limitiert sein. Üblich sind Grenzen zwischen 5 MB und 10 MB.
Wie stelle ich sicher, dass Anhänge korrekt Base64-codiert sind?
Nutzen Sie ein zuverlässiges Tool oder eine Bibliothek (z. B. `base64` in Python oder Java), um die Datei zu codieren. Verifizieren Sie die Kodierung durch einen Decode-Test, bevor Sie die Daten in die XML-Struktur einfügen.
Wie kann ich die Anhänge in der Rechnung sichtbar machen?
Die Anhänge werden als Teil der XML-Struktur eingebettet und können von kompatiblen ZUGFeRD-Parsern extrahiert werden. Stellen Sie sicher, dass der Empfänger ein System verwendet, das Anhänge unterstützt.
Kann ich mehrere Anhänge gleichzeitig einfügen?
Ja, Sie können mehrere ram:AdditionalReferencedDocument-Elemente hinzufügen. Jedes Element repräsentiert ein Dokument. Achten Sie darauf, dass jeder Anhang eindeutig identifizierbar ist, z. B. durch Kennung, Dateinamen oder Dokumentbeschreibung.
Verwandte Ratgeber
Bereit zum Test?