Ingka Group acquires Locus! Built for the real world, backed for the long run. Read here>Read the full story>
Ingka Group acquires Locus! Built for the real world, backed for the long run. Read the full story
locus-logo-dark
Schedule a demo
Locus Logo Locus Logo
  • Platform
    • Transportation Management System
    • Last Mile Delivery Solution
  • Products
    • Fulfillment Automation
      • Order Management
      • Delivery Promise Management
    • Dispatch Planning
      • Hub Operations
      • Capacity Management
      • Route Planning
    • Delivery Orchestration
      • Transporter Management
      • ShipFlex
    • Track and Trace
      • Driver Companion App
      • Control Tower
      • Tracking Page
    • Analytics and Insights
      • Business Insights
      • Location Analytics
  • Industries
    • Retail
    • FMCG/CPG
    • 3PL & CEP
    • Big & Bulky
    • Other Industries
      • E-commerce
      • E-grocery
      • Industrial Services
      • Manufacturing
      • Home Services
  • Resources
    • Guides
      • Reducing Cart Abandonment
      • Reducing WISMO Calls
      • Logistics Trends 2024
      • Unit Economics in All-mile
      • Last Mile Delivery Logistics
      • Last Mile Delivery Trends
      • Time Under the Roof
      • Peak Shipping Season
      • Electronic Products
      • Fleet Management
      • Healthcare Logistics
      • Transport Management System
      • E-commerce Logistics
      • Direct Store Delivery
      • Logistics Route Planner Guide
    • ROI Calculator
    • Product Demos
    • Whitepaper
    • Case Studies
    • Infographics
    • E-books
    • Blogs
    • Events & Webinars
    • Videos
    • API Reference Docs
    • Glossary
  • Company
    • About Us
    • Global Presence
      • Locus in Americas
      • Locus in Asia Pacific
      • Locus in the Middle East
    • Analyst Recognition
    • Careers
    • News & Press
    • Trust & Security
    • Contact Us
  • Customers
en  
en - English
id - Bahasa
Schedule a demo
  1. Home
  2. Blog
  3. The TMS Data Model Explained: Orders, Shipments, Loads, Legs, Stops and Tasks

General

The TMS Data Model Explained: Orders, Shipments, Loads, Legs, Stops and Tasks

Avatar photo

Aseem Sinha

Oct 22, 2026

11 mins read

A TMS data model is the set of objects a transportation management system uses to represent freight and its movement: the demand that must be served, the physical units to carry, the groupings that travel together, the vehicle movements that carry them and the events that record what happened. The same words mean different things in different systems, so an “order” in an ERP, a “shipment” in a carrier’s feed and a “stop” in a driver app are not the same record. Getting the vocabulary and the relationships right decides whether integrations map cleanly, whether status is trustworthy and whether reports mean what they appear to mean.

Key Takeaways

  • GS1 identifies physical logistic units with an SSCC and groups them into shipments with a GSIN and consignments with a GINC, so an industry vocabulary exists even though vendors name things differently.
  • SAP TM separates demand (a freight unit) from capacity documents (freight orders and bookings), while Oracle OTM uses order release, ship unit and shipment, so terms do not map one to one.
  • Locus’s public API names the order, tour, homebase, rider, transporter and vehicle, and treats a stop as an order, with no public stop or leg endpoint.
  • Status has to be held at the right level: in the worked example, an order-level flag would mark 100 of 10,000 daily orders delivered while a parcel was still undelivered.
  • FedEx’s 2026 survey of 700 leaders found only 4% use a single unified solution and 66% rely on three or more separate platforms, so shared definitions matter.

Why the TMS Data Model Matters: The Business Case

Every integration, report and exception rule depends on what the objects mean.

  • FedEx’s 2026 Future of Logistics Intelligence survey of 700 leaders found that only 4% use a single, unified solution and 66% rely on three or more separate platforms, so most operations translate between data models every day. It is a carrier-run survey.
  • GS1 describes a logistic unit as any combination of trade items packaged together for storage or transport, identified by an SSCC, which is the physical level most carrier scans refer to.
  • The Digital Container Shipping Association’s Track and Trace standard separates shipment, transport and equipment events, a sign that mature standards keep different kinds of status at different levels.
  • Gartner’s 2025 Magic Quadrant abstract says that transportation management systems help supply chain leaders manage disruptions and optimize costs, which depends on a model that can re-plan movements without losing the demand behind them.

A model that mixes levels produces status that is hard to trust and integrations that are hard to maintain.

Also Read: TMS vs WMS, ERP, Route Optimization: Where Each Ends

