Release 2025-07

Introduction

As of 28th July 2025 the endorsed ONE Record version is:

• Ontology 3.2.0
• API 2.2.0
• Data Orchestration 1.1.0

Following IATA governance, this ONE Record release has been endorsed by COTB and by the CSC.

General comments

This release of ONE Record standards is the outcome of all the work carried out in 2024 by the various working groups involved in the maintenance and improvement of the standard. It includes the API & Security working group, the Data Model working group, the Data Orchestration Working group and all the ad-hoc sub-groups. Feedbacks from ONE Record hackathons have been a very valuable source of improvements as well as the different pilots and live implementations of ONE Record.

We believe this release, as the previous one, is production-ready and is an essential milestone for the success of ONE Record to make it the only effective data exchange and data sharing standard as of 1st January 2026.

The working groups mentioned above are still actively operating and all feedbacks and inputs will be highly appreciated to help us improve further the standard.

Ontology 3.2.0

Scope of the release

Feedbacks were shared from the industry after multiple pilots were run under 3.0.0 and 3.1.0. Ontology 3.2.0 brings some improvements in order to faciliate mapping with CXML messages while preserving the piece-centricity and allowing for an "hybrid" usage of both piece-level management and shipment-level management.

Change

Below is an overview of changes on 3.2.0:

• Addition of cityName to Address object
• Addition of accountNumber to Party object with a dedicated open code list for acccount numbers to be mapped with XFWB requirements
• Addition of a HandlingService object, subtype of LogisticsService
• Addition of involvedParty to LogisticsEvent object to record additional parties such as receiving party, notify party
• Addition of ociLineNumber to CustomsInformation object to ensure the OCI line structure remains the same as in messages (required for Customs part)
• Addition of data properties and data objects to Booking and BookingShipment objects to simplify the linkage of data when Distribution is out of scope
• Addition of BookingSegment to suport Split bookings scenarios
• Addition of a few data properties to DgDeclaration object to complete the mapping with DG requirements
• Some data properties added back to WaybillLineItem, addition of a LineItemPackage to WaybillLineItem

Detailed changelog can be read directly in the following Pull Requests on GitHub or in the Detailed Changelog page.

API 2.2.0

Scope of the release

The API 2.2.0 release enhances efficiency by introducing HEAD methods and enabling asynchronous subscriptions through two new types of notifications. It also addresses several industry-identified bugs.

ONE Record API Specification

Added

• Support for HTTP HEAD methods on logistics objects, action requests and list of logistics events
• Add hasLogisticsEvent in notification
• Add two new type of notifications: LOGISTICS_OBJECT_AVAILABLE and LOGISTICS_OBJECT_ACCESS_GRANTED

Changed

• State diagram for Subscription and Access delegation requests. Now a REQUEST_ACCEPTED can move to REQUEST_REVOKED but only in case of subscription and access delegation requests.
• Reviewed all examples according to the API ontology

ONE Record API Ontology

Added

• Add hasLogisticsEvent in notification
• Add LOGISTICS_OBJECT_AVAILABLE and LOGISTICS_OBJECT_ACCESS_GRANTED as notification types

More information can be found in the API Changelog page or directly on the change page.

Data Orchestration 1.1.0

Scope of the release

The Data Orchestration is a work that was intitiated in September 2023. Industry stakeholders (Airline, Freight Forwarders, IT Service Providers, Cargo iQ) have worked to propose a way to use the ONE Record standard to support the operations and business processes.

With 1.1.0 version the focus has been on updating the XFWB/XFZB mapping based on changes introduced by Ontology 3.2.0.
A dedicated page for XFWB mapping has been added with complete XFWB examples.

Release 2024-12

Ontology 3.1.0

For this release, all changes have been tracked using GitHub project view: https://github.com/users/IATA-Cargo/projects/2. All issues are linked to a pull request to properly follow all changes.

Detailed changelog

Below is the detailed changelog:

