CII Invoice (Factur-X / ZUGFeRD)

UN/CEFACT Cross Industry Invoice D16B — base format for Factur-X and ZUGFeRD

EN16931 profile · Factur-X 1.08 · XRechnung not included

Drag and drop your XML file here

or click to browse

XML only · 1 MB max · 20 transactions

Guided demo samples

Use these only to preview the diagnostics experience. Your own XML remains the main workflow.

Prefer downloads? valid XML or invalid XML

Files are processed in memory only — nothing is stored or transmitted to third parties.

Supported features

+CII document type detection (CrossIndustryInvoice namespace)
+Business hierarchy: CII format -> EN16931 profile -> Factur-X subprofiles
+Profile ID validation (GuidelineSpecifiedDocumentContextParameter/ID)
+Mandatory field checks (BR-02, BR-03, BR-04, BR-06, BR-07)
+Invoice type code validation (UNTDID 1001)
+Header totals, line totals, VAT totals and VAT basis consistency checks with actual/expected diagnostics

Current limitations

−Full EN16931 Schematron rules validated by official-facturx-adapter (separate layer)
−PDF/A-3 extraction and conformance checking not implemented (Phase 2)
−XRechnung CII profile is planned but not implemented
−UBL and Peppol are separate XML formats, not aliases of CII

Document structure

23 fields · 21 rules · 3 tables

▸

invoice[1..1]//*[local-name()='CrossIndustryInvoice']

◦invoice.profileIdFactur-X Profile ID

IDrequired

◦invoice.idInvoice Number

IDrequired

◦invoice.typeCodeDocument Type Code

CODErequired

◦invoice.issueDateIssue Date

ISO_DATE_BASICrequired

◦invoice.currencyCodeInvoice Currency Code

CURRENCY_CODE

▸

seller[1..1]//*[local-name()='SellerTradeParty']

◦seller.nameSeller Name

TEXT

▸

buyer[1..1]//*[local-name()='BuyerTradeParty']

◦buyer.nameBuyer Name

TEXT

▸

totals[1..1]//*[local-name()='SpecifiedTradeSettlementHeaderMonetarySummation']

◦totals.lineTotalSum of Line Net Amounts

AMOUNT

◦totals.taxBasisAmountTax Basis Total Amount (excl. VAT)

AMOUNT

◦totals.taxAmountTax Total Amount

AMOUNT

◦totals.grandTotalAmountGrand Total Amount (incl. VAT)

AMOUNT

◦totals.duePayableAmountDue Payable Amount

AMOUNT

▸

line[0..unbounded]//*[local-name()='IncludedSupplyChainTradeLineItem']

◦line.idLine ID

◦line.productNameProduct Name

TEXT

◦line.billedQtyBilled Quantity

QUANTITY

◦line.unitPriceNet Unit Price

AMOUNT

◦line.lineTotalLine Total Amount

AMOUNT

▸

vat[0..unbounded]//*[local-name()='ApplicableHeaderTradeSettlement']/*[local-name()='ApplicableTradeTax']

◦vat.categoryCodeVAT Category Code

CODE

◦vat.ratePercentVAT Rate (%)

PERCENT

◦vat.basisAmountVAT Basis Amount

AMOUNT

◦vat.calculatedAmountVAT Calculated Amount

AMOUNT

▸

payment[0..unbounded]//*[local-name()='SpecifiedTradePaymentTerms']

◦payment.dueDatePayment Due Date

ISO_DATE_BASIC

▸

delivery[0..1]//*[local-name()='ApplicableHeaderTradeDelivery']

◦delivery.dateDelivery Date

ISO_DATE_BASIC

Fields

23 defined

Identifier	Label	Type	Required
`invoice.profileId`	Factur-X Profile ID	ID	✓
`invoice.id`	Invoice Number	ID	✓
`invoice.typeCode`	Document Type Code	CODE	✓
`invoice.issueDate`	Issue Date	ISO_DATE_BASIC	✓
`invoice.currencyCode`	Invoice Currency Code	CURRENCY_CODE	—
`seller.name`	Seller Name	TEXT	—
`buyer.name`	Buyer Name	TEXT	—
`totals.taxBasisAmount`	Tax Basis Total Amount (excl. VAT)	AMOUNT	—
`totals.taxAmount`	Tax Total Amount	AMOUNT	—
`totals.grandTotalAmount`	Grand Total Amount (incl. VAT)	AMOUNT	—
`totals.duePayableAmount`	Due Payable Amount	AMOUNT	—
`totals.lineTotal`	Sum of Line Net Amounts	AMOUNT	—
`line.id`	Line ID	ID	—
`line.productName`	Product Name	TEXT	—
`line.billedQty`	Billed Quantity	QUANTITY	—
`line.unitPrice`	Net Unit Price	AMOUNT	—
`line.lineTotal`	Line Total Amount	AMOUNT	—
`vat.categoryCode`	VAT Category Code	CODE	—
`vat.ratePercent`	VAT Rate (%)	PERCENT	—
`vat.basisAmount`	VAT Basis Amount	AMOUNT	—
`vat.calculatedAmount`	VAT Calculated Amount	AMOUNT	—
`payment.dueDate`	Payment Due Date	ISO_DATE_BASIC	—
`delivery.date`	Delivery Date	ISO_DATE_BASIC	—

