Documentation Index

Fetch the complete documentation index at: https://documents.revenova.com/llms.txt

Use this file to discover all available pages before exploring further.

Deadhead Calculator

Prev Next

The Deadhead Calculator is a feature within the Fleet Management Console that assists in trip planning by calculating the distance a truck must travel without a load. Use this tool to optimize routes and reduce unnecessary mileage.

Enable the Deadhead Calculator

To use the Deadhead Calculator for Trip Planning, it must first be enabled in the TMS Admin Configuration settings for Fleet Management:

  1. Navigate to TMS Admin → Configuration.

  2. In the Fleet Management section, check the Show Deadhead Calculator field to enable the feature.

Using the Deadhead Calculator

Once enabled, the Deadhead Calculator button can be accessed in the Trip Planning section of the Fleet Management Console only for Fleet Load Views with the header expanded.

Ensure you have the Fleet Load View set up as intended, as this is necessary for the Deadhead Calculator to function properly. These header filters cannot be changed when the Deadhead Calculator section is visible.

Tip: Use the header filters in the Fleet Load view to display less than 100 records for improved performance when calculating the deadhead distance.

Fleet Management Console interface displaying the Fleet Load View in the Trip Planning section highlighting the Deadhead Calculator feature.

Configure the Calculator

Select the Deadhead Calculator button to open the Deadhead Calculator LWC.

Interface for calculating deadhead distance based on asset location and parameters.

In the LWC, configure the following settings:

Field

Values/Behavior

Description/Use

Calculate Deadhead From

The available values are the following:

  • Asset

  • Driver

  • Load

Default Value: Asset

The type of record to use for calculating the deadhead distance.

Use Asset or Driver to calculate the deadhead distance from a Fleet Asset or Driver to a pickup location.

Use Load to find backhaul opportunities by calculating the distance between loads.

Based On

When the Calculate Deadhead From field is set to Asset or Driver, the following values are available:

  • Asset Final Planned Location

  • Asset Current Location

  • Asset Last Stop Location

  • Driver Domicile

When the Calculate Deadhead From field is set to Load, this value is set to Load Destination and cannot be changed.

Default Value: Asset Final Planned Location

The Asset, Driver, or Load location to use when calculating the deadhead distance.

Use Asset Final Planned Location to use the end location of the latest planned trip for a Driver or a Fleet Asset.

Use Asset Current Location to use the latest geolocation of either a Driver or a Fleet Asset on an active Trip Plan.

Note: For calculating deadhead from a Driver, the selected Driver must have an active Driver Assignment record.

Use Asset Last Stop Location to use the end location of the last Trip Plan Leg of the dispatched Trip Plan Segment.

Use Driver Domicile to use the Driver’s assigned home location.

Note: For calculating deadhead from an Asset, the selected Fleet Asset must have an active Driver Assignment record.

Use Load Destination to use the Load’s last stop location.

Using Asset/Driver/Load

If the Link to View field is unchecked, this field is a lookup field to a Power Unit (Fleet Asset), Driver, or Load record based on the Calculate Deadhead From value.

If the Link to View field is checked, this field is a picklist field to a Fleet Asset, Driver, or Load record based on the value of the From View field.

Default Behavior: Using Asset lookup field

The selected Asset, Driver, or Load record to use for the deadhead calculation.

Note: If this field is a lookup, it will only lookup Power Units instead of all Fleet Assets. To calculate the deadhead distance for any Fleet Asset, check the Link to View field to turn this field to a picklist.

Link to View

Check to change the Using Asset/Driver/Load field from a lookup to a picklist field type and show the From View picklist field to select a different Fleet View.

Default Value: Unchecked

Warning: Clear the value in the Using Asset/Driver/Load field before checking this field. Otherwise, the From View field cannot be changed from None.

Check this field to use an Asset, Driver, or Load record based on a visible Fleet Management Console view.

From View

This field only shows when the Link to View field is checked.

The values for this field depend on the Calculate Deadhead From value selected and which views are actively shown in the Fleet Management Console LWC:

  • Asset: Fleet Asset View Type

  • Driver: Fleet Driver View Type

  • Load: Fleet Load View Type

The Using Asset/Driver/Load field displays records that respect the filters saved on the selected view.

Default Behavior: Hidden

The Fleet Management Console view to use when selecting which Asset, Driver, or Load record to use. Select the View Manager to choose a view.

Note: The current Fleet Load view that is using the Deadhead Calculator cannot be selected in this list.

Showing Results In

The available values are the following:

  • Miles

  • Kilometers

Default Value: Miles

Calculate and display the unit of measurement of the deadhead calculation.

Calculate Distance

The Calculate Distance button becomes available when an Account or location information is found based on the configuration. Click the button to compute the deadhead distance.

The distance is measured from the Asset/Driver/Load’s location to the Load record's origin location in the list.

Note: A location must be identified in the Deadhead Calculator under the Based On field. Otherwise, “No Location Found” displays in red text and the Calculate Distance button is greyed out.

The calculations appear next to the Load in the list of Load records when the grid is expanded, and are sorted from shortest to longest in deadhead distance.

Click the Deadhead Calculator button again to hide the LWC. When the Deadhead Calculator is hidden, the Deadhead Miles/Kilometers column is removed from the list.

Fleet Management Console displaying deadhead calculations and Load record details.

