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.

US Business Payments Coalition Face-to-face

Minneapolis, MN, USA
12 Sep 2018 - 13 Sep 2018
Event Type: 

UBL Technical Committee face-to-face meeting

Zwolle, NL
1 Oct 2018 - 5 Oct 2018
Event Type: 

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

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