How to Implement ONE Record (5 Steps)

IATA's official Implementation Playbook outlines 5 steps to become ONE Record compliant.

Step 1: Define Your Digital Business Process

  • Map your current data flows
  • Identify what data you share, when, and with whom
  • Define your role: shipper, forwarder, airline, GHA, etc.
  • Determine which Logistics Objects you need

Step 2: Sign the Multilateral Data Agreement (MDA)

  • Legal framework for data sharing
  • FREE to sign with IATA
  • Establishes trust between parties
  • Defines data ownership and usage rights

Step 3: Adopt the ONE Record Data Model

  • Use the standard ontology (JSON-LD)
  • Map your internal data to Logistics Objects
  • Key objects: Shipment, Piece, Booking, Waybill, Events
  • Piece-centric approach: every package has identity

Step 4: Implement ONE Record API

  • Build or integrate REST API endpoints
  • Support GET, POST, PATCH operations
  • Implement Pub/Sub for notifications
  • Security: OAuth 2.0 + Mutual TLS

Step 5: Start a Pilot

  • Begin with limited partners
  • Test data exchange in real scenarios
  • Iterate and expand
  • Report learnings to IATA community

Cost Breakdown:

ItemCost
ONE Record standardFREE
Documentation & ontologyFREE
MDA signingFREE
Technical developmentYour investment
Infrastructure/hostingYour investment

Resources:

OnFlyGo Status: We've completed all 5 steps and are ONE Record compliant. When you use OnFlyGo, you benefit from this modern data standard automatically.

Need more help?