Overview

This document contains all of the return events that are related to Maven's linehaul and dock application for LTL.

Refer to the overview page for general information on return events.

Manifest Return Events

Manifest Details Updated

Event Type

ManifestDetailsUpdated

Details

The manifest details updated return event fires anytime the header information of a manifest is updated. The return event will include the time the event was generated, along with all fields that were modified; including the previous and updated values. For a list of all possible fields that can be updated, please refer to the table in the UpdateManifestDetails command found here.

The header information of a manifest does not include updates to status or associated shipments.

For each field that is updated, an object containing the previous and updated values is provided. The previous and updated value can be null implying the field was added or removed respectively.

Sample Payload

{
  id: "ac5548f2-2b7c-4721-bf64-69074ffd181b",
  timestamp: "2025-07-25T11:58:44.987Z",
  uploadedTimestamp: "2025-07-25T11:58:44.987Z",
  createdTimestamp: "2025-07-25T11:58:44.921Z",
  eventType: "manifestDetailsUpdated",
  data: {
    changedFields: {
      trailerNumber: {
        previous: "729029",
        updated: "7909726"
      }
    },
    currentManifest: {
      actualStartUnloadingTime: "2025-07-25T00:15:56.000Z",
      destinationLocationCode: "PGH",
      poison: false,
      scheduledCloseTime: "2025-07-25T00:15:56.000Z",
      trailerNumber: "HT48792",
      originDoorNumber: "63",
      actualFinishUnloadingTime: null,
      manifestNumber: "R0320985",
      manifestType: "LINEHAUL",
      currentLocationCode: null,
      food: false,
      tags: [
        "Placarded Load"
      ],
      destinationDoorNumber: null,
      scheduledStartLoadingTime: null,
      actualStartLoadingTime: null,
      scheduledFinishUnloadingTime: null,
      hazmat: false,
      originLocationCode: "PGH",
      scheduledStartUnloadingTime: null,
      manifestCreatedOn: "2025-07-24T16:28:20.580Z",
      attributes: {},
      currentLocationDoorNumber: null,
      actualCloseTime: null,
      status: "PLANNING"
    }
  },
  eventSource: {
    userId: "513247",
    displayName: "Camp, Joshua",
    system: "Dock App"
  },
  referenceIds: {
    manifestNumber: "R0320985"
  }
}

Started Unloading Manifest

Event Type

StartedUnloadingManifest

Details

The started unloading manifest event is fired anytime a manifest is transitioned into an unloading status. The event includes the time the event was generated, the dock location of the manifest where unloading is taking place, as well as the set of shipments that are currently loaded onto the manifest.

Sample Payload

{
  id: "cdc29eac5-2946-4ff4-bce3-a96be4985e8f",
  timestamp: "2024-12-10T13:47:00",
  eventType: "StartedUnloadingManifest",
  data: {
    eventTime: "2024-12-10T13:46:01", 
    locationCode: "PGH",
    doorNumber: "15",
    loadedShipments: [{
      proNumber: "91203901",
      BOLNumber: "XX1",
      PONumber: "YY2",
      PUNumber: "ZZ3"
    }, {
      proNumber: "91203902",
      BOLNumber: "XX1",
      PONumber: "YY2",
      PUNumber: "ZZ3"
    }, {
      proNumber: "91203903",
      BOLNumber: "XX1",
      PONumber: "YY2",
      PUNumber: "ZZ3"
    }, {
      proNumber: "91203904",
      BOLNumber: "XX1",
      PONumber: "YY2",
      PUNumber: "ZZ3"
    }]
  },
  referenceIds: {
    manifestId: "2024-12-06-D828078"
  }
}

Finished Unloading Manifest

Event Type

FinishedUnloadingManifest

Details

The finished unloading manifest event is fired anytime a manifest is marked as completed unloading. The event includes the time the event was generated, the dock location of the manifest where unloading is taking place, as well as any shipments that remained on the manifest after unloading was complete. If no shipments remained on the manifest, the loadedShipments array will be empty.

Sample Payload

{
  id: "77b3013d-0fc2-408f-ac3c-d76fcb81db1b",
  timestamp: "2024-12-10T13:47:00",
  eventType: "FinishedUnloadingManifest",
  data: {
    eventTime: "2024-12-10T13:46:01", 
    locationCode: "PGH",
    doorNumber: "15",
    loadedShipments: [{
      proNumber: "91203901",
      BOLNumber: "XX1",
      PONumber: "YY2",
      PUNumber: "ZZ3"
    }]
  },
  referenceIds: {
    manifestId: "2024-12-06-D828078"
  }
}

Manifest Completed

Event Type

CompletedManifest

Details

When a user completes a manifest in Maven. Completing a manifest means that the manifest is done and no longer expected to be used by the system.

Sample Payload

