Manifests and Movements

When working with Maven's linehaul system - there are 2 main data concepts to understand: manifests and movements. In its most basic form, a manifest represents the contents of a trailer and movements represent how that manifest will be transported from its origin to destination. All dispatching and planning decisions performed within Maven deal with manipulating manifests and movements and the entire execution of the linehaul network is performed with these two core building blocks.

Manifest Schema

Below is a summarized list of fields that belong on a manifest

Field Names	Description
Manifest Number	Assigned Manifest Number
Trailer Number	Assigned Trailer Number
Origin Location )Location Code + Door Number)	Origin location of the manifest
Destination Location (Location Code + Door Number)	Final location of the manifest
Current Location (Location Code OR IN TRANSIT)	Current location of the manifest
Scheduled Loading Time	When is the manifest scheduled to begin loading (at origin)
Scheduled Close Time	When is the manifest scheduled to be finished loading / closed (at origin)
Scheduled Start Unloading Time	When is the manifest scheduled to begin unloading (at destination)
Scheduled Finish Unloading Time	When is the manifest scheduled to begin unloading (at desintation)
Associated Shipments (PROs)	List of associated shipments on the manifest
Tags / Hazmat / Poison / Foods	Tags indicating special notes about the manifest

Movement Schema

Below is a summarized list of fields that belong on a movement

Field Names	Description
Origin Location )Location Code + Door Number)	Origin location of the movement
Destination Location (Location Code + Door Number)	Destination location of the movement
Driver Code	Driver assigned to the movement
Scheduled Available Time	When is the movement scheduled to become available for a driver
Scheduled Departure Time	When is the movement scheduled to depart
Scheduled Arrival Time	When is the movement scheduled to arrive
Sequence Number	If multiple movements belong to a manifest, the sequence number is used to indicate the order in which the movements should be executed

Examples

Generally speaking a manifest owns its movements and a movement cannot exist without a manifest.

Case: Shuttle Trip

Suppose we have to shuttle 20 shipments directly from Philadelphia to Richmond. The driver of the shuttle trip is Clark Kent. These 20 shipments will be manifested onto 1 trailer (Trailer ABC). Therefore we'd say:

• There is 1 manifest
  • The manifest origin is Philadelphia.
  • The manifest destination is Richmond.
  • The manifest contains 20 shipments.
  • The manifest has a trailer assignment of ABC
• The manifest contains 1 movement
  • The movement origin is Philadelphia.
  • The movement destination is Richmond.
  • The movement is assigned to Clark Kent.

Case: Relay Trip

Suppose we have 20 shipments that need to go from Philadelphia to Charlotte. These 20 shipments will be manifested onto 1 trailer (Trailer ABC) and will relay through Richmond. Luke Cage is assigned to drive the first movement and Iron Man is assigned to drive the second movement. Therefore we'd say:

• There is 1 manifest
  • The manifest origin is Philadelphia.
  • The manifest destination is Charlotte.
  • The manifest contains 20 shipments.
  • The manifest has a trailer assignment of ABC
• The manifest contains 2 movements
  • Movement 1 from Philadelphia to Richmond assigned to Luke Cage
  • Movement 2 from Richmond to Charlotte assigned to Iron Man

Case: Pulling Doubles

Suppose we are pulling doubles (Trailer ABC and DEF), each trailer containing 10 shipments directly from Philadelphia to Richmond. The driver of the trip is Clark Kent. Since pulling doubles means carrying two trailers, each trailer would be assigned its own manifest and that manifest would have its own movement. Therefore we'd say:

• There are 2 manifests
  • Manifest 1 is going from Philadelphia to Richmond and is assigned to trailer ABC
    • Manifest 1 has 1 movement from Philadelphia to Richmond and is assigned to Clark Kent.
  • Manifest 2 is going from Philadelphia to Richmond and is assigned to trailer DEF
    • Manifest 2 has 1 movement from Philadelphia to Richmond and is assigned to Clark Kent.

Case: Pulling an Empty

Suppose we are pulling an empty trailer (ABC) from Philadelphia to Richmond. The driver of the trip is Clark Kent. Therefore we'd say:

• There is 1 manifest
  • The manifest origin is Philadelphia.
  • The manifest destination is Richmond.
  • The manifest contains 0 shipments.
  • The manifest has a trailer assignment of ABC
• The manifest contains 1 movement
  • Movement 1 from Philadelphia to Richmond assigned to Clark Kent

Case: Bobtailing

Suppose we need to reposition a driver and are dispatching a bobtail from Philadelphia to Richmond. The driver of the trip is Clark Kent. Therefore we'd say:

• There is no manifest
• There is 1 movement from Philadelphia to Richmond

Bobtailing is the only example where a movement can be created without requiring a manifest.