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

Dispatch Document -Warehouse element

Currently we are building a dispatch document for a third party warehouse. Its clients send an instruction to pick and send items to their customer(s). Each Dispatch instruction will be to pick items from one warehouse. If stock is required from another warehouse a separate dispach will be used. I'm not sure where this should be highligted in the dispatch document. I probably dont want it at the item level.

Any suggestions would be helpful




I am currently creating a dispatch document for a client. My client is a third party warehouse, in other word they store clients products. The Dispatch is to request that items are picked and delivered to the customers client. My question is where do I insert the warehouse for picking. A  dispatch order is for picking from one location ( warehouse). The dispatch may have one or more items to be picked. 

Any suggestions? 


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: 
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