Aperçu de ZUGFeRD

Einführung

ZUGFeRD (Zentraler User Guide des Forums elektronische Rechnung Deutschland) ist ein deutscher E-Invoicing-Standard, der auf der UN/CEFACT Cross Industry Invoice (CII) und dem ISO-Standard 19005-3 (PDF/A-3) basiert. Er ermöglicht den Austausch strukturierter Rechnungsdaten in einer PDF-Datei.

DocBits extrahiert Felder aus ZUGFeRD-Dokumenten und gleicht sie mit Infor ERP-Systemen (M3, LN) unter Verwendung von OAGIS BOD-Standards ab.

Unterstützte ZUGFeRD-Versionen

DocBits unterstützt mehrere Versionen des ZUGFeRD-Standards:

• ZUGFeRD 1.0

• ZUGFeRD 2.0

• ZUGFeRD 2.1 (Factur-X 1.0)

• ZUGFeRD 2.2

• ZUGFeRD 2.3

• ZUGFeRD 2.3.2

Vollständige Header-Feldzuordnung

Invoice Identification

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
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
ExchangedDocument/IncludedNote	INVOICE_NOTE	Note	STRING	Invoice notes

Type et sous-type de document (piloté par TRA)

La même logique s'applique à Factur-X — Factur-X 1.x utilise le même vocabulaire CII que ZUGFeRD 2.x, donc le bloc dynamique ci-dessous est émis pour les deux.

En plus du INVOICE_TYPE_CODE brut, la XSLT TRANSFORMATION par défaut émet un arbre <INVOICE> canonique avec deux champs dérivés :

Champ DocBits	Source	Logique
INVOICE_TYPE	ExchangedDocument/TypeCode (ou HeaderExchangedDocument/TypeCode pour ZUGFeRD 1.0)	UNCL 1001 381 ou 261 → Credit Note ; tout autre code → Invoice
INVOICE_SUB_TYPE	Présence de BuyerOrderReferencedDocument/IssuerAssignedID (sous ApplicableHeaderTradeAgreement pour 2.x / ApplicableSupplyChainTradeAgreement pour 1.0)	Non vide → Purchase Invoice ; vide/absent → Cost Invoice

INVOICE_SUB_TYPE permet de distinguer les factures liées à un bon de commande des factures de coûts directs pour le routage AP.

Document References

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
BuyerOrderReferencedDocument/ID	PURCHASE_ORDER	CustomerOrderID	STRING	Purchase order number
ContractReferencedDocument/ID	CONTRACT_NUMBER	ContractID	STRING	Contract reference
DespatchAdviceReferencedDocument/ID	DELIVERY_NOTE	ShipmentID	STRING	Delivery note reference

Dates

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
ExchangedDocument/IssueDateTime	INVOICE_DATE	DocumentDateTime	DATE	Invoice date
ActualDeliverySupplyChainEvent/OccurrenceDateTime	DELIVERY_DATE	ActualShipDateTime	DATE	Delivery/ship date
SpecifiedTradePaymentTerms/DueDateDateTime	DUE_DATE	PaymentDueDateTime	DATE	Payment due date
BillingSpecifiedPeriod/StartDateTime	BILLING_PERIOD_START	BillingPeriodStart	DATE	Billing period start
BillingSpecifiedPeriod/EndDateTime	BILLING_PERIOD_END	BillingPeriodEnd	DATE	Billing period end

Supplier (Seller) Information

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
SellerTradeParty/ID	VENDOR_ID	SupplierPartyID	STRING	Supplier ID
SellerTradeParty/GlobalID	VENDOR_GLN	SupplierPartyGLN	STRING	Global Location Number
SellerTradeParty/Name	VENDOR_NAME	SupplierPartyName	STRING	Supplier name
SellerTradeParty/PostalTradeAddress/Line1	VENDOR_ADDRESS	SupplierAddress1	STRING	Address line 1
SellerTradeParty/PostalTradeAddress/Line2	VENDOR_ADDRESS_2	SupplierAddress2	STRING	Address line 2
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
SellerTradeParty/SpecifiedTaxRegistration/ID	VAT_NO_EXTRACTED	SupplierTaxID	STRING	VAT registration number
SellerTradeParty/DefinedTradeContact/EmailURIID	VENDOR_EMAIL	SupplierEmail	STRING	Email
SellerTradeParty/DefinedTradeContact/TelephoneUniversalCommunication	VENDOR_PHONE	SupplierPhone	STRING	Phone

