UN/CEFACT CII

Convert GOBL to the UN/CEFACT CII format.

Description

UN/CEFACT CII

Developer	Invopop
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 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

Actions

Generate UN/CEFACT CII Invoice

Import UN/CEFACT CII Document

Documents

Sample invoices demonstrating various UN/CEFACT CII implementations across different countries and use cases.

ZUGFeRD B2C Invoice (Germany)

Standard ZUGFeRD invoice for business-to-consumer transactions with embedded XML in PDF format.

ZUGFeRD B2C Invoice

{
    "$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"
        },
        "addresses": [
            {
                "num": "16",
                "street": "Dietmar-Hopp-Allee",
                "locality": "Walldorf",
                "code": "69190",
                "country": "DE"
            }
        ],
        "emails": [
            {
                "addr": "[e-mail]"
            }
        ]
    },
    "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"
        }
    }
}

ZUGFeRD B2B Invoice with Additional Fields (Germany)

Comprehensive ZUGFeRD invoice demonstrating additional optional fields such as ordering information, payment terms, delivery details, and discounts.

ZUGFeRD B2B Invoice with additional fields

{
    "$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": "[e-mail]"
            }
        ],
        "telephones": [
            {
                "num": "[phone]"
            }
        ]
    },
    "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": "[e-mail]"
            }
        ]
    },
    "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"
    }
}

Factur-X B2B Invoice (France)

Factur-X invoice for business-to-business transactions. Factur-X is the French implementation of the same standard as ZUGFeRD.

FacturX B2B Invoice

{
    "$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": "[e-mail]"
            }
        ]
    },
    "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": "[e-mail]"
            }
        ]
    },
    "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": {}
        }
    }
}

Chorus Pro B2G Invoice (France)

Chorus Pro invoice for business-to-government transactions in France, used for public procurement.

Chorus Pro B2G Invoice

{
    "$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": "[e-mail]"
            }
        ]
    },
    "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": "[e-mail]"
            }
        ]
    },
    "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"
        }
    }
}