> ## Documentation Index > Fetch the complete documentation index at: https://docs.invopop.com/llms.txt > Use this file to discover all available pages before exploring further. # UN/CEFACT CII > Convert GOBL to the UN/CEFACT CII format.
| | | | --------- | ------------------------------ | | Developer | [Invopop](https://invopop.com) | | Category | Format | **UN/CEFACT CII (Cross Industry Invoice)** is a key document within the family of Supply Chain "Cross-Industry" messages that are exchanged globally between trading partners. UN/CEFACT CII is part of a group of messages in supply chain procedures called the [Cross-Industry family of deliverables](https://unece.org/trade/documents/2008/11/brs-cross-industry-common-requirements) which are all based on the principle of a maximum data set, are integrated into the Supply Chain Reference Data Model, and are fully interoperable with each other. The standard has achieved significant adoption in Europe. UN/CEFACT CII was chosen in 2016 as one of two obligatory standards within the European Union for public procurement, meaning that every public agency within the EU, is obliged to accept this standard for electronic invoicing. The standard is typically implemented in XML format using the Supply Chain Reference Data Model (SCRDM). **Key Features** Supported CII syntaxes: * `EU` · Peppol BIS Billing CII Invoice V3 * `EU` · EN 16931 CII Invoice * `FR` · FacturX CII V1 * `DE` · ZUGFeRD V2 * `DE` · XRechnung V3 * `FR` · Chorus Pro V1
1
Generate a UN/CEFACT CII XML Invoice.
1
Import a UN/CEFACT CII document like an invoice, and convert to GOBL. Sample invoices demonstrating various UN/CEFACT CII implementations across different countries and use cases. Standard ZUGFeRD invoice for business-to-consumer transactions with embedded XML in PDF format. ```json ZUGFeRD B2C Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017", "de-zugferd-v2" ], "$tags": [ "simplified" ], "uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0", "type": "standard", "series": "SAMPLE", "code": "001", "issue_date": "2022-02-01", "currency": "EUR", "supplier": { "name": "Provide One GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "addresses": [ { "num": "16", "street": "Dietmar-Hopp-Allee", "locality": "Walldorf", "code": "69190", "country": "DE" } ], "emails": [ { "addr": "billing@example.com" } ] }, "lines": [ { "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "discounts": [ { "reason": "Special discount", "percent": "10%", "amount": "180.00" } ], "taxes": [ { "cat": "VAT", "rate": "general" } ], "total": "1620.00" } ], "payment": { "advances": [ { "description": "Paid in full", "percent": "100%", "amount": "1927.80" } ], "instructions": { "key": "card" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017", "de-zugferd-v2" ], "$tags": [ "simplified" ], "uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0", "type": "standard", "series": "SAMPLE", "code": "001", "issue_date": "2022-02-01", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Provide One GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "addresses": [ { "num": "16", "street": "Dietmar-Hopp-Allee", "locality": "Walldorf", "code": "69190", "country": "DE" } ], "emails": [ { "addr": "billing@example.com" } ] }, "lines": [ { "i": 1, "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "discounts": [ { "reason": "Special discount", "percent": "10%", "amount": "180.00" } ], "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ], "total": "1620.00" } ], "payment": { "advances": [ { "description": "Paid in full", "percent": "100%", "amount": "1927.80" } ], "instructions": { "key": "card", "ext": { "untdid-payment-means": "48" } } }, "totals": { "sum": "1620.00", "total": "1620.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1620.00", "percent": "19%", "amount": "307.80" } ], "amount": "307.80" } ], "sum": "307.80" }, "tax": "307.80", "total_with_tax": "1927.80", "payable": "1927.80", "advance": "1927.80", "due": "0.00" } } ``` Comprehensive ZUGFeRD invoice demonstrating additional optional fields such as ordering information, payment terms, delivery details, and discounts. ```json ZUGFeRD B2B Invoice with additional fields theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017", "de-zugferd-v2" ], "type": "standard", "series": "SAMPLE", "code": "001", "issue_date": "2024-02-13", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Provide One GmbH", "tax_id": { "country": "DE", "code": "111111125" }, "people": [ { "name": { "given": "John", "surname": "Doe" } } ], "addresses": [ { "num": "16", "street": "Dietmar-Hopp-Allee", "locality": "Walldorf", "code": "69190", "country": "DE" } ], "emails": [ { "addr": "billing@example.com" } ], "telephones": [ { "num": "+49100200300" } ] }, "customer": { "name": "Sample Consumer", "tax_id": { "country": "DE", "code": "282741168" }, "addresses": [ { "num": "25", "street": "Werner-Heisenberg-Allee", "locality": "München", "code": "80939", "country": "DE" } ], "emails": [ { "addr": "email@sample.com" } ] }, "lines": [ { "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ] } ], "discounts": [ { "reason": "Promotion discount", "amount": "10.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ], "ext": { "untdid-allowance": "88" } } ], "charges": [ { "reason": "Freight", "amount": "11.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ] } ], "ordering": { "code": "PO4711", "period": { "start": "2013-03-10", "end": "2013-04-10" }, "contracts": [ { "code": "2013-05" } ], "receiving": [ { "code": "3544" } ], "despatch": [ { "code": "5433" } ] }, "payment": { "payee": { "name": "Ebeneser Scrooge AS", "identities": [ { "label": "CompanyID", "code": "989823401" }, { "label": "0088", "code": "2298740918237" } ] }, "terms": { "due_dates": [ { "date": "2013-07-20", "percent": "100%" } ], "notes": "2 % discount if paid within 2 days\n Penalty percentage 10% from due date" }, "instructions": { "key": "credit-transfer", "ref": "0003434323213231", "credit_transfer": [ { "iban": "NO9386011117947", "bic": "DNBANOKK" } ], "card": { "last4": "1234", "holder": "John Doe" }, "direct_debit": { "ref": "1234567890", "creditor": "987654321", "account": "DE89370400440532013000" }, "ext": { "untdid-payment-means": "30" } } }, "delivery": { "receiver": { "addresses": [ { "street": "Deliverystreet 2", "street_extra": "Side door", "locality": "DeliveryCity", "region": "RegionD", "code": "523427", "country": "NO" } ] }, "identities": [ { "label": "0088", "code": "6754238987643" } ], "date": "2024-02-10" } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "DE", "$addons": [ "eu-en16931-v2017", "de-zugferd-v2" ], "type": "standard", "series": "SAMPLE", "code": "001", "issue_date": "2024-02-13", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Provide One GmbH", "tax_id": { "country": "DE", "code": "111111125" }, "people": [ { "name": { "given": "John", "surname": "Doe" } } ], "addresses": [ { "num": "16", "street": "Dietmar-Hopp-Allee", "locality": "Walldorf", "code": "69190", "country": "DE" } ], "emails": [ { "addr": "billing@example.com" } ], "telephones": [ { "num": "+49100200300" } ] }, "customer": { "name": "Sample Consumer", "tax_id": { "country": "DE", "code": "282741168" }, "addresses": [ { "num": "25", "street": "Werner-Heisenberg-Allee", "locality": "München", "code": "80939", "country": "DE" } ], "emails": [ { "addr": "email@sample.com" } ] }, "lines": [ { "i": 1, "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ], "total": "1800.00" } ], "discounts": [ { "i": 1, "reason": "Promotion discount", "amount": "10.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ], "ext": { "untdid-allowance": "88" } } ], "charges": [ { "i": 1, "reason": "Freight", "amount": "11.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ] } ], "ordering": { "code": "PO4711", "period": { "start": "2013-03-10", "end": "2013-04-10" }, "contracts": [ { "code": "2013-05" } ], "receiving": [ { "code": "3544" } ], "despatch": [ { "code": "5433" } ] }, "payment": { "payee": { "name": "Ebeneser Scrooge AS", "identities": [ { "label": "CompanyID", "code": "989823401" }, { "label": "0088", "code": "2298740918237" } ] }, "terms": { "due_dates": [ { "date": "2013-07-20", "amount": "2143.19", "percent": "100%" } ], "notes": "2 % discount if paid within 2 days\n Penalty percentage 10% from due date" }, "instructions": { "key": "credit-transfer", "ref": "0003434323213231", "credit_transfer": [ { "iban": "NO9386011117947", "bic": "DNBANOKK" } ], "card": { "last4": "1234", "holder": "John Doe" }, "direct_debit": { "ref": "1234567890", "creditor": "987654321", "account": "DE89370400440532013000" }, "ext": { "untdid-payment-means": "30" } } }, "delivery": { "receiver": { "addresses": [ { "street": "Deliverystreet 2", "street_extra": "Side door", "locality": "DeliveryCity", "region": "RegionD", "code": "523427", "country": "NO" } ] }, "identities": [ { "label": "0088", "code": "6754238987643" } ], "date": "2024-02-10" }, "totals": { "sum": "1800.00", "discount": "10.00", "charge": "11.00", "total": "1801.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1801.00", "percent": "19%", "amount": "342.19" } ], "amount": "342.19" } ], "sum": "342.19" }, "tax": "342.19", "total_with_tax": "2143.19", "payable": "2143.19" } } ``` Factur-X invoice for business-to-business transactions. Factur-X is the French implementation of the same standard as ZUGFeRD. ```json FacturX B2B Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "FR", "$addons": [ "eu-en16931-v2017", "fr-facturx-v1" ], "type": "standard", "series": "SAMPLE", "code": "2345", "issue_date": "2025-06-18", "currency": "EUR", "supplier": { "name": "Provide One Inc.", "tax_id": { "country": "FR", "code": "43498927917" }, "identities": [ { "type": "SIRET", "code": "49892791768734" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Sample Consumer", "tax_id": { "country": "FR", "code": "39356000000" }, "identities": [ { "type": "SIRET", "code": "35600000012345" } ], "addresses": [ { "num": "1", "street": "Rue Sundacsakn", "locality": "Saint-Germain-En-Laye", "code": "75050", "country": "FR" } ], "emails": [ { "addr": "email@sample.com" } ] }, "lines": [ { "i": 1, "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "discounts": [ { "reason": "Special discount", "percent": "10%", "amount": "180.00" } ], "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general" } ], "total": "1620.00" } ], "payment": { "advances": [ { "description": "Paid in full", "percent": "100%", "amount": "1944.00" } ], "instructions": { "key": "card", "card": {} } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "FR", "$addons": [ "eu-en16931-v2017", "fr-facturx-v1" ], "type": "standard", "series": "SAMPLE", "code": "2345", "issue_date": "2025-06-18", "currency": "EUR", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Provide One Inc.", "tax_id": { "country": "FR", "code": "43498927917" }, "identities": [ { "type": "SIRET", "code": "49892791768734", "ext": { "iso-scheme-id": "0009" } } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Sample Consumer", "tax_id": { "country": "FR", "code": "39356000000" }, "identities": [ { "type": "SIRET", "code": "35600000012345", "ext": { "iso-scheme-id": "0009" } } ], "addresses": [ { "num": "1", "street": "Rue Sundacsakn", "locality": "Saint-Germain-En-Laye", "code": "75050", "country": "FR" } ], "emails": [ { "addr": "email@sample.com" } ] }, "lines": [ { "i": 1, "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "discounts": [ { "reason": "Special discount", "percent": "10%", "amount": "180.00" } ], "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "20%", "ext": { "untdid-tax-category": "S" } } ], "total": "1620.00" } ], "payment": { "advances": [ { "description": "Paid in full", "percent": "100%", "amount": "1944.00" } ], "instructions": { "key": "card", "card": {}, "ext": { "untdid-payment-means": "48" } } }, "totals": { "sum": "1620.00", "total": "1620.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1620.00", "percent": "20%", "amount": "324.00" } ], "amount": "324.00" } ], "sum": "324.00" }, "tax": "324.00", "total_with_tax": "1944.00", "payable": "1944.00", "advance": "1944.00", "due": "0.00" } } ``` Chorus Pro invoice for business-to-government transactions in France, used for public procurement. ```json Chorus Pro B2G Invoice theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "FR", "$addons": [ "eu-en16931-v2017", "fr-choruspro-v1" ], "uuid": "019783e7-33b1-7000-a1a5-6139e214b447", "type": "standard", "series": "SAMPLE", "code": "2345", "issue_date": "2025-06-18", "currency": "EUR", "supplier": { "name": "Provide One Inc.", "tax_id": { "country": "FR", "code": "43498927917" }, "identities": [ { "type": "SIRET", "code": "49892791768734" } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] }, "customer": { "name": "Sample Consumer", "tax_id": { "country": "FR", "code": "39356000000" }, "identities": [ { "type": "SIRET", "code": "35600000012345" } ], "addresses": [ { "num": "1", "street": "Rue Sundacsakn", "locality": "Saint-Germain-En-Laye", "code": "75050", "country": "FR" } ], "emails": [ { "addr": "email@sample.com" } ] }, "lines": [ { "i": 1, "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "discounts": [ { "reason": "Special discount", "percent": "10%", "amount": "180.00" } ], "taxes": [ { "cat": "VAT", "rate": "standard" } ], "total": "1620.00" } ], "payment": { "advances": [ { "description": "Paid in full", "percent": "100%", "amount": "1944.00" } ], "instructions": { "key": "card" } } } ``` ```json Built version theme={"system"} { "$schema": "https://gobl.org/draft-0/bill/invoice", "$regime": "FR", "$addons": [ "eu-en16931-v2017", "fr-choruspro-v1" ], "uuid": "019783e7-33b1-7000-a1a5-6139e214b447", "type": "standard", "series": "SAMPLE", "code": "2345", "issue_date": "2025-06-18", "currency": "EUR", "tax": { "ext": { "fr-choruspro-framework": "A1", "untdid-document-type": "380" } }, "supplier": { "name": "Provide One Inc.", "tax_id": { "country": "FR", "code": "43498927917" }, "identities": [ { "type": "SIRET", "code": "49892791768734", "ext": { "iso-scheme-id": "0009" } } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ], "ext": { "fr-choruspro-scheme": "1" } }, "customer": { "name": "Sample Consumer", "tax_id": { "country": "FR", "code": "39356000000" }, "identities": [ { "type": "SIRET", "code": "35600000012345", "ext": { "iso-scheme-id": "0009" } } ], "addresses": [ { "num": "1", "street": "Rue Sundacsakn", "locality": "Saint-Germain-En-Laye", "code": "75050", "country": "FR" } ], "emails": [ { "addr": "email@sample.com" } ], "ext": { "fr-choruspro-scheme": "1" } }, "lines": [ { "i": 1, "quantity": "20", "item": { "name": "Development services", "price": "90.00", "unit": "h" }, "sum": "1800.00", "discounts": [ { "reason": "Special discount", "percent": "10%", "amount": "180.00" } ], "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "20%", "ext": { "untdid-tax-category": "S" } } ], "total": "1620.00" } ], "payment": { "advances": [ { "description": "Paid in full", "percent": "100%", "amount": "1944.00" } ], "instructions": { "key": "card", "ext": { "untdid-payment-means": "48" } } }, "totals": { "sum": "1620.00", "total": "1620.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1620.00", "percent": "20%", "amount": "324.00" } ], "amount": "324.00" } ], "sum": "324.00" }, "tax": "324.00", "total_with_tax": "1944.00", "payable": "1944.00", "advance": "1944.00", "due": "0.00" } } ```