Trips

The Trips module provides an overview of all scheduled trips. This information can be consulted by a dispatcher to evaluate the overall trip execution and review feedback submitted by the driver in the SCALAR Cargo mobile app. It facilitates customers and integrators to integrate their planning into SCALAR, allowing for efficient logistics management.

NOTE:

Scheduled trips can only be created using the SCALAR Datahub APIs.

What is a trip? #

Conceptual clarification
Trips	The trip level focuses on the cargo load carriers such as a trailer or a container, which are used to move the goods from the place of origin to the destination. NOTE: Couple and decouple actions can be part of the trip. A trip can be visualized on the Trips page. It is not sent to the SCALAR Cargo App.
Legs	The leg level focuses on a single resource combination, which consists of a vehicle and a driver, within a trip. Legs within a trip must be executed in a determined sequence because they are using the same cargo load carriers. Multiple legs can be in progress at the same time. For example, two resource combinations are driving towards the same location to decouple the trailer from the first resource combination and couple it to the second resource combination. A leg can be visualized in the Schedule tab of the SCALAR Cargo app and on the Trips page. A leg can only be started when the driver is linked to an asset. A leg can be scheduled for the following: An asset only: a driver will see this leg as soon as they are linked to this asset. A driver only: a driver will see this leg as soon as they sign in to the SCALAR Cargo app. An asset and driver combination: a driver will see this leg as soon as the driver signs into the SCALAR Cargo app.
Missions	A mission is a collection of the work or actions that must be executed at the same place. The mission can contain an optional expected start time parameter, which is an indication of when the driver should be at that mission. A mission can contain multiple scheduled actions, which must be executed in a defined sequence. A mission can be visualized in the Schedule tab of the SCALAR Cargo app and on the Trips page.
Actions	The action level contains the scheduled task that must be executed by the driver. The driver executes the action by starting an activity and answering the linked questions. Generally, a planned action has one activity. In case more detailed activity information is required, related activities can be configured. An action can be visualized in the Schedule tab in the SCALAR Cargo app and on the Trips pages. NOTE: For ‘Load’ and ‘Unload’ action types, additional fields can be added to describe the goods for loading and unloading.
Orders	The order level specifies the goods that must be moved for a single customer order. Orders can be used in the workflows to help the driver in providing more detailed feedback. An order can be visualized in the Schedule tab in the SCALAR Cargo app and on the Trips pages.
Load carrier	The load carrier level specifies the smallest moveable item within the order, for example, a box or a pallet. Load carriers can be used in the workflows to help the driver in providing more detailed feedback. A load carrier can be visualized in the Schedule tab in the SCALAR Cargo app and on the Trips pages.

View trips #

To launch the Trips module, from the left navigation pane, click Trips . The Trips page is displayed.

NOTE:

From the calendar picker , select the date for which you want to view the trip details.

Click to move through the dates.

Trip records can be retrieved in accordance with your organization’s data retention policy, which is 365 days by default. This table provides a description of the various columns.

Column	Description
	Trips : Opens the shortcut menu to expand all the trips or collapse all the trips Legs : The icon in this column indicates that this is the leg of the trip Missions : The icon in this column indicates that this is the mission of the trip NOTE: The icons for the leg and mission provide visual cues to the different levels of a trip after expansion. The arrows or list items on each row are aligned with these icons as shown in this image.
Name	Name of the trip, leg, and mission
Vehicle	Asset name of the scheduled or actual vehicle
Driver	Driver name of the scheduled or actual driver
Trailer	Asset name of the scheduled trailer
Status	Status of the trip, leg, and mission. Possible states: Not started, In progress, and Finished.
From	Place name of the first mission
To	Place name of the last mission
Start time	Start time of the trip, leg, and mission
Start location	Start location of the trip, leg, or mission
End time	End time of the trip, leg, and mission
End location	End location of the trip, leg, or mission

Customize column view #

You can hide or show columns on the Trips page. On the Trips page > click Columns. To show or hide columns, from the Column display list, select or clear the checkboxes.

View legs and missions #

On the Trips page, you can expand a trip to view the legs and missions. Click Trips to open the shortcut menu, and then click Expand all trips.