Why Locus Leads for a Clear, Open Data Model

A TMS earns trust when its objects are explicit and its API exposes them. Three things set Locus apart.

Recognized by analysts and selected after evaluation. Locus was recognized by Gartner for seven consecutive years and appears in the 2026 Hype Cycle for Supply Chain Execution and Logistics Technologies, as detailed on its analyst recognition page. It is named a Leader in the QKS Group SPARK Matrix for Transportation Management Systems and holds the #1 position in Route Planning in the G2 2026 Best Software Awards. In October 2025, Ingka Investments, the investment arm of Ingka Group, the world’s largest IKEA retailer, acquired Locus. Ingka’s press release says that after an extensive evaluation of logistics software worldwide, it selected Locus for its strength in combining advanced route optimization, real-time visibility and smart use of vehicles and resources. Locus continues to operate independently.

A published object model. Locus’s API specification names the order, with types PICKUP, DROP, SERVICE and STORE_PICKUP and statuses from OPEN through PLANNED, ASSIGNED and EXECUTING to COMPLETED, together with the tour, homebase, rider, transporter, vehicle, location and line item. It also names slots, promise information and dispatch waves, so planning, promising and execution share one model.

Agents that work on the model. Locus runs eight agents, including Dispatch, Capacity and Carrier, across 250+ real-world constraints under an Orchestrator, and has optimized 1.5B+ deliveries for 360+ enterprise customers across 30+ countries.

Locus’s API access is available to its clients, its public specification has no stop or leg endpoint because a stop is an order, and its pages do not map its objects to GS1, SAP or Oracle terms, so ask for a data-model walkthrough that covers split orders, multi-parcel orders and status roll-up.

Also Read: Integrating Locus APIs: Enterprise Logistics 2026

How a TMS Data Model Works From Order to Event

The six steps below follow one piece of demand through the model.

1. Start with the demand, the order

An order is the request to move goods or perform a service. It carries who, what, where and when, such as an address and a delivery window. SAP calls the pure demand a freight unit, and Locus calls it an order of type PICKUP, DROP, SERVICE or STORE_PICKUP.

2. Break it into physical handling units

The goods that move are parcels, pallets and cartons. GS1 calls any combination of trade items packed for transport a logistic unit and identifies each with an SSCC. An order can become several units, and a unit can hold items from several orders.

3. Group units into shipments or consignments

Units that travel together are grouped. GS1 uses a GSIN to number a set of logistic units in a shipment and a GINC for a consignment, and Oracle and SAP create shipments or freight orders by bundling demand. The grouping is where split and consolidated freight appears.

4. Assign the grouping to a movement

A movement is a trip, route or tour carried by a vehicle and driver or by a carrier. SAP’s freight order is the capacity document for a road or rail movement, and Locus plans orders into tours handled by riders or transporters.

5. Sequence stops and legs

A movement visits stops in order, and a journey has legs between hubs or modes. Some systems model stops as objects, and Locus treats each delivery, pickup or service as an order on the tour.

6. Attach events at the right level

Events belong to a level: an order is confirmed, a unit is scanned, a shipment departs, a stop is arrived at and completed. DCSA separates shipment, transport and equipment events for this reason, and a model that records every event on the order loses the detail.

Also Read: What Is an Agentic TMS? Enterprise Logistics Guide for 2026

Order, Handling Unit, Shipment and Movement Across Vocabularies: Key Differences

The table maps a neutral term to how some public sources name it. Terms differ by version and configuration, so treat the table as a starting point.

Neutral termMeaningGS1SAP TMOracle OTMLocus public API
Order or demandA request to move goods or do a serviceNot definedFreight unit (pure demand)Order base and order releaseOrder
Handling unitA physical unit carriedLogistic unit, SSCCNot stated hereShip unitNot stated
Shipment or consignmentUnits that travel togetherGSIN, GINCFreight order or freight bookingShipmentNot stated
MovementA vehicle or carrier tripNot definedFreight order for road or railShipmentTour
StopA visit within a movementNot definedNot stated hereNot stated hereAn order on a tour
EventSomething that happenedNot definedNot stated hereNot stated hereOrder status and callbacks

What to Look for in a TMS Data Model

One identifier per level

Check that orders, handling units, shipments, movements and stops each have their own stable identifier. A model with only an order number forces every integration to guess.

Many-to-many relationships

Look for support for split orders, consolidated shipments and multi-parcel orders. Real freight is not one order to one shipment to one truck.

Status at each level with clear roll-up

Ask how a unit’s status rolls up to the order and what the order shows when one of two parcels is delivered. A single status field cannot represent partial delivery.

