ZUGFeRD Ratgeber
XML Mapping für ZUGFeRD: Feldübersicht
Das XML-Mapping ist der Schlüssel zur korrekten Umsetzung von ZUGFeRD-Datenstrukturen. Dieser Leitfaden bietet eine präzise Übersicht über die Feldzuordnungen, um E-Rechnungen gemäß EN 16931 zu erstellen. Optimieren Sie Ihre Prozesse mit validen XML-Daten.
Im ZUGFeRD-Format basiert das XML-Mapping auf der CII-Syntax (UN/CEFACT Cross Industry Invoice) und dem semantischen Datenmodell der EN 16931. Jedes Datenfeld hat einen festen Pfad: Das Rechnungsdatum (BT-2) steht etwa in rsm:ExchangedDocument/ram:IssueDateTime/udt:DateTimeString, der Bruttogesamtbetrag (BT-112) in ram:GrandTotalAmount und der Zahlbetrag (BT-115) in ram:DuePayableAmount. Pflicht sind unter anderem Verkäufer (ram:SellerTradeParty) und Käufer (ram:BuyerTradeParty), während Felder wie ram:BuyerReference (BT-10) nach EN 16931 optional sind. Die korrekte Kodierung (UTF-8) und die Einhaltung der Schemastruktur sind essenziell, um Validierungsfehler zu vermeiden.
Häufige Fragen
Welche Pflichtfelder gibt es im ZUGFeRD-Mapping?
Zu den Pflichtfeldern gehören unter anderem die Rechnungsnummer (rsm:ExchangedDocument/ram:ID), das Rechnungsdatum (ram:IssueDateTime/udt:DateTimeString), die Währung (ram:InvoiceCurrencyCode), Verkäufer und Käufer (ram:SellerTradeParty, ram:BuyerTradeParty) sowie die Summen in ram:SpecifiedTradeSettlementHeaderMonetarySummation, etwa ram:GrandTotalAmount und ram:DuePayableAmount. Diese Felder sind gemäß EN 16931 erforderlich.
Wie validiere ich eine ZUGFeRD-XML-Datei?
Nutzen Sie ein XSD-Validierungstool, um Ihre XML-Datei gegen die ZUGFeRD-Schemadefinition zu prüfen. Für ZUGFeRD 2.1.1 verwenden Sie beispielsweise die EN16931-Schema-Datei, die auf der offiziellen ZUGFeRD-Seite bereitgestellt wird.
Wie gehe ich mit optionalen Feldern um?
Optionale Felder, wie z.B. <ram:BuyerReference>, können verwendet werden, um zusätzliche Informationen bereitzustellen. Diese Felder sollten nur eingefügt werden, wenn sie tatsächlich benötigt werden, um die Datei schlank zu halten.
Was sind häufige Fehler beim XML-Mapping?
Häufige Fehler beinhalten das Fehlen von Pflichtfeldern, falsche Datentypen (z.B. ein Textfeld statt eines Datumsfelds) oder ungültige Referenzen auf externe Codes (z.B. fehlerhafte ISO-Währungs-Codes in ram:InvoiceCurrencyCode).
Kann ich ZUGFeRD mit Factur-X kombinieren?
Ja, ZUGFeRD 2.1 und Factur-X sind kompatibel, da beide auf der EN 16931 basieren. Das XML-Mapping ist identisch, Sie müssen lediglich sicherstellen, dass die Metadaten den jeweiligen Spezifikationen entsprechen.
Verwandte Ratgeber
Bereit zum Test?