The entire trip and any underlying legs and missions are displayed:

If the Trip details sheet is enabled, use / buttons to expand or collapse trips/legs. Click to expand a trip/leg. Click to collapse a trip/leg.

If the Trip details sheet is not enabled (see Layout option), you can click anywhere in the entire row to expand or collapse a trip/leg. The image below displays the different levels: scheduled trips, legs, and missions.

Element	Denotes
1	Trip
2	Leg
3	Mission

Layout options #

This feature enables you to have a detailed timeline view of the trip. If enabled, selecting a row on the Trips page will display information on the Trip details sheet.

To view details of individual legs, from the upper-right corner of the Trips page, click Layout options . The Show trip details sheet slider is displayed.
Turn on the Show trip details sheet button. The Trip details sheet is displayed. For more information, see Trip details in the next section.

NOTE:

You can also right-click a row in the Trips page to display the trip details side sheet.

Trip details #

In the Trip details sheet, you can view detailed information about the scheduled legs, missions, actions, orders and load carriers of a trip.

On the Trips page, click the required trip to view its details on the Trip details sheet.
To view details of a trip or a leg, ensure that the Show trip details sheet option is enabled (see Layout options).

The selected trip is displayed in bold.

Leg details #

Click the required leg. The selected leg (and the trip it belongs to) is displayed in bold.

The details of the selected leg and its missions are displayed on the Trip details sheet: the overall details of individual legs, such as the place of the mission, actions, actual start time, status, orders, and feedback.

Mission details #

Select a mission to view mission details on the Trip details sheet as shown in the image below. The selected mission (and the trip and leg it belongs to) is displayed.

To view the action details, you can click the corresponding action icon, for example, Load . The action details for the selected action are displayed.

View trip feedback #

On the Trip details sheet, in the action section, click Feedback. The answers filled in by the driver in the SCALAR Cargo app are displayed.

NOTE:

The feedback button appears when you expand an action.
The button is disabled if the status of the action is ‘Not started’.

On the Trips details page > in the action details section > hover over or click the info icon () next to the planned/actual duration to view the start time, end date, and duration for each activity executed.

NOTE:

The info icon is not displayed if the status of the action is ‘Not started’.

View order details #

On the Trip details sheet, in the Orders section, click the name of the order, for example, ‘Mission 2 order 1’. The order details are displayed.

NOTE:

The orders and load carriers are displayed on the Trip details sheet only when provided during trip creation.

ETA of the next stop #

Dispatchers can view the ETA (estimated time of arrival) for the next mission on the Trips details page. This ETA is updated periodically for the next mission of a scheduled trip until the mission is started. This ETA information appears as a clock icon for the next mission. Click the clock icon to view additional details.

NOTE:

The ETA calculation is started:
- For the first mission, as soon as the leg is started
- For each next mission, as soon as the previous mission is marked as ‘Finished’
ETA is recalculated every five minutes
ETA is no longer calculated as soon as the next mission is ‘In progress’

To view the ETA details, click the Clock icon in the actions section. The details are displayed in the ETA details panel.

NOTE:

A warning iconwith the error message is displayed if the ETA calculation fails, for example, if the current location of the truck is not known.

This table provides the descriptions about the ETA information.

Row	Description
Graph	Displays the resting and driving times along the timeline
Resting	Total time a driver must rest before arriving at the next mission
Driving	Total time a driver must drive before arriving at the next mission
Total	Total remaining time before the driver arrives at the next mission. NOTE: This is the sum of the total resting time and the total driving time.
ETA	Estimated time of arrival
Planned start time	The time when the third-party system expects the driver to arrive at the next mission NOTE: This field is optional. A customer can create trips without the planned start time details, in which case, only the ETA values are displayed.
+/- time	Time difference between the ETA and the planned start time In this example, the driver is expected to arrive at 5:00 PM. However, based on the available SCALAR data of the given resource combination and the location of the next mission, the ETA is 02:17:56, which is earlier than the planned arrival time. NOTE: Value color code: Red: The ETA is > the planned start time Green: The ETA is < the planned start time This value is displayed only when the planned start time is provided by the third-party system.

Select Region and Language

User Documentation

Hardware Installation Guides

What is a trip? #