ZUGFeRD 2.0 Mapping
Overview
ZUGFeRD 2.0 was designed to be compliant with the European standard EN 16931. It uses the UN/CEFACT CII D16B structure.
Header Field Mapping
Invoice Identification
ExchangedDocument/ID
INVOICE_NUMBER
DocumentID
STRING
Invoice number
ExchangedDocument/TypeCode
INVOICE_TYPE_CODE
DocumentType
STRING
Invoice type code
ExchangedDocument/IssueDateTime
INVOICE_DATE
DocumentDateTime
DATE
Invoice issue date
Document Type & Sub-Type (TRA-driven)
Alongside the raw INVOICE_TYPE_CODE, the default TRANSFORMATION XSLT emits two derived fields:
INVOICE_TYPE
CrossIndustryInvoice/ExchangedDocument/TypeCode
UNCL 1001 381 or 261 → Credit Note; any other code → Invoice
INVOICE_SUB_TYPE
SupplyChainTradeTransaction/ApplicableHeaderTradeAgreement/BuyerOrderReferencedDocument/IssuerAssignedID
Non-empty → Purchase Invoice; empty/missing → Cost Invoice
Tax Breakdown (Tier-classified)
ApplicableTradeTax blocks are distributed across three rate-based tiers (not positional indexes): standard-rate fields (TAX_RATE / NET_AMOUNT / TAX_AMOUNT) capture rate ≥ 19; reduced-rate fields (*_2) capture 0 < rate < 19; zero-rate fields (*_3) capture rate = 0. See ZUGFeRD Tax Breakdown for the full field list.
Dates
ActualDeliverySupplyChainEvent/OccurrenceDateTime
DELIVERY_DATE
ActualShipDateTime
DATE
Delivery/ship date
SpecifiedTradePaymentTerms/DueDateDateTime
DUE_DATE
PaymentDueDateTime
DATE
Payment due date
Supplier (Seller) Information
SellerTradeParty/ID
VENDOR_ID
SupplierPartyID
STRING
Supplier ID
SellerTradeParty/Name
VENDOR_NAME
SupplierPartyName
STRING
Supplier name
SellerTradeParty/PostalTradeAddress/Line1
VENDOR_ADDRESS
SupplierAddress1
STRING
Address line 1
SellerTradeParty/PostalTradeAddress/PostcodeCode
VENDOR_POSTAL_CODE
SupplierPostalCode
STRING
Postal code
SellerTradeParty/PostalTradeAddress/CityName
VENDOR_CITY
SupplierCity
STRING
City
SellerTradeParty/PostalTradeAddress/CountryID
VENDOR_COUNTRY
SupplierCountryCode
STRING
Country code
Line Item Mapping
AssociatedDocumentLineDocument/LineID
POSITION
LineNumber
STRING
Line number
SpecifiedTradeProduct/BuyerAssignedID
ITEM_NUMBER
BuyerItemID
STRING
Buyer's item number
SpecifiedTradeProduct/Name
DESCRIPTION
ItemDescription
STRING
Item description
BilledQuantity
QUANTITY
InvoicedQuantity
NUMBER
Billed quantity
NetPriceProductTradePrice/ChargeAmount
UNIT_PRICE
UnitPrice
AMOUNT
Net unit price
LineTotalAmount
TOTAL_AMOUNT
ExtendedAmount
AMOUNT
Line total
Last updated
Was this helpful?