{
	"id":"fc8bf73d-3bf8-4c6d-a12d-9adda8640a64",
	"timestamp":"2025-07-11T19:38:38.244Z",
	"uploadedTimestamp":"2025-07-11T19:38:38.244Z",
	"createdTimestamp":"2025-07-11T19:38:38.198Z",
	"eventType":"manifestCompleted",
	"data":{
    "eventTime" : "2025-07-11T19:38:38.198Z",
		"loadedShipments":[],
		"manifest":{
			"actualStartUnloadingTime":null,
			"destinationLocationCode":"WMS",
			"poison":false,
			"scheduledCloseTime":"2025-06-19T07:00:00.000Z",
			"trailerNumber":"HT12345",
			"originDoorNumber":"62",
			"actualFinishUnloadingTime":null,
			"manifestNumber":"R0284611",
			"manifestType":"LINEHAUL",
			"currentLocationCode":"PGH",
			"food":false,
			"tags":[],
			"destinationDoorNumber":null,
			"scheduledStartLoadingTime":null,
			"actualStartLoadingTime":"2025-07-11T19:38:37.591Z",
			"scheduledFinishUnloadingTime":null,
			"hazmat":false,
			"originLocationCode":"PGH",
			"scheduledStartUnloadingTime":null,
			"manifestCreatedOn":"2025-06-18T16:38:32.467Z",
			"attributes":{},
			"currentLocationDoorNumber":"62",
			"actualCloseTime":null,
			"status":"LOADING"
			}
		},
	"eventSource":{
		"userId":"102678",
		"displayName":"Benna, David",
		"system":"Dock App"
		},
	"referenceIds":{
		"manifestNumber":"R0284611"
		}
},

Movement Return Events

Movement Assigned

Event Type

MovementAssigned

Details

The movement assigned event is fired whenever a user assigns a movement to a driver or team of drivers in the Maven product. This will contain the reference ids to the movement and the driver code or codes the movement is assigned to. If a dispatcher reassigns a movement to a driver, a new MovementAssigned event will be generated to reflect the most updated assignment of the movement.

Sample Payload

{
  id: "77b3013d-0fc2-408f-ac3c-d76fcb81db1b",
  timestamp: "2024-12-10T13:47:00",
  eventType: "MovementAssigned",
  data: {
    eventTime: "2024-12-10T13:46:01", 
    driverCodes: ["EK234","GO9829"]
  },
  referenceIds: {
    movementId: "2024-12-06-D828078"
  }
}

Movement Unassigned

Event Type

MovementUnassigned

Details

The movement unassigned event is fired whenever a user unassigns a movement from a driver or team of drivers in the Maven product. This will contain the reference ids to the movement.

Sample Payload

{
  id: "77b3013d-0fc2-408f-ac3c-d76fcb81db1b",
  timestamp: "2024-12-10T13:47:00",
  eventType: "MovementDetailsUpdated",
  data: {
    eventTime: "2024-12-10T13:46:01", 
  },
  referenceIds: {
    movementId: "2024-12-06-D828078"
  }
}

Movement Details Updated

Event Type

MovementDetailsUpdated

Details

The movement details updated will be triggered when a user updates the details of a movement. For example, a user could update the origin, destination, scheduled departure time, scheduled arrival time, or vehicle on a movement, or make multiple changes that would be contained in this event.

Sample Payload

{
  "id": "ac5548f2-2b7c-4721-bf64-69074ffd181b",
  "timestamp": "2025-07-25T11:58:44.987Z",
  "uploadedTimestamp": "2025-07-25T11:58:44.987Z",
  createdTimestamp: "2025-07-25T11:58:44.921Z",
  "eventType": "MovementDetailsUpdated",
  "data": {
    "changedFields": {
      "vehicleNumber": {
        "previous": "830092",
        "updated": "H90983"
      },
      "scheduledDepartureTime": {
        "previous": "2025-07-25T11:58:44.921Z",
        "updated": "2025-07-25T11:58:44.921Z"
      }
    },
    "currentMovement": {
      "originLocationCode": "ATL",
      "destinationLocationCode": "DAL",
      "vehicleNumber": "H90983",
      "driverCodes": ["SMITHJ"],
      "scheduledAvailableTime": "2025-07-25T11:58:44.921Z",
 			"actualAvailableTime": "2025-07-25T11:58:44.921Z",
      "scheduledDepartureTime": "2025-07-25T11:58:44.921Z",
			"actualDepartureTime": "2025-07-25T11:58:44.921Z",
      "scheduledArrivalTime": "2025-07-25T11:58:44.921Z",
			"actualArrivalTime": "2025-07-25T11:58:44.921Z",
      "associatedManifest": { "referenceIds": { "loadNumber": "..." } },
    }
  },
  "referenceIds": {
    "movementId": "..."
  },
  "eventSource": {
    "userId": "WHITEJ",
    "DisplayName": "White, Jay",
    "system": "Linehaul Dispatch"
}
}

Movement Unassigned From Manifest

Event Type

MovementUnassignedFromManifest

Details

When a movement is unassigned from a manifest.

Sample Payload

