This page preserves the UBL 2.0 Support Page as it existed 3 July 2008. The function of the Support Page is now performed by the UBL Online Community at Please check there for current UBL resources, news, and events.

Supporting materials for UBL 2.0 implementers

This page contains links to various materials produced by the OASIS UBL TC and others in support of UBL deployment and software development. Sections containing items produced by the UBL TC take the place of the Support Package referred to in the UBL 2.0 Standard.

[Obsolete] To propose links to be added to the Support Page, send a URL and a brief description to UBL Secretary Zarella Rendon ( DO NOT send proposals to the UBL chairs or ubl-ssc maintainers.

[Obsolete] Submissions received by COB every Friday will typically be considered for addition to the ubl-ssc page by the UBL TC in its meetings the following week. Descriptions may be edited by the TC for brevity, and submitters agree to accept any changes so made. Inclusion of materials on the ubl-ssc page is at the sole discretion of the UBL TC.

IMPORTANT: See notices at the bottom of this page.

UBL-related events (including conferences and workshops)

UBL Event Calendar

Regularly updated listing of UBL-related events.

UBL 2.0 supporting materials produced by the OASIS UBL TC

UBL 2.0 EF (GEFEG) Data Model

For use with FX (formerly EDIFIX) version 60. This is the data model from which the UBL 2.0 schemas were generated. The UBL TC thanks GEFEG for its contribution of EDIFIX and technical expertise in the generation and quality review of UBL schemas.

UBL 2.0 EA (Sparx) Data Model

For use with Sparx Enterprise Architect 6.5. This is the data model from which the UML diagrams included in the UBL 2.0 release were generated. The UBL TC thanks Sparx Systems for its contribution of Enterprise Architect licenses for use in developing UML content models.

XPath files

These files enumerate all element and attribute information items described by the UBL 2.0 schemas.

Customization spreadsheets

A suite of spreadsheets modified from cs-UBL-2.0 spreadsheets illustrating a method of expressing the catalogue of members of UBL 2.0 that are present and absent from a particular customization of UBL 2.0.

Related specifications produced by the OASIS UBL TC

UBL 2.0 XML Naming and Design Rules

Public review draft.

UBL Methodology for Code List and Value Validation

Specification of the methodology underlying the two-phase validation technique described in Appendix E of the UBL 2.0 Standard. Also available is a fabricated case study (based on a real requirement for the OASIS Customer Information Quality Technical Committee) of adaptations a company or a standards committee might want to perform in order to convert a validation strategy based solely on XSD into the two-phase Methodology for Code List and Value Validation referred to above. The case study goes step-by-step through the creation of various artefacts that an organization would need to publish for a default set of code lists, while allowing their community of users to adapt these code lists to specific business requirements between trading partners.

UBL 2.0 Code List Support Package

The UBL 2 Code List Support Package contains the information used to create the defaultCodeList.xsl second-phase value validation stylesheet supplied in the UBL 2.0 val directory. As the UBL Methodology for Code List and Value Validation (see above) matures and new releases of the reference implementation of ISO Schematron are released, this support package will be revised with an updated defaultCodeList.xsl that is functionally equivalent to the one in the UBL 2.0 release, but with different reporting features and implementation.

UBL 2.0 supporting materials produced by related initiatives

UBL Northern European Subset

The Northern European Subset (NES) defines the specific use of UBL 2.0 electronic procurement documents domestically and between the member countries: Denmark, Sweden, Norway, Finland, Iceland, and the UK. NES documentation includes profiles describing business processes and scenarios, profiled UBL documents, and guidelines on the specific usage of UBL entities, as well as schema and schematron validation tools.

OIOUBL Implementation Guidelines

OIOUBL is a UBL customization for specific Danish business requirements developed in coordination with other Nordic countries and the UK under a collaboration called the "Northern European Subset" (NES). The 15 business documents included in OIOUBL constitute a subset of UBL 2.0 covering the supply chain business processes from sourcing to billing. The support package referenced here comprises a series of guidelines for implementors of OIOUBL. These include comprehensive explanations of business rules as well as examples of the use of the associated business documents. In addition, a series of guidelines describe the use of certain classes common to different types of business documents. This package can be used as a template for producing other implementation guidelines.

Model trading partner agreements

NOTE: Materials in this section are intended as templates for contract lawyers. They are not suitable for use without modification, are not intended as legal advice, and should not be used without qualified legal assistance.

UN/ECE Recommendation No. 31: Electronic Commerce Agreement

The Electronic Commerce Agreement is intended to serve the commercial requirements of business-to-business electronic commerce partners. It contains a basic set of provisions which can ensure that one or more electronic commercial transactions may subsequently be concluded by commercial partners within a sound legal framework.

Model UBL Letter Agreement and Commentary

The Model UBL Letter Agreement provides a template for contracts between trading partners who wish to treat particular UBL electronic documents as equivalent to their paper counterparts. The Model does not itself constitute a contract and should not be used without legal review, but together with the Commentary it provides a starting point for lawyers and a checklist for discussion with their clients. The UBL TC thanks the Cyberspace Law Committee of the American Bar Association for its help in creating this document and Professor Jane Winn of the University of Washington for her assistance in organizing the project.

UBL 2.0 resources from third parties

[2007.02.01] Crane Softwrights Ltd. UBL, XPath, and code list resources

Crane Softwrights Ltd. periodically publishes new and revised free developer resources related to the Universal Business Language specifications and the genericode code list specifications. A partial list includes:

UBL 2.0 model summary reports in HTML
UBL International Data Dictionary contents in genericode files
United Nations Layout Key stylesheet UBL instance rendering
codex stylesheet UBL instance rendering
genericode and context/value association file rendering
UBL 2 instance pruning filters in XSLT and Python
UBL 2 XPath summary files in text and XML
simplified UBL schema customization tools

[2007.02.01, 2007.03.20] UBL Swinger 1.1 - Community Edition

UBL Swinger is a generic UBL instance editor that can create a UBL document instance within minutes. UBL Swinger is also a good reader thanks to its dynamic loading, designed for use with large documents. A special hierarchical view allows the user focus on a precise branch of even a complex UBL document. The editor can support any collection of UBL Schemas (WXS based) by adding a new XML Catalog to its Workspace. For a full editing experience, a pre-configured UBL 2.0 catalog is bundled to correctly render code lists as comboboxes and provide context-based help. UBL Swinger is also IDD ready, which will allow an immediate view of the same instance in all supported languages.

[2007.10.01] Ubler

Tool for generating W3C schemes and Java code from the data model spreadsheets based on UBL 2.0. (Generador de esquemas y código Java a partir de modelos de datos estructurados en hojas de cálculo que cumplan la especificación UBL-2.0 y sus Reglas de Denominación y Diseño).

[2007.02.01] UBL International conferences

A combination conference and training event focused on UBL. The link leads to proceedings of previous conferences, a schedule of all upcoming conferences, and information on hosting a candidate future conference.

[2007.02.08] Practical Universal Business Language Deployment (book)

Practical Universal Business Language Deployment overviews the artefacts published in the Universal Business Language 2.0 specification, with details on schemes for deploying and utilizing the artefacts to effect stated objectives. This book is an electronic publication offering perpetual no-charge updates as the content evolves based on deployment and community experiences.

[2007.02.08] Practical Universal Business Language Deployment (instructor-led hands-on training)

This is a one-, two-, or three-day configuration of instructor-led hands-on training in the deployment and use of the Universal Business Language 2.0 artefacts. It is derived from the book of the same title and includes exercises that are not part of the publication.

[2007.02.08] Contivo Builder

Contivo Builder is a schema vocabulary development tool that simplifies understanding and leveraging XML Schema vocabularies. The vocabulary approach enables developers to access the entire collection of schemas in UBL 2.0, readily reuse the component definitions in new schemas, and capture the relationships between UBL and other schemas. Based on the Eclipse IDE, Builder is available at no charge. A vocabulary encompassing the entire UBL 2.0 schema set is available for free download.

[2007.03.01] Unimaze ebComposer UBL

ebComposer UBL is a software library for creating and parsing UBL 2.0 documents. It is for development in the Microsoft .NET Framework 2.0 and COM/OLE containers (such as Dynamics NAV/Navision and VB6). ebComposer UBL reads and writes fully schema compliant UBL 2.0 documents and fully supports all UBL 2.0 document types. Documentation of all class hierarchies is provided with Intellisense(R) support. The download includes 30 days free trial and support.

[2007.04.26] Introductory UBL course in Italian

This Italian-language course, sponsored by ENEA (the Italian National Agency for New Technologies, Energy and the Environment) and funded by the government of the Emilia-Romagna region, is free and lasts about an hour. It can be arranged on demand by Universities and other institutions. Contents: Introduction to UBL (what UBL is, its objective, its approach and its reference sources); Practical use of UBL (structure of the messages and of the component libraries, reference business collaborations and business documents supported by UBL 2.0); UBL contextualization (why and how). The slides used during the course are available online.

[2007.05.24] SystML XForms for UBL

SystML provides a range of forms for simple online and offline creation of UBL electronic business documents in English, Spanish, and Italian. These forms use W3C XForms CSS 3 technologies and therefore require a suitably enabled browser such as Firefox with the XForms extension ( The documents available can be found via the SystML 'Business Web' page ( and are part of an opensource project, "XForms For UBL," hosted on sourceForge with a GPL 2 license (

[2007.07.31] Crane Softwrights Ltd. UBL International Data Dictionary in genericode format

This resource is a conversion of UBL 2.0 International Data Dictionary (IDD) spreadsheet files of various languages into OASIS genericode files. Each spreadsheet of each language's localization is converted to a genericode file. In addition, all of the languages are aggregated into a single genericode file for the localization information of each UBL 2.0 document model. User interfaces for programs and other multilingual applications may find it helpful to have some or all of the UBL IDD localization information in a generic keyed-table XML vocabulary. [Note: The UBL 2.0 International Data Dictionary is still in draft form and currently only supports two languages, Italian and Spanish. See next section for a link to the UBL 1.0 International Data Dictionary.]

[2007.07.31] Understanding the Universal Business Language (instructor-led workshop)

A one-day tutorial style workshop to gain an understanding of the UBL business library and its document models.

[2007.07.31] Designing Business Documents with UBL (instructor-led workshop)

A one-day tutorial style workshop presenting an approach to the design and customization of UBL to satisfy specific requirements.

UBL-related contributions from academia

A Semantic based Solution for the Interoperability of UBL Schemas

Authors: Yalin Yarimagan and Asuman Dogac, Middle East Technical University. Associated file: An OWL ontology generated for UBL 2.0.

Survey of UBL interest and deployment

This online survey of UBL interest and deployment was created by the University of Frankfurt in the context of the European ABILITIES project and is designed to measure real-world use of the UBL Standard. The site provides both an opportunity to participate in the survey and public access to the survey results.

UBL 1.0 legacy support materials

Links to the UBL 1.0 Naming and Design Rules, International Data Dictionary, Small Business Subset, and UBL Formatters can be found on the UBL 1.0 Legacy Support page:


Materials linked from this site that were produced by the OASIS UBL TC are provided on an "AS IS" basis. Links to materials developed by others are for informational purposes only, and descriptions of the same are the responsibility of the contributors. For interpretation or assistance in the deployment of these materials, contact the contributors via the links provided. OASIS and the OASIS UBL TC make no representations as to the accuracy of these descriptions or the adequacy of the materials linked from this page. OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN OR PRODUCTS LINKED HEREFROM WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.