ZUGFeRD 2.3.2 Mapping
Overview
ZUGFeRD 2.3.2 is a maintenance release of the 2.3 standard, ensuring compatibility with the latest CII updates.
Header Field Mapping
Invoice Identification
ExchangedDocument/ID
INVOICE_NUMBER
DocumentID
STRING
Invoice number
ExchangedDocument/IssueDateTime
INVOICE_DATE
DocumentDateTime
DATE
Invoice issue date
Document Type & Sub-Type (TRA-driven)
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 [1]/[2]/[3]): 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.
ApplicableTradeTax/RateApplicablePercent (tier 1)
TAX_RATE
TaxPercent
NUMBER
Standard-rate VAT (≥ 19)
ApplicableTradeTax/BasisAmount (tier 1)
NET_AMOUNT
TaxableAmount
AMOUNT
Standard-rate net amount
ApplicableTradeTax/CalculatedAmount (tier 1)
TAX_AMOUNT
TaxAmount
AMOUNT
Standard-rate tax amount
Line Item Mapping
AssociatedDocumentLineDocument/LineID
POSITION
LineNumber
STRING
Line 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?