Validation rules

21 rules

FX-PROF-001ERROR

A CII invoice must specify a GuidelineSpecifiedDocumentContextParameter/ID (Factur-X profile identifier).

Assertion

Factur-X Profile ID is required

FX-PROF-002ERROR

The Factur-X profile ID must be one of the recognised profile URNs (MINIMUM, BASIC-WL, BASIC, EN16931, EXTENDED).

Assertion

Factur-X Profile ID ∈ Recognised Factur-X / ZUGFeRD profile URNs: {urn:factur-x.eu:1p0:minimum, urn:factur-x.eu:1p0:basicwl, urn:factur-x.eu:1p0:basic, urn:cen.eu:en16931:2017, urn:factur-x.eu:1p0:extended, urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.3 ... (16 values)}

FX-HDR-001ERROR

An invoice shall have an invoice number (ExchangedDocument/ID). (EN16931 BR-02)

Assertion

Invoice Number is required

FX-HDR-002ERROR

An invoice shall have an issue date (ExchangedDocument/IssueDateTime). (EN16931 BR-03)

Assertion

Issue Date is required

FX-HDR-003ERROR

An invoice shall specify a document type code (ExchangedDocument/TypeCode). (EN16931 BR-04)

Assertion

Document Type Code is required

FX-HDR-004ERROR

The invoice document type code must be one of the recognised UNTDID 1001 codes for Factur-X invoices.

When

Document Type Code is present

Assertion

Document Type Code ∈ UNTDID 1001 document type codes allowed for Factur-X: {380, 381, 383, 384, 386, 389 ... (12 values)}

FX-SEL-001ERROR

An invoice shall contain the seller name (SellerTradeParty/Name). (EN16931 BR-06)

Assertion

Seller Name is required

FX-BUY-001ERROR

An invoice shall contain the buyer name (BuyerTradeParty/Name). (EN16931 BR-07)

Assertion

Buyer Name is required

FX-TOT-001ERROR

The header line total amount must equal the sum of all invoice line total amounts, with a tolerance of 0.01.

When

Sum of Line Net Amounts is present and Line Total Amount is present

Assertion

Sum of Line Net Amounts = Σ line.lineTotal over line.lineTotal (±0.01)

FX-TOT-002ERROR

The grand total amount must equal the tax basis total amount plus the tax total amount, with a tolerance of 0.01.

When

Grand Total Amount (incl. VAT) is present and Tax Basis Total Amount (excl. VAT) is present and Tax Total Amount is present

Assertion

Grand Total Amount (incl. VAT) = Tax Basis Total Amount (excl. VAT) + Tax Total Amount (±0.01)

FX-LIN-001ERROR

Each invoice line must have a line identifier (AssociatedDocumentLineDocument/LineID).

Assertion

Line ID is required

FX-LIN-003ERROR

Each invoice line must state the billed quantity.

Assertion

Billed Quantity is required

FX-LIN-004ERROR

Each invoice line must state the net unit price.

Assertion

Net Unit Price is required

FX-VAT-001ERROR

Each VAT breakdown category code must be one of the recognised EN16931 VAT category codes.

When

VAT Category Code is present

Assertion

VAT Category Code ∈ EN16931 VAT category codes: {S, Z, E, AE, K, G ... (9 values)}

FX-VAT-003ERROR

The tax total amount must equal the sum of VAT breakdown calculated amounts, with a tolerance of 0.01.

When

Tax Total Amount is present and VAT Calculated Amount is present

Assertion

Tax Total Amount = Σ vat.calculatedAmount over vat.calculatedAmount (±0.01)

FX-VAT-004ERROR

The tax basis total amount must equal the sum of VAT breakdown basis amounts, with a tolerance of 0.01.

When

Tax Basis Total Amount (excl. VAT) is present and VAT Basis Amount is present

Assertion

Tax Basis Total Amount (excl. VAT) = Σ vat.basisAmount over vat.basisAmount (±0.01)

FX-PROFILE-BASIC-001ERRORFactur-X 1.08 BASIC

This validator is for the Factur-X BASIC profile; the invoice profile ID must be urn:factur-x.eu:1p0:basic.

When