Universal Business Language v2.1

Universal Business Language Version 2.1

For the full list of release notes, please refer to https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html#A-RELEASE-NOTES.

A.6 Upgrading from UBL 2.0 to UBL 2.1

For current UBL implementers, the most important thing to know about UBL 2.1 is that it is completely backward-compatible with UBL 2.0. In other words, any document that validates against a UBL 2.0 schema will validate against the UBL 2.1 version of that schema. The remaining differences relate mainly to the extended functionality that has been added to the 2.0 business processes in the areas of eTendering, sales reporting, utility statements, transport handling, and collaborative planning, forecasting, and replenishment (CPFR®).

Nonetheless, it would be unwise to simply overlay this UBL 2.1 release onto an existing 2.0 installation, and the possible differences among existing 1.0 and 2.0 installations are too large to allow a specific set of instructions to be provided for making the transition.

The brief history of UBL document types in the next section puts the new capabilities into context and may help users of existing UBL 1.0 and 2.0 implementations decide whether to upgrade to 2.1.

New 2.1 users, on the other hand, can simply install 2.1 and rest assured that their software will interoperate with UBL documents generated by existing conformant UBL 2.0 installations. For more on the concept of conformance, see Section 6, “Conformance" and [Customization].

Universal Business Language v2.0

Universal Business Language v2.0

Standard, 12 December 2006

For full list of changes, please refer to https://docs.oasis-open.org/ubl/os-UBL-2.0/UBL-2.0.html#RELNOTES.

B.2. New in UBL 2.0

Though apparently limited in scope, the eight document types provided in UBL 1.0 are applicable to a very large number of real-world use cases and have been widely deployed.

Adoption of UBL 1.0 following ratification as an OASIS standard in November 2004 has resulted in major inputs of new content beyond the eight basic order-to-invoice business documents specified in the original release. In particular, contributions from representatives of government procurement, taxation, and transportation agencies in Europe, Asia, and North America have resulted in greatly expanded pre-order and post-invoice capabilities together with the addition of several transport-related document types. These additions have increased the number of UBL document types from eight in UBL 1.0 to 31 in UBL 2.0.

Original UBL 1.0 order-to-invoice document types (updated for UBL 2.0): Order, OrderResponse, OrderResponseSimple, OrderChange, OrderCancellation, DespatchAdvice, ReceiptAdvice, Invoice

New UBL 2.0 document types for sourcing: CatalogueRequest, Catalogue, CatalogueItemSpecificationUpdate, CataloguePricingUpdate, CatalogueDeletion, RequestForQuotation, Quotation

New UBL 2.0 document types for fulfilment: ForwardingInstructions, PackingList, BillOfLading, Waybill, CertificateOfOrigin, TransportationStatus

New UBL 2.0 document types for billing: CreditNote, DebitNote, SelfBilledInvoice, SelfBilledCreditNote, FreightInvoice, Reminder

New UBL 2.0 document types for payment: RemittanceAdvice, Statement

New UBL 2.0 supplementary document types: ApplicationResponse, AttachedDocument

The role of the 23 new UBL 2.0 document types is described in Section 4.

B.3. Other Differences between UBL 1.0 and UBL 2.0

B.3.1. Global Scoping

In UBL 1.0, the great majority of element types were globally scoped, the only exceptions being identifiers and codes. In UBL 2.0, all types are globally scoped.

B.3.2. New Approach to Code List Validation

The UBL mechanism for specifying and validating code lists has been completely revamped. A two-phase validaton approach using the power of XSLT [XSLT](a W3C Recommendation) and Schematron [SCH](ISO/IEC 19757-3) has been developed to make it easier to modify code lists and perform basic business rule checking. For further details, see Appendix E, UBL 2.0 Code Lists and Two-phase Validation.