Buyer Information

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
BuyerTradeParty/ID	COMPANY_ID	CustomerPartyID	STRING	Customer ID
BuyerTradeParty/GlobalID	COMPANY_GLN	CustomerPartyGLN	STRING	Global Location Number
BuyerTradeParty/Name	COMPANY_NAME	CustomerPartyName	STRING	Company name
BuyerTradeParty/PostalTradeAddress/Line1	COMPANY_ADDRESS	CustomerAddress1	STRING	Address line 1
BuyerTradeParty/PostalTradeAddress/PostcodeCode	COMPANY_POSTAL_CODE	CustomerPostalCode	STRING	Postal code
BuyerTradeParty/PostalTradeAddress/CityName	COMPANY_CITY	CustomerCity	STRING	City
BuyerTradeParty/PostalTradeAddress/CountryID	COMPANY_COUNTRY	CustomerCountryCode	STRING	Country code
BuyerTradeParty/SpecifiedTaxRegistration/ID	COMPANY_VAT_ID	CustomerTaxID	STRING	VAT ID

Payment Information

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
PayeePartyCreditorFinancialAccount/IBANID	IBAN_EXTRACTED	PayeeIBAN	STRING	IBAN
PayeeSpecifiedCreditorFinancialInstitution/BICID	BIC	PayeeBIC	STRING	BIC/SWIFT code
SpecifiedTradePaymentTerms/Description	PAYMENT_TERMS	PaymentTerms	STRING	Payment terms description
SpecifiedTradeSettlementPaymentMeans/TypeCode	PAYMENT_METHOD	PaymentMethod	STRING	Payment method code

Currency & Amounts (Header Level)

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
InvoiceCurrencyCode	CURRENCY	CurrencyCode	STRING	Invoice currency
TaxBasisTotalAmount	TOTAL_NET_AMOUNT	TaxBasisTotalAmount	AMOUNT	Total net amount
TaxTotalAmount	TOTAL_TAX_AMOUNT	TaxTotalAmount	AMOUNT	Total tax amount
GrandTotalAmount	TOTAL_AMOUNT	GrandTotalAmount	AMOUNT	Grand total
DuePayableAmount	AMOUNT_DUE	DuePayableAmount	AMOUNT	Amount due
TotalPrepaidAmount	PREPAID_AMOUNT	TotalPrepaidAmount	AMOUNT	Prepaid amount
AllowanceTotalAmount	NEGATIVE_AMOUNT	AllowanceTotalAmount	AMOUNT	Total allowances
ChargeTotalAmount	CHARGES	ChargeTotalAmount	AMOUNT	Total charges

Ventilation des taxes (classification par tranches)

La XSLT TRANSFORMATION par défaut distribue les blocs ApplicableTradeTax sur trois tranches basées sur le taux plutôt que d'utiliser des index positionnels. Chaque bloc est associé à une tranche par son RateApplicablePercent :

Tranche	Champs DocBits	Règle de sélection
Tranche 1 (Standard)	TAX_RATE, NET_AMOUNT, TAX_AMOUNT	taux ≥ 19
Tranche 2 (Réduit)	TAX_RATE_2, NET_AMOUNT_2, TAX_AMOUNT_2	0 < taux < 19
Tranche 3 (Zéro)	TAX_RATE_3, NET_AMOUNT_3, TAX_AMOUNT_3	taux = 0

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
ApplicableTradeTax/RateApplicablePercent (tranche 1)	TAX_RATE	TaxPercent	NUMBER	Pourcentage de TVA au taux standard
ApplicableTradeTax/BasisAmount (tranche 1)	NET_AMOUNT	TaxableAmount	AMOUNT	Montant net au taux standard
ApplicableTradeTax/CalculatedAmount (tranche 1)	TAX_AMOUNT	TaxAmount	AMOUNT	Montant de taxe au taux standard
ApplicableTradeTax/RateApplicablePercent (tranche 2)	TAX_RATE_2	TaxPercent2	NUMBER	Pourcentage de TVA au taux réduit
ApplicableTradeTax/BasisAmount (tranche 2)	NET_AMOUNT_2	TaxableAmount2	AMOUNT	Montant net au taux réduit
ApplicableTradeTax/CalculatedAmount (tranche 2)	TAX_AMOUNT_2	TaxAmount2	AMOUNT	Montant de taxe au taux réduit
ApplicableTradeTax/RateApplicablePercent (tranche 3)	TAX_RATE_3	TaxPercent3	NUMBER	Pourcentage de TVA au taux zéro
ApplicableTradeTax/BasisAmount (tranche 3)	NET_AMOUNT_3	TaxableAmount3	AMOUNT	Montant net au taux zéro
ApplicableTradeTax/CalculatedAmount (tranche 3)	TAX_AMOUNT_3	TaxAmount3	AMOUNT	Montant de taxe au taux zéro