• Added custom annotations for WIP visualisation: Inverse and Element (#236)
• Added TemperatureInstructions to Piece ( #Add temperatureInstructons at Piece level #227)
• Removed Shipment#specialHandlingcodes (Remove Shipment#specialHandlingcodes #228)
• Renamed label of WaybillLineItem properly (Rename label of WaybillLineItem properly #234)
• Changed partyDetails to LogisticsAgent (Change partyDetails type #222)
• Fixed regex pattern of waybillNumber (waybillNumber xsd:pattern "[-9]+" incorrect, could be "[-0-9]+" #213)
• Removed line breaks in rdfs:comment annotations
• Reassignment of Agents, LoadingUnit for visualization
• Updated Code List Element documentation
• Fixes to Code List md and examples
• Added temperatureInstructions to Piece ( #Add temperatureInstructons at Piece level #227)
• Added new property textualPostalCode to Address (Change Address#postalCode type #221)
• Added new property operatingParties to TransportMovement (#229)
• Added new class AccountingNote (Review of Waybill#accountingInformation #231)
• Added new property accountingNoteIdentifier to AccountingNote (Review of Waybill#accountingInformation #231)
• Added new property accountingNoteText to AccountingNote (Review of Waybill#accountingInformation #231)
• Added new property accountingNotes to Waybill (Review of Waybill#accountingInformation #231)
• Added new property locationIndicator to OtherCharge (CXML Mapping XFWB - Add missing fields #247) - max 1, Location
• Added new property reasonDescription to OtherCharge (CXML Mapping XFWB - Add missing fields #247) - max 1, string
• Added new property chargeQuantity to OtherCharge (CXML Mapping XFWB - Add missing fields #247) - max 1, double
• Deprecated postalCode in favor of textualPostalCode (Change Address#postalCode type #221)
• Deprecated accountingInformation in favor of AccountingNote and included properties (Review of Waybill#accountingInformation #231)
• Removed specialHandlingCodes from Shipment (Remove Shipment#specialHandlingcodes #228)
• Changed value of partyDetails from Organization to LogisticsAgent (Change partyDetails type #222)
• Lifted cardinality restriction on regulatedEntityAcceptor in SecurityDeclaration (Set securityDeclaration#regulatedEntityAcceptor as an array #244)
• Added new code-lists ontology (DM: Refactor core code list ontology URIs to adhere to linked data best practices #268)
• Deprecated coreCodeLists ontology (DM: Refactor core code list ontology URIs to adhere to linked data best practices #268)
• Added new code list DensityGroupCodes (CXML Mapping XFWB - Add Code List 2 to ontology #248)
• Added property densityGroupCode to BookingShipment (Add Density Group Code data property #230)
• Mirrored DGR and Security Status Codes to the Special Handling Codes namespace for simplification as part of code list review (DM: Refactor core code list ontology URIs to adhere to linked data best practices #268)

Rework to WaybillLineItem (#265) as agreed on in DMWG 17/10 and CXML 12/11.

• Added new property pieceReferences to WaybillLineItem (CXML Mapping XFWB - Multiple dimensions for TransportLogisticsPackage grouping #265)
• Added new property uldReferences to WaybillLineItem (#265)
• Deprecated and removed chargeableWeightForRate from WaybillLineItem (#265)
• Deprecated and removed commodityItemNumberForRate from WaybillLineItem (#265)
• Deprecated and removed dimensionsForRate from WaybillLineItem (#265)
• Deprecated and removed goodsDescriptionForRate from WaybillLineItem (#265)
• Deprecated and removed grossWeightForRate from WaybillLineItem (#265)
• Deprecated and removed hsCodeForRate from WaybillLineItem (#265)
• Deprecated and removed pieceCountForRate from WaybillLineItem (#265)
• Deprecated and removed productionCountryForRate from WaybillLineItem (#265)
• Deprecated and removed slacForRate from WaybillLineItem (#265)
• Deprecated and removed uldTareWeightForRate from WaybillLineItem (#265)
• Deprecated and removed volumetricWeightForRate from WaybillLineItem (#265)
• Removed uldOwnerCode from WaybillLineItem (#265)
• Removed uldSerialNumber from WaybillLineItem (#265)
• Removed uldType from WaybillLineItem (#265)
• Lifted cardinality restriction on ofShipment in Piece (DM: Piece can be part of multiple shipments, change from n:1 to n:n #275)
• Lifted cardinality restriction on issuedForPiece in SecurityDeclaration #280

API 2.1.0

For this release, all changes have been tracked using GitHub project view: API Changes.

Detailed changelog

Below is the detailed changelog:

• Add Revision and Latest Revision in the JSON object response
• hasError and hasErrorDetails ontology and documentation alignment
• Review Logistics Event filter parameter
• Introduction of VerificationRequest

More information can be found in the API Changelog page or directly on the change page.

Release 2023-12

ONE Record standard release 2023-12