Planned versus actual times

Each level should carry planned and actual timestamps. Without both, variance and SLA reports are unreliable.

Standard identifiers and extensibility

Check that the model can store GS1 identifiers such as SSCC and can be extended with custom fields. This decides how cleanly it exchanges data with carriers and warehouses.

Also Read: TMS Integration for Enterprise Logistics Teams in 2026

The Data Model in Action: Real-World Results

One order through the model on illustrative numbers. A customer orders three items online. The order is split into two parcels because of size. Both ride a linehaul leg to a hub and then a last-mile tour with 14 stops.

LevelObjects for this orderExample events
Order1, containing 3 line itemsConfirmed, planned
Handling units2 parcels, 2 SSCCsScanned at hub, scanned out for delivery
Shipment1, grouping both parcelsDeparted origin, arrived hub
Legs2, linehaul and last mileLeg started, leg completed
Movement1 last-mile tour with 14 stopsTour started, tour completed
Stop1 of the 14 stopsArrived, delivered or failed

Now suppose parcel A is delivered at 10:05 and parcel B fails because the customer is out. A system that sets the order to delivered on the first successful scan reports a delivered order with an undelivered parcel. If a depot ships 10,000 orders a day, 25% of them multi-parcel and 4% of those have a partial failure, an order-level flag overstates delivered orders by 100 a day. A roll-up rule that marks the order delivered only when every unit is delivered, and partially delivered otherwise, removes the error and tells customer service which parcel to chase.

A North American retailer. The retailer consolidated six systems into one and cut manual dispatch by more than 80%, with $1M+ in savings, 99%+ on-time delivery and exceptions resolved in under two hours, while its ERP and WMS stayed the systems of record. It shows one planning model sitting over several source systems. Read the retailer case study.

A Fortune 50 enterprise. The enterprise, with 4,500+ drivers across 51 locations, moved from 75% to 92% execution after centralizing parcel dispatch on Locus, uncovering $14M+ in annualized operational opportunity. Read the Fortune 50 case study.

Common TMS Data Model Mistakes to Avoid

Using one status for every level. A single flag cannot show partial delivery or a delayed linehaul, so hold status where the event happens.

Assuming terms match across systems. A freight unit, an order release and an order are different things, so map by meaning and not by name.

Modeling one order as one shipment. Splits and consolidations are normal, so test the model with both.

Skipping standard identifiers. Without SSCC or similar identifiers, matching carrier scans to orders becomes guesswork.

How Locus Approaches the TMS Data Model

Locus, the world’s first Decision-Intelligent, Agentic TMS, plans orders into tours handled by riders and transporters from homebases, with vehicles, locations, slots and promise information in the same model, and its Dispatch, Capacity and Carrier agents act on that model under the Orchestrator. Its order API covers creating, rescheduling, parking, cancelling and completing orders and requesting serviceable slots, and its dispatch management software connects through APIs to TMS, WMS, OMS, CRM and ERP systems. Locus’s public specification has no stop, leg or handling-unit endpoint and its pages do not map its objects to GS1, SAP or Oracle terms, so ask for a walkthrough of a split, multi-parcel order from creation to proof of delivery. To review your own data model, schedule a demo.

For IT and logistics leaders asking how a TMS data model should work, Locus offers an open order, tour and slot model with planning agents on top, so demand, movement and promise stay connected.

Frequently Asked Questions

What is a TMS data model? It is the set of objects a TMS uses to represent freight and its movement: orders, handling units, shipments, loads or trips, legs, stops and events, with the relationships between them.

What is the difference between an order and a shipment? An order is the demand to move goods. A shipment groups the units that travel together. One order can become several shipments, and one shipment can serve several orders.

What is a logistic unit and an SSCC? GS1 defines a logistic unit as any combination of trade items packed for storage or transport. An SSCC is the identifier used for it, such as a pallet, carton or parcel.

What is a freight unit in SAP TM? SAP describes a freight unit as the original transportation demand, which consumes capacity. A freight order is the capacity document for a road or rail movement.

Why does the level of status matter? Events happen to different objects. A parcel can be delivered while its order is not, so status held only on the order misreports partial delivery.

What objects does Locus’s API expose? Its public specification names orders, tours, homebases, riders, transporters, vehicles, locations, line items, slots and promise information. A stop is an order on a tour.

MEET THE AUTHOR
Avatar photo
Aseem Sinha
Vice President - Marketing

Aseem, leads Marketing at Locus. He has more than two decades of experience in executing global brand, product, and growth marketing strategies across the US, Europe, SEA, MEA, and India.