Mappage complet des lignes d'articles (tableau)

Line Identification

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
AssociatedDocumentLineDocument/LineID	POSITION	LineNumber	STRING	Line number
SpecifiedTradeProduct/BuyerAssignedID	ITEM_NUMBER	BuyerItemID	STRING	Buyer's item number
SpecifiedTradeProduct/SellerAssignedID	SUPPLIER_ITEM_NUMBER	SellerItemID	STRING	Seller's item number
SpecifiedTradeProduct/GlobalID	ITEM_CODE	ItemCode	STRING	Global ID (GTIN/EAN)
SpecifiedTradeProduct/Name	DESCRIPTION	ItemDescription	STRING	Item description

Line References

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
BuyerOrderReferencedDocument/ID	PURCHASE_ORDER	CustomerOrderID	STRING	Line-level PO number
BuyerOrderReferencedDocument/LineID	PO_LINE_NUMBER	CustomerOrderLineNumber	STRING	PO line number
DespatchAdviceReferencedDocument/ID	DELIVERY_NOTE	ShipmentID	STRING	Delivery note
DespatchAdviceReferencedDocument/LineID	DELIVERY_LINE	ShipmentLineNumber	STRING	Delivery line

Quantities & Units

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
BilledQuantity	QUANTITY	InvoicedQuantity	NUMBER	Billed quantity
BilledQuantity/@unitCode	UNIT	UnitCode	STRING	Unit of measure code
PackageQuantity	PACKAGE_QUANTITY	PackageQuantity	NUMBER	Number of packages

Pricing

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
NetPriceProductTradePrice/ChargeAmount	UNIT_PRICE	UnitPrice	AMOUNT	Net unit price
GrossPriceProductTradePrice/ChargeAmount	GROSS_PRICE	GrossUnitPrice	AMOUNT	Gross unit price
NetPriceProductTradePrice/BasisQuantity	UNIT_PRICE_PER_QUANTITY	PricePerQuantity	NUMBER	Price basis quantity

Line Amounts

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
LineTotalAmount	TOTAL_AMOUNT	ExtendedAmount	AMOUNT	Line total
TotalAllowanceChargeAmount	NET_AMOUNT	NetAmount	AMOUNT	Line net amount

Line Tax

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
ApplicableTradeTax/RateApplicablePercent	VAT	TaxPercent	NUMBER	VAT rate
ApplicableTradeTax/TypeCode	TAX_CODE	TaxCode	STRING	Tax type code
ApplicableTradeTax/CategoryCode	TAX_CATEGORY	TaxCategoryCode	STRING	Tax category

Allowances & Charges (Line Level)

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
AppliedTradeAllowanceCharge/ActualAmount	DISCOUNT	AllowanceAmount	AMOUNT	Discount amount
AppliedTradeAllowanceCharge/CalculationPercent	DISCOUNT_PERCENT	AllowancePercent	NUMBER	Discount percentage
AppliedTradeAllowanceCharge/ActualAmount	SURCHARGE	ChargeAmount	AMOUNT	Surcharge amount
AppliedTradeAllowanceCharge/Reason	ALLOWANCE_REASON	AllowanceReason	STRING	Reason for allowance

Additional Line Fields

ZUGFeRD CII Path	DocBits Field	Infor BOD Field	Type	Description
SpecifiedTradeProduct/OriginTradeCountry/ID	COUNTRY_OF_ORIGIN	CountryOfOrigin	STRING	Country of origin
SpecifiedTradeProduct/ApplicableProductCharacteristic/Value	PRODUCT_CHARACTERISTIC	ProductCharacteristic	STRING	Product characteristic
ActualDeliverySupplyChainEvent/OccurrenceDateTime	DELIVERY_DATE	ActualDeliveryDate	DATE	Line delivery date