Welcome to UBL.XML.org.

This is the official community gathering place and information resource for the OASIS UBL (ISO/IEC 19845) International Standard. UBL defines a royalty-free library of standard electronic XML business documents such as purchase orders and invoices.

This is a community-driven site, and the public is encouraged to contribute content. Find the appropriate area to contribute to by hovering your pointer over the site area titles listed in orange banner above. This will briefly reveal the area description in a small pop-up box. For more detail, please see our policies and descriptions regarding posting content to certain areas.

In order to receive email notifications of posts to this site, please click top-right on your username next to "Logged in as:", or bottom-right "My account", in order to get to your account page. Go to the "Subscriptions" tab and you'll see 5 different sub-areas. The "categories" and "content types" sub-areas have a number of check-boxes. Click on any or all and then save your selection in order to receive an email notification of a new post in that area of this web site.

Obtaining OASIS UBL 2.1 (ISO/IEC 19845:2015)

The Universal Business Language V2.1 OASIS Standard, approved 04 November 2013, is available (at no charge) here:
HTML: http://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html
ZIP: http://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.zip

The ISO/IEC 19845:2015 International Standard, published 15 December 2015, is the 2013 UBL v2.1 verbatim document with an ISO/IEC cover page, and is currently available at:  http://www.iso.org/iso/catalogue_detail.htm?csnumber=66370

Multiple invoices per PDF

Since recently the dutch tax authorities allow multiple suppliers to combine their invoices in in one document.
(see article at https://zoek.officielebekendmakingen.nl/stcrt-2017-59187.pdf)
How would you approach this in UBL? I could create one UBL document per invoice on the aggregate document, but then it's not possible to give them the same filename as the PDF.

Storing Payment Reference in UBL

Dear guys/gals

I am new to UBL and its implementation for invoices.

Would like to clarify if my understanding of the below elements usage is correct or not.

Invoice/ PaymentMeans / PaymentID 

I am working on an ERP system which needs to create/read UBL formatted invoices (purchase and Sales).

and i was wondering where i can put my payment reference information.

Read more



Hello! I work in a big company and we take a lot of E-Invoices from other companies. End of the every month E-Invoıces  (more than 1000) are controlled manually from xml files. It tooks more than 3 days. 

 I need to convert XML files to EXCEL. Is there any way for that?    


Adapting/Extending "Invoice" as "Payment Authorization" for Employees

Has anyone adapted and extended the UBL Invoice to function as a payment authorization for employees?  We use UBL (as well as ISO 20022) to structure data exchange for our pre-payment setup system. At the moment we're experimenting with use of our system for determination of employee salaries under a collective agreement.

If UBL can be used for periodic invoicing of business services under a subscription contract, then it seems adaptable to the periodic payment of worker services under an employment contract.

Read more

CEN/TC434 Public Conference

Brussels, Belgium
23 Oct 2017
Event Type: 


Answer to: where is the list of mandatory elements in UBL?

I was asked today "where is the list of mandatory elements in UBL?".  Perhaps the answer will help others.

There can be no such list of mandatory elements in UBL.  One cannot simply scrape the UBL document models looking for BIEs that have a minimum cardinality of one.  Determining the list of mandatory elements is an iterative process.

Read more

Exchange Summit Americas

Miami Airport Hilton, Florida
8 May 2018 - 9 May 2018
Event Type: 

Adopted: UNCITRAL Model Law on Electronic Transferable Records

The Model Law on Electronic Transferable Records (MLETR) provides the trans-jurisdictional legal context for use of electronic transferable records that are functionally equivalent to transferable documents and instruments, such as bills of lading, bills of exchange, promissory notes and warehouse receipts.

Laws at country and sub-country levels are typically adapted to conform with UNCITRAL "Model Laws".

Read more

InvoiceLine Item Category


 I am researching information on UBL to introduce it in my organisation.

 I noticed that the InvoiceType can contain one-or-many InvoiceLine which are associated with an Item.


Read more

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I