Related Tags:

Previous Post Next Post

General

How to Test a Logistics Integration Before Go-Live: Sandbox, Replay, Reconciliation and Parallel Run

Avatar photo

Anas T

Oct 22, 2026

A six-step test plan for logistics integrations: contracts, sandbox, idempotency and retries, replay, reconciliation and a parallel run with statistical exit criteria.

Read more

General

How to Prove TMS Value in 90 Days: Baselines, Control Groups and the Metrics Finance Will Accept

Avatar photo

Ishan Bhattacharya

Oct 22, 2026

How to prove a TMS is working in 90 days: freeze a baseline, use a matched control group, set attribution rules and classify savings so finance accepts them. Includes a worked example.

Read more

The TMS Data Model Explained: Orders, Shipments, Loads, Legs, Stops and Tasks

  • Share iconShare
    • facebook iconFacebook
    • Twitter iconTwitter
    • Linkedin iconLinkedIn
    • Email iconEmail
  • Print iconPrint
  • Download iconDownload
  • Schedule a Demo
glossary sidebar image

Is your team spending more time on fixing logistics plan than running the operation?

  • Agentic transportation management from order intake to freight settlement
  • Route optimization built on 250+ real-world constraints
  • AI-driven dispatch with automatic execution handling
20% Cost Reduction
66% Faster Planning Cycles
Schedule a demo

Insights Worth Your Time

General

Locus 2026 UK Consumer Survey: Why Returns Visibility is Now the Conversion Engine for AI-Driven Shopping in UK Retail

Avatar photo

Aseem Sinha

May 29, 2026

General

Locus 2026 US Consumer Survey: Generative AI isn’t Just Changing How Consumers Shop, it’s Breaking the Demand Patterns US Retail Was Built On

Avatar photo

Ishan Bhattacharya

May 29, 2026

General

Embedded vs Bolted-On AI: The Architecture Question European Logistics Buyers Are Asking

Avatar photo

Aseem Sinha

May 21, 2026

General

Hybrid Fleet Management: How Owned, 3PL, Gig, ICE, and EV Capacity Actually Operate at Most Enterprises

Avatar photo

Aseem Sinha

May 7, 2026

General

US Returns Hit $850 Billion in 2025: Why US Retailers Are Restructuring Reverse Logistics in 2026

Avatar photo

Ishan Bhattacharya

May 7, 2026

SUBSCRIBE TO OUR NEWSLETTER

Stay up to date with the latest marketing, sales, and service tips and news

Locus Logo
Subscribe to our newsletter
Platform
  • Transportation Management System
  • Last Mile Delivery Solution
  • Fulfillment Automation
  • Dispatch Planning
  • Delivery Orchestration
  • Track and Trace
  • Analytics and Insights
Industries
  • Retail
  • FMCG/CPG
  • 3PL & CEP
  • Big & Bulky
  • E-commerce
  • E-grocery
  • Industrial Services
  • Manufacturing
  • Home Services
Resources
  • Use Cases
  • Whitepapers
  • Case Studies
  • E-books
  • Blogs
  • Reports
  • Events & Webinars
  • Videos
  • API Reference Docs
  • Glossary
Company
  • About Us
  • Customers
  • Analyst Recognition
  • Careers
  • News & Press
  • Trust & Security
  • Contact Us
  • Hey AI, Learn About Us
  • LLM Text
ISO certificates image
youtube linkedin twitter-x instagram

© 2026 Mara Labs Inc. All rights reserved. Privacy and Terms

locus-logo

Cut last mile delivery costs by 20% with AI-Powered route optimization

1.5B+Deliveries optimized

99.5%SLA Adherences

30+countries

Trusted by 360+ enterprises worldwide

Get a Complimentary Tailored Route Simulation

locus-logo

Reduce dispatch planning time by 75% with Locus DispatchIQ

1.5B+Deliveries optimized

320M+Savings in logistics cost

30+countries served

Trusted by 360+ enterprises worldwide

Get a Complimentary Tailored Route Simulation

locus-logo

Locus offers Enterprise TMS for high-volume, complex operations

1.5B+Deliveries optimized

320M+Savings in logistics cost

30+countries served

Trusted by 360+ enterprises worldwide

Get a Complimentary Network Impact Assessment

locus-logo

Trusted by 360+ enterprises to slash costs and scale operations

1.5B+Deliveries optimized

320M+Savings in logistics cost

30+countries served

Trusted by 360+ enterprises worldwide

Get a Complimentary Enterprise Logistics Assessment