OASIS UBL

Convert GOBL to the OASIS UBL format.

Description

OASIS UBL

Developer	Invopop
Category	Format

OASIS UBL (Universal Business Language) is a royalty-free OASIS standard defining XML business documents such as purchase orders, invoices, and waybills. This app converts GOBL documents to and from UBL XML.

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 access: 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, so it is only accessible via the API.

Embedded attachments: the generate action can embed the invoice PDF and any supporting documents uploaded to the silo entry with the attachment category directly in the UBL XML. See embed attachments in UBL and CII documents.

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"
        }
    }
}