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 Cargo mobile app. It facilitates customers and integrators to integrate their planning into SCALAR, allowing for efficient logistics management.

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 * Connect and disconnect actions can be part of the trip. * A trip can be visualized on the Trips page. It is not sent to the 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 disconnect the trailer from the first resource combination and connect it to the second resource combination. A leg can be visualized in the Schedule tab of the Cargo app and on the Trips page. 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 Cargo app. *An asset and driver combination: a driver will see this leg as soon as the driver signs into the Cargo app, but can only execute it after they are linked to the asset.
Missions	A mission is a collection of the work or actions that must be executed at the same place. It contains the expected start time that is used to sequence all the actions for the driver in the Cargo app. 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 Cargo app and on the Trips page.
Actions	The action level contains scheduled tasks that must be executed by the driver. After a scheduled action is started by the driver, the corresponding workflow is shown. Depending on the type of activity definition ID provided in the action, other parameters and levels can be specified.   An action can be visualized in the Schedule tab in the 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, which is linked to a single CMR (‘Convention relative au Contrat de Transport International de Marchandises par Route’, which translates to ‘Convention relating to the Contract for the International Carriage of Goods by Road’). 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 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 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.

Column	Description
	Trips : Opens the shortcut menu to expand or collapse legs Legs : Shows the legs of the selected trip Missions : Shows the missions of the selected leg 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 trip or actual driver
Trailer	Asset name of the scheduled trailer
Status	Trip status: Not started, In progress, Finished, Canceled   NOTE: The leg and mission status is also displayed
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 driver’s trip, leg, or mission
End time	End time of the trip, leg, and mission
End location	End location of the driver’s 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:

Use / buttons to expand or collapse trips/legs. Click to expand a trip/leg. Click to collapse a trip/leg.

If the side sheet is not enabled (see Sheet settings), you can click 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

Sheet settings #

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.

1. To view details of individual legs, from the upper-right corner of the Trips page, click Sheet Settings . The Show trip details sheet slider is displayed.
   
   
   
2. 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 actions 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 Sheet settings).

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 or mission are displayed on the Trip details sheet: the overall details of individual legs, such as the place of the mission, actions, actual start and end 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 in bold.

To reveal the next level, you can also click the icon corresponding to the action performed, for example, Load . The mission details for the selected level are displayed.

View trip feedback #

On the trip details sheet, in the action section, click Feedback. The feedback response is displayed.

NOTE:

The feedback button appears when you expand an action.

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.

ETA of the next stop #

ETA (estimated time of arrival) is a decision support system that simplifies and improves the way planners and dispatchers assign drivers continuously. ETA provides dispatchers with better visibility on the upcoming schedules of their resources as they can foresee possible changes.

Dispatchers can act to minimise disruptions by better activity scheduling and assigning appropriate resources to a incoming trip. For example, if a driver is not assigned to the next trip, the estimates can determine if the driver can be assigned a new trip within the system. Or, if a driver will not be arriving to the next trip on time, the dispatchers can reassign the upcoming trip to another driver.

Delays can happen due to driving and resting time or updates on traffic. ETA uses the data of the trip information, such as asset positions, drivers, tacho status, routing predictions, and traffic predictions to calculate the value. ETA also considers a list of other activities, such as load and unload, planned weekly rests, unavailability, and time windows.

If there is a deviation from the previous estimates, the customers, and the customers of customers are informed about the updated ETA estimates which leads to increased customer satisfaction.

ETA is continuously updated for the next stop of a scheduled trip. A dispatcher can view this information in the calculator inside the trip details side sheet on the Trips page.

<<When the driver starts his leg, the MaRoNa internal API is used to calculate the ETA of all the missions within that leg. The duration of each planned action is set to a default of 1h. The ETA is never updated.>>

<<In its first version it’s a stateless algorithm that fetches the drivers (and optionally the co-drivers) driving and resting times to calculate the ETA towards the next mission based on the current location (of the asset).>>

IMPORTANT

• Calculation of the ETA, including the driving and resting times, is done by using the orchestration API
• The ETA calculation is started:
  • For the first mission: As soon as the leg is started on a location different than the first mission location
  • For every next mission: As soon as the previous mission is marked as “finished”
• This ETA is recalculated every 5 minutes
• This ETA is no longer calculated as soon as the ‘next mission’ is ‘in progress’.
• <<The ETA is pushed towards the integrator by using a dedicated push message from the scheduled trips module>>

This is a representative image of the ETA details within the trip details side sheet.

To view more details of the ETA, click the clock icon. The details are displayed.

This table provides the descriptions about the information displayed for ETA.