> ## Documentation Index > Fetch the complete documentation index at: https://invopop-link-fix.mintlify.site/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 a royalty-free [OASIS](https://www.OASIS-open.org/committees/tc_home.php?wg_abbrev=ubl) 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.
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={null} { "$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={null} { "$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={null} { "$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={null} { "$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={null} { "$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={null} { "$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" } } ```