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.

A commentary in three parts on the draft EU directive on e-invoicing

UN/CEFACT 22nd Forum

Sardinia, Italy
14 Oct 2013 - 18 Oct 2013
Event Type: 

Use of GS1 GLN in CustomerParty

Dear all,


How can we indicate in CustomerParty that the IDs are Global Location numbers (EAN code) ?


We can see the CustomerAssignedAccountID, the SupplierAssignedAccountID and AdditionalAccountID but there is no way to indicate which scheme is used for the coding of these IDs.

Now I also looked at the UN/CEFACT and the CEN/BII specs. In the CEN/BII Core Data Model of the basic order these 3 IDs are even not used instead only the PartyIdentification is used.


Read more

AllowanceCharge on InvoiceLine


I have case where an AllowanceCharge is calculated on InvoiceLine level. As I found in the UBL documentation, the LineExtensionAmount must include any discounts or surcharges.

So, in my case, LineExtensionAmount = PriceAmount - AllowanceCharge discount + AllowanceCharge surcharge.

However, when I try to validate the generated XML file on OIOUBL's website, I get an error stating the PriceAmount should be the same as the LineExtensionAmount.

I'm not sure what's wrong here. Here is an extract of the XML-file:


Read more

UBL 2.1 Candidate OASIS Standard 60-day Public Review ends October 15, 2013

OASIS has announced the 60-day public review starting today, August 15, 2013, ending Tuesday, October 15, 2013:


Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility as explained in the instructions located via the button labeled "Send A Comment" at the top of the TC public home page, or directly at:




Platform for B2B e-commerce & supply chain collaboration.

More business, Less waste. 

UBL 2.1 Ratified as a Committee Specification

Today OASIS TC Administration announced the availability of Committee Specification 1 of OASIS Universal Business Language Version 2.1:


The standardization process continues with the preparation of a 60-day public review and then a 14-day membership ballot to promote the Committee Specification to be an OASIS Standard as was accomplished for UBL 2.0.

CANCELLED - UBL hands-on training class in Europe (with XSLT and XSL-FO offered as well)

Utrecht, Netherlands
17 Oct 2013
Event Type: 
Training Class

UBL Technical Committee Members begin internal ballot for Committee Specification

On June 22, 2013 the UBL Technical Committee begins the week-long vote for Committee Specification Draft 5 of Universal Business Language Version 2.1 dated 19 June 2013 [1] with Non-Material Changes [2] to be a Committee Specification.

UNECE Workshop on Intelligent Transport Systems

Brussels, Belgium
15 May 2013
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