Overview
Loads represent assignments for drivers and are the primary way to manage and track them within the app. A load consists of a series of stops, such as shippers and consignees, along with the specific actions a user may perform at each location.
Load data is retrieved from your Loads web service and displayed in the mobile app. Users can view their full assignment history in the Loads List, while the Loads dashboard card provide a quick summary of their current load and stop.
How It Works
The platform manages loads by synchronizing data between your Loads web service and the mobile app.
Assignment and Retrieval
The platform retrieves load data by calling your Loads web service. Each load is organized into a list of stops, with each stop containing its own status and location data.
The following properties control load visibility and focus:
current: Highlights a specific load as the user’s active assignmentNOTE: A load or stop that has a
truevalue for thecurrentproperty will display a yellow bar. There is currently no external control over the color.active: Determines whether a load appears in the main Loads List or Load History
Workflow and Actions
Users can interact within loads through status updates via actions and forms. When a user completes a workflow action, the app sends the data to your Messaging web service and refreshes the load data to display the next available step.
Navigation and Geofencing
Each stop may include location coordinates to support turn-by-turn navigation. If you do not provide location coordinates a map will not be presented, and navigation will not be available to the stop. You can also attach geofences to stops to trigger automated events or notifications when a user enters or exits a specific area.
order_number: The primary reference identifier for the loadNOTE: The app automatically converts order numbers into tappable links within messages and notes, allowing users to quickly navigate to a specific load.
load_status_label: A human-readable status displayed to the driver. While theload_statusproperty is a code used for workflow logic, this label is what the driver actually seesidentifiers: Custom label and value pairs that display additional information on the load details, such as “Trailer Number” or “Gate Code”