Shipment Management Data Structure

A shipment in OTM consists of one or more Equipment records (containers or trailers), Shipment Ship Units loaded into each equipment, and Shipment Ship Unit Lines that link back to the original Order Release lines. Understanding this structure is essential for troubleshooting planning results, writing integration queries, and working with carrier tracking events.

Shipment Structure:

When OTM plans an Order Release to a shipment, it creates Shipment Ship Units and assigns them to equipment. If a Bulk Plan splits an order across two containers — say 60 units in one and 40 in another — that split is recorded at the Shipment Ship Unit Line level. This line is the critical link between the shipment and the originating order: it ties back to a specific item, Order Release Line, Order Release, and Order Base.

Itinerary

An Itinerary defines the route OTM Bulk Plan uses to move freight — the origin region, destination region, transport mode, and equipment types for each leg. Bulk Plan matches order release origins and destinations against itinerary lanes to determine which route to use. Without a matching itinerary, planning will fail.

For the TCRP scenario we defined four itineraries — three single-leg and one multi-leg. Refer to the business scenario for the full network diagram.