> ## 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. # OASIS UBL > Convert GOBL to the OASIS UBL format.
| | | | --------- | ------------------------------ | | Developer | [Invopop](https://invopop.com) | | 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](https://www.OASIS-open.org/committees/tc_home.php?wg_abbrev=ubl) 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.
1
Generate a new UBL document from the GOBL source.
1
Convert an incoming UBL XML into a GOBL document. Sample invoices demonstrating various OASIS UBL implementations across different countries and use cases. Standard XRechnung invoice for business-to-business transactions using the UBL format. ```json XRechnung B2B Invoice theme={"system"} { "$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": "+49100200300" } ], "emails": [ { "addr": "billing@example.com" } ] }, "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": "test@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" } ], "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." } ] } } } ``` ```json Built version theme={"system"} { "$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", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "people": [ { "name": { "given": "John", "surname": "Doe" } } ], "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "billing@example.com" } ], "telephones": [ { "num": "+49100200300" } ] }, "customer": { "name": "Bavaria Solutions GmbH", "tax_id": { "country": "DE", "code": "993930191" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE993930191" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE993930191" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@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" } ], "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." } ], "ext": { "untdid-payment-means": "58" } } }, "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" } } ``` XRechnung invoice for business-to-government transactions, compliant with German public procurement requirements. ```json XRechnung B2G Invoice theme={"system"} { "$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": "+49100200300" } ], "emails": [ { "addr": "billing@example.com" } ] }, "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": "test@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" } ], "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." } ] } } } ``` ```json Built version theme={"system"} { "$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", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "people": [ { "name": { "given": "John", "surname": "Doe" } } ], "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "billing@example.com" } ], "telephones": [ { "num": "+49100200300" } ] }, "customer": { "name": "Deutsche Bahn", "tax_id": { "country": "DE", "code": "811569869" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE811569869" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE811569869" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@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" } ], "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." } ], "ext": { "untdid-payment-means": "58" } } }, "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" } } ``` Standard Peppol BIS Billing 3.0 invoice demonstrating the pan-European e-invoicing framework. ```json Germany standard B2B invoice theme={"system"} { "$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": "rechnungen@rheinlandtech.de" } ] }, "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": "test@example.com" } ] }, "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" } } } ``` ```json Built version theme={"system"} { "$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", "tax": { "ext": { "untdid-document-type": "380" } }, "supplier": { "name": "Rheinland Technologies GmbH", "tax_id": { "country": "DE", "code": "879558966" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE879558966" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE879558966" } ], "addresses": [ { "num": "27", "street": "Friedrichstraße", "locality": "Berlin", "region": "BE", "code": "10117", "country": "DE" } ], "emails": [ { "addr": "rechnungen@rheinlandtech.de" } ] }, "customer": { "name": "Bavaria Solutions GmbH", "tax_id": { "country": "DE", "code": "993930191" }, "endpoints": [ { "uri": "iso6523-actorid-upis::9930:DE993930191" } ], "inboxes": [ { "key": "peppol", "scheme": "9930", "code": "DE993930191" } ], "addresses": [ { "num": "15", "street": "Marienplatz", "locality": "München", "region": "BY", "code": "80331", "country": "DE" } ], "emails": [ { "addr": "test@example.com" } ] }, "lines": [ { "i": 1, "quantity": "12", "item": { "name": "Sambox services", "price": "145.00", "unit": "one" }, "sum": "1740.00", "taxes": [ { "cat": "VAT", "key": "standard", "rate": "general", "percent": "19%", "ext": { "untdid-tax-category": "S" } } ], "total": "1740.00" } ], "payment": { "terms": { "notes": "Will be paid by 2026-06-02" } }, "totals": { "sum": "1740.00", "total": "1740.00", "taxes": { "categories": [ { "code": "VAT", "rates": [ { "key": "standard", "ext": { "untdid-tax-category": "S" }, "base": "1740.00", "percent": "19%", "amount": "330.60" } ], "amount": "330.60" } ], "sum": "330.60" }, "tax": "330.60", "total_with_tax": "2070.60", "payable": "2070.60" } } ```