Based On Location Flowcharts

Expand the appropriate Calculate Deadhead From option for the Based On field to display the flowchart in determining the location that is used in the Deadhead Calculator LWC.

Warning: If the Shipping Address field is blank on the Account for a location in the LWC, and then the Calculate Distance button is clicked, an error will populate stating that the origin location is invalid or missing. The Shipping Address field on the Account must have at least the following values:

  • Shipping Country

  • Shipping City and Shipping State/Province OR Shipping Zip/Postal Code

Asset Final Planned Location

Use this option to find the latest planned end location of a Fleet Asset or Driver across ALL active Trip Plans.

Caution: If the Appointment Date on the last Trip Plan Leg is blank, the Due Out date is used instead. If both fields are blank, then “No Location Found” is displayed under the Based On field in the Deadhead Calculator LWC.

The following flowcharts assumes the the last Trip Plan Leg records have a value in the End Date/Time field. The actual value used for comparison is the Calculated Fallback Datetime field.

Calculate Deadhead From: Asset

Power Unit vs. Fleet Asset Note: If the Fleet Asset record selected in the Using Asset field is a Power Unit, it uses the latest Trip Plan Leg of the last planned Trip Plan Segment.

If the Fleet Asset record is not a Power Unit (such as a Trailer), it uses the latest planned Trip Plan Leg where the Trip Plan Leg Asset is the record selected in the Using Asset field.

Flowchart detailing steps to find the latest Trip Plan Leg for Fleet Asset.

Calculate Deadhead From: Driver

Flowchart illustrating steps to find the latest Trip Plan Leg for a Driver.

Asset Current Location

Use this option to use the current location of a Fleet Asset or Driver (with a Driver Assignment).

Calculate Deadhead From: Asset

Flowchart illustrating steps to retrieve Fleet Asset geolocation data for the current location

Calculate Deadhead From: Driver

Warning: This option requires the Driver to have an active Driver Assignment, where the Start Date is any time before now, and if there is an End Date, it hasn’t surpased that date and time.

Flowchart illustrating driver assignment and geolocation process with decision points.

Asset Last Stop Location

Use this option to find the end location of a Power Unit or Driver in a Dispatched Trip Plan Segment.

Calculate Deadhead From: Asset

Power Unit vs. Fleet Asset Note: If the Fleet Asset record selected in the Using Asset field is a Power Unit, it uses the latest Trip Plan Leg of the dispatched Trip Plan Segment with that Tractor or Box Truck.

If the Fleet Asset record is not a Power Unit or the Trip Plan Segment is not dispatched, then No Location Found is displayed.

Flowchart illustrating steps to find last dispatched trip plan leg for the power unit.

Calculate Deadhead From: Driver

Flowchart illustrating steps to find the last dispatched trip plan leg for a driver.

Driver Domicile

Use this option to use the driver domicile location of a Fleet Asset (with a Driver Assignment) or Driver.

Calculate Deadhead From: Asset

Warning: This option requires the Fleet Asset to have an active Driver Assignment, where the Start Date is any time before now, and if there is an End Date, it hasn’t surpased that date and time.

Flowchart illustrating driver assignment process and location lookup steps.

Calculate Deadhead From: Driver

Flowchart illustrating driver record retrieval and address lookup process steps.

Search for Backhaul Opportunities

The Deadhead Calculator can also be used to find backhaul opportunities by searching lanes for specific routes. Enter the Origin and/or Destination Address along with a Radius and its Units to find potential loads for the return trip.

Set the Calculate Deadhead From field to Load and select a Load record in the Using Load field to search for these opportunities. Then, click the Calculate Distance button in the Deadhead Calculator LWC.

Caution: If the Load Destination has changed after selecting the Load record, you must close the calculator and refresh the Fleet Load View to have the updated location displayed under the Based On field and have the correct calculated distance in the grid/list of Load records.

The list of Load records is sorted from shortest to longest in deadhead distance.

Fleet Management Console displaying Deadhead Calculator and load details for backhaul opportunities.

Load Destination Logic

Use the following flowchart to determine the Load Destination location of a Load record in the Deadhead Calculator LWC:

Flowchart detailing steps for verifying location and geolocation fields in records.

If the Location field has a value, the location displays in the LWC with the format {Account Name}: City, State Abbreviation.

Deadhead calculator interface showing location name for Denver Deli Meats in Denver, Colorado.

Geolocation Stops

If the Location field for the Last Stop is blank, the location is determined from the Geolocation field's latitude and longitude, and the coordinates are reverse-geolocated. The location displays in the LWC with the format City, State Abbreviation.

Deadhead calculator interface showing Chicago, IL as the load destination option.

If the Stop does not have either a Location Account or Geolocation coordinates, then the City and State/Province or Postal Code fields are used for the location.

City/State/Postal Code Stops

If the City and State/Province field combination is used, then the location displays in the LWC with the format City, State Abbreviation, just like the Gelocation match.

If the Stop only uses the Postal Code field, then the location displays in the format Latitude, Longitude.

Deadhead calculator displaying load destination coordinates for route planning.

Missing Stop Information

If the Last Stop does not contain any location information, then an error message displays stating that the selected Load record needs values in the City and State/Province or Postal Code fields.

Error message indicating missing city and state information for the Deadhead Calculator.