{
  "id": "22d76843-2bac-4138-8481-67c51e483491",
  "timestamp": "2025-10-14T17:01:47.614Z",
  "uploadedTimestamp": "2025-10-14T17:01:47.614Z",
  "createdTimestamp": "2025-10-14T17:01:46.000Z",
  "eventType": "MovementUnassignedFromManifest",
  "data": {
    "eventTime": "2025-10-14T17:01:46.000Z",
    "sourceManifest": {
      "referenceIds": {
        "loadNumber": "20251007KNXNAS001"
      }
    }
  },
  "eventSource": {
    "userId": "EKBERGA",
    "displayName": "Ekberg, Alexa",
		"system" : "Linehaul Dispatch"
		
  },

  "referenceIds": {
    "legId": "20250510KNX20250510909"
  }
}

Movement Reassigned To Manifest

Event Type

MovementReassignedToManifest

Details

When a movement is assigned to an existing manifest. Contains the new manifest reference id and the sequence number of the movement on the manifest.

Sample Payload


{
  "id": "ac5548f2-2b7c-4721-bf64-69074ffd181b",
  "timestamp": "2025-07-25T11:58:44.987Z",
  "uploadedTimestamp": "2025-07-25T11:58:44.987Z",
  createdTimestamp: "2025-07-25T11:58:44.921Z",
  "eventType": "MovementReassignedtoManifest",
  "data": {
    "eventTime": "2025-10-14T17:01:46.000Z",
    "associatedManifest": {
     'referenceIds': {
       'loadNumber': "20251007KNXNAS001"
    }
  },
    "sequenceNumber": 10,
    },
  "referenceIds": {
    "legId": "KNX912829393"
  },
  "eventSource": {
    userId: "124234",
    displayName: "Gorziglia, Daniel",
    system: "Maven"
  }
}

Movement Deleted

Event Type

MovementDeleted

Details

When a movement is deleted in Maven's system

Sample Payload

{
  "id": "67b17783-f187-4f8f-95d7-6f693c835a3b",
  "timestamp": "2025-09-15T12:45:00Z",
  "eventType": "MovementDeleted",
  "data": {
    "eventTime": "2025-09-15T12:40:00Z",
    "reason": "Duplicate entry created in error"
  },
  "referenceIds": { "movementId": "MVT-12345" },
  "eventSource": { "app": "LinehaulDispatch", "version": "1.0.0" }
}

Movement Arrived

Event Type

`MovementArrived

Details

When a movement is arrived by a user in Maven's system

Sample Payload

{
  "id": "ac5548f2-2b7c-4721-bf64-69074ffd181b",
  "timestamp": "2025-07-25T11:58:44.987Z",
  "uploadedTimestamp": "2025-07-25T11:58:44.987Z",
  createdTimestamp: "2025-07-25T11:58:44.921Z",
  "eventType": "MovementArrived",
  "data": {
    "eventTime" : "2025-07-25T11:58:44.987Z",
    "movement": {
			"originLocationCode": "ATL",
      "destinationLocationCode": "DAL",
      "vehicleNumber": "H90983",
      "driverCodes": ["SMITHJ"],
      "scheduledAvailableTime": "2025-07-25T11:58:44.921Z",
 			"actualAvailableTime": "2025-07-25T11:58:44.921Z",
      "scheduledDepartureTime": "2025-07-25T11:58:44.921Z",
			"actualDepartureTime": "2025-07-25T11:58:44.921Z",
      "scheduledArrivalTime": "2025-07-25T11:58:44.921Z",
			"actualArrivalTime": "2025-07-25T11:58:44.921Z",
      "associatedManifest": { 
        "referenceIds": { 	
          "loadNumber": "..." } 	
		},
    }
  },
  "referenceIds": {
    "movementId": "..."
  },
  "eventSource": {
    "userId": "504916",
    "displayName": "Bailey, Rodney",
    "system": "Dock Management"

}

Movement Departed

Event Type

`MovementDeparted

Details

When a movement is departed by a user in Maven's system

Sample Payload

{
  "id": "ac5548f2-2b7c-4721-bf64-69074ffd181b",
  "timestamp": "2025-07-25T11:58:44.987Z",
  "uploadedTimestamp": "2025-07-25T11:58:44.987Z",
  createdTimestamp: "2025-07-25T11:58:44.921Z",
  "eventType": "MovementDeparted",
  "data": {
    "eventTime" : "2025-07-25T11:58:44.987Z",
    "movement": {
			"originLocationCode": "ATL",
      "destinationLocationCode": "DAL",
      "vehicleNumber": "H90983",
      "driverCodes": ["SMITHJ"],
      "scheduledAvailableTime": "2025-07-25T11:58:44.921Z",
 			"actualAvailableTime": "2025-07-25T11:58:44.921Z",
      "scheduledDepartureTime": "2025-07-25T11:58:44.921Z",
			"actualDepartureTime": "2025-07-25T11:58:44.921Z",
      "scheduledArrivalTime": "2025-07-25T11:58:44.921Z",
			"actualArrivalTime": "2025-07-25T11:58:44.921Z",
      "associatedManifest": { 
        "referenceIds": { 	
          "loadNumber": "..." } 	
		},
    }
  },
  "referenceIds": {
    "movementId": "..."
  },
  "eventSource": {
    "userId": "504916",
    "displayName": "Bailey, Rodney",
    "system": "Dock Management"

}