OASIS UBL

Convert GOBL to the OASIS UBL format.

Description

OASIS UBL

Developer	Invopop
Category	Format

OASIS UBL (Universal Business Language) is an open library of standard electronic business documents and information models for supply chain, procurement, and transportation such as purchase orders, invoices, transport logistics and waybills.

UBL is a royalty-free library of standard XML business documents supporting digitization of commercial and logistical processes for domestic and international supply chains. It was originally approved as an OASIS standard in 2004, making it one of the most mature and widely implemented OASIS standards.

UBL is designed to plug directly into existing business, legal, auditing, and records management practices, eliminating the re-keying of data and providing a comprehensive framework for electronic commerce. The standard is owned by OASIS and available to all, with no royalty fees.

Key Features

Output different UBL syntaxes:

• Peppol BIS v3 UBL invoice and credit note
• XRechnung UBL invoice V2.0
• EN 16931 UBL invoice and credit note

File accesss: by default Invopop will generate public URLs with a secure hash that can be shared with customers. If this is not desired, you can configure the action to make the file private and will only be accessible via the API.

Actions

Generate UBL Document

Import UBL Document

Documents

Sample invoices demonstrating various OASIS UBL implementations across different countries and use cases.

XRechnung B2B Invoice (Germany)

Standard XRechnung invoice for business-to-business transactions using the UBL format.

XRechnung B2B Invoice

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "DE",
    "$addons": [
        "eu-en16931-v2017",
        "de-xrechnung-v3"
    ],
    "type": "standard",
    "series": "SAMPLE",
    "code": "001",
    "issue_date": "2022-02-01",
    "currency": "EUR",
    "supplier": {
        "name": "Rheinland Technologies GmbH",
        "tax_id": {
            "country": "DE",
            "code": "879558966"
        },
        "inboxes": [
            {
                "key": "peppol",
                "scheme": "9930",
                "code": "DE879558966"
            }
        ],
        "addresses": [
            {
                "num": "27",
                "street": "Friedrichstraße",
                "locality": "Berlin",
                "region": "BE",
                "code": "10117",
                "country": "DE"
            }
        ],
        "people": [
            {
                "name": {
                    "given": "John",
                    "surname": "Doe"
                }
            }  
        ],
        "telephones": [
            {
                "num": "[phone]"
            }
        ],
        "emails": [
            {
                "addr": "[e-mail]"
            }
        ]
    },
    "customer": {
        "name": "Bavaria Solutions GmbH",
        "tax_id": {
            "country": "DE",
            "code": "993930191"
        },
        "inboxes": [
            {
                "key": "peppol",
                "scheme": "9930",
                "code": "DE993930191"
            }
        ],
        "addresses": [
            {
                "num": "15",
                "street": "Marienplatz",
                "locality": "München",
                "region": "BY",
                "code": "80331",
                "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"
        }
    ],
    "ordering": {
        "code": "N"
    },
    "payment": {
        "terms": {
            "notes": "Will be paid by 2026-06-02"
        },
        "instructions": {
            "key": "credit-transfer+sepa",
            "credit_transfer": [
                {
                    "iban": "DE89370400440532013000",
                    "name": "Random Bank Co."
                }
            ]
        }
    }
}

XRechnung B2G Invoice (Germany)

XRechnung invoice for business-to-government transactions, compliant with German public procurement requirements.

XRechnung B2G Invoice

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "DE",
    "$addons": [
        "eu-en16931-v2017",
        "de-xrechnung-v3"
    ],
    "type": "standard",
    "series": "SAMPLE",
    "code": "001",
    "issue_date": "2022-02-01",
    "currency": "EUR",
    "supplier": {
        "name": "Rheinland Technologies GmbH",
        "tax_id": {
            "country": "DE",
            "code": "879558966"
        },
        "inboxes": [
            {
                "key": "peppol",
                "scheme": "9930",
                "code": "DE879558966"
            }
        ],
        "addresses": [
            {
                "num": "27",
                "street": "Friedrichstraße",
                "locality": "Berlin",
                "region": "BE",
                "code": "10117",
                "country": "DE"
            }
        ],
        "people": [
            {
                "name": {
                    "given": "John",
                    "surname": "Doe"
                }
            }  
        ],
        "telephones": [
            {
                "num": "[phone]"
            }
        ],
        "emails": [
            {
                "addr": "[e-mail]"
            }
        ]
    },
    "customer": {
        "name": "Deutsche Bahn",
        "tax_id": {
            "country": "DE",
            "code": "811569869"
        },
        "inboxes": [
            {
                "key": "peppol",
                "scheme": "9930",
                "code": "DE811569869"
            }
        ],
        "addresses": [
            {
                "num": "15",
                "street": "Marienplatz",
                "locality": "München",
                "region": "BY",
                "code": "80331",
                "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"
        }
    ],
    "ordering": {
        "code": "992-90009-96"
    },
    "payment": {
        "terms": {
            "notes": "Will be paid by 2026-06-02"
        },
        "instructions": {
            "key": "credit-transfer+sepa",
            "credit_transfer": [
                {
                    "iban": "DE89370400440532013000",
                    "name": "Random Bank Co."
                }
            ]
        }
    }
}

Peppol BIS Standard Invoice

Standard Peppol BIS Billing 3.0 invoice demonstrating the pan-European e-invoicing framework.

Germany standard B2B invoice

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "DE",
    "$addons": [
        "eu-en16931-v2017"
    ],
    "type": "standard",
    "series": "INV",
    "code": "PP000003",
    "issue_date": "2025-04-03",
    "currency": "EUR",
    "supplier": {
        "name": "Rheinland Technologies GmbH",
        "tax_id": {
            "country": "DE",
            "code": "879558966"
        },
        "inboxes": [
            {
                "key": "peppol",
                "scheme": "9930",
                "code": "DE879558966"
            }
        ],
        "addresses": [
            {
                "num": "27",
                "street": "Friedrichstraße",
                "locality": "Berlin",
                "region": "BE",
                "code": "10117",
                "country": "DE"
            }
        ],
        "emails": [
            {
                "addr": "[e-mail]"
            }
        ]
    },
    "customer": {
        "name": "Bavaria Solutions GmbH",
        "tax_id": {
            "country": "DE",
            "code": "993930191"
        },
        "inboxes": [
            {
                "key": "peppol",
                "scheme": "9930",
                "code": "DE993930191"
            }
        ],
        "addresses": [
            {
                "num": "15",
                "street": "Marienplatz",
                "locality": "München",
                "region": "BY",
                "code": "80331",
                "country": "DE"
            }
        ],
        "emails": [
            {
                "addr": "[e-mail]"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "12",
            "item": {
                "name": "Sambox services",
                "price": "145.00",
                "unit": "one"
            },
            "sum": "1740.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "general"
                }
            ],
            "total": "1740.00"
        }
    ],
    "payment": {
        "terms": {
            "detail": "Will be paid by 2026-06-02"
        }
    }
}