How iata-cargo/one-record works
This repository publishes the IATA ONE Record specifications, not a running logistics service. Its principal user workflow is for implementers to consult the shipment data model and ontology, then use the API and security specifications to exchange shipment information; orchestration materials document mappings to other cargo formats. The README identifies working_draft as the latest version, while dated release directories preserve prior specifications. The tree and README support these capability relationships, but no runtime call graph exists to inspect.
Main entry points: ONE-Record-API-OpenAPI.yaml API specification · ontology Shipment data model · README.md API security · Data-Orchestration Format mappings
Components 11
Core standard
- Shipment data model
working_draft/ontology - Data ontology
working_draft/ontology/IATA-1R-DM-Ontology.ttl
API and security
- API specification
working_draft/API/ONE-Record-API-OpenAPI.yaml - API models
working_draft/API/ONE-Record-API-Ontology.ttl - API security
working_draft/API/README.md - API class diagram
working_draft/API/ONE-Record-API-Class-Diagram.md
Interoperability
- Format mappings
working_draft/Data-Orchestration - CXML mapping
working_draft/Data-Orchestration/CXML-Mapping.md
Releases and guidance
- Dated specifications
2026-07-standard - Specification guidance
Documentation_website/docs
Other components
- Cargo implementer
Connections 12
- Cargo implementer → Shipment data model: consults
- Cargo implementer → API specification: implements
- Cargo implementer → API security: applies
- Shipment data model → API specification: defines shared data
- Data ontology → Shipment data model: formalizes
- API models → API specification: describes models
- API security → API specification: secures exchange
- API class diagram → API specification: illustrates
- Cargo implementer → Format mappings: consults mappings
- Format mappings → CXML mapping: includes mapping
- Cargo implementer → Dated specifications: checks release
- Cargo implementer → Specification guidance: consults guidance