Autopilot: Automatically apply a Dwell time exceeded exception to a shipment

The Dwell time exceeded exception is intended to flag shipments where a departure update is missing after the expected dwell time has passed. 

If the shipment is not marked as Picked up / Delivered after the expected or actual dwell time has passed for a pickup/delivery stop, the Autopilot rule described in this article can add the Dwell time exceeded exception to the shipment automatically.

Autopilot rule creation logic

Turvo’s Autopilot rules feature uses When/If/And/Then statements to dictate the action that takes place. See our Autopilot: Understanding rule creation logic article to learn more about the basic rule logic used in Turvo and how to access the Create shipment rule or Create order rule modals that are used to create an Autopilot rule.

Creating a Dwell time exceeded exception rule

To create a Dwell time exceeded exception rule, in the Admin Console > Rules > Shipment > Autopilot section:

  1. Click +Create rule. The Create shipment rule modal appears
    1. Note: See our Autopilot: Understanding rule creation logic article to learn how to access the section.

  1. Enter a Rule name and select A departure update is missing after expected dwell time at the stop in the When drop-down. The modal updates to show options for creating a Dwell time exceeded exception rule.
  2. There are no required If statements for the Dwell time exceeded exception rule. If desired, you can skip down to the Actions section immediately.
    1. If no additional criteria are added, Turvo applies the Dwell time exceeded exception to any shipment immediately once the expected dwell time is passed.
  3. Click the +Add criteria button to create And statements, which narrow the scope of the rule for more specific situations. Use the drop-down to select the And statement you want to add, and click +Add criteria to add more criteria to the rule. Select from the criteria options listed in the table below:
Criteria Name Is/Is Not Toggle? Single select or Select all Description
Customer Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to stops for shipments that include or exclude the indicated customer(s).
Stop type No Single select Use the drop-down to select a type of stop on the shipment that the rule applies to. Select from Pickup, Transload, Port of Landing, Transshipment Port, Port of discharge, Recovery, Storage, Delivery, or Termination.
Location Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to stops at the specified location(s) or that it should apply to all stops except for the specified location(s).
Mode Yes Select all that apply Use the drop-down and the Is/Is not toggle to indicate the rule should only apply to stops on shipment route segments with the selected mode(s) or should apply to all stops except for those on shipment route segments with the selected mode(s).
Visibility Group Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to stops for shipments that are or are not assigned to the selected Visibility group(s).
Carrier Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to stops for shipments that are or are not assigned to the selected Carrier(s).
Origin Location Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to original pickup stops for shipments that are or are not in the selected locations.
Destination Location Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to final delivery stops for shipments that are or are not in the selected locations.
Tag Yes Select all that apply Use the text field and the Is/Is not toggle to indicate the rule should only apply to stops on shipments that do or do not have the selected tag(s) assigned to them.

Note: The drop-down automatically fills in with an unused criteria each time you click +Add criteria. The button disappears once all criteria are added to the rule.

  1. Once you apply your additional criteria, go to the Actions section at the bottom of the modal.
    1. The Action for this rule is always Create exception: Dwell time exceeded.

  1. Use the Share to Customer and Share to Carrier toggles to indicate whether the exception should be shared to the affected shipment customers’ or carriers’ tenants, if they have a tenant in your Turvo network.
    1. If the toggle is grey, it is in the Off position and the exception is not shared. If it is blue, it is in the On position.
  2. Use the Default owner drop-down to indicate whether the exception should be assigned to your own organization (My Company), the Customer, or the Carrier for the shipment stop.
  3. Once you finish making your selections, click Save.

Manually creating or resolving a Dwell time exceeded exception

You can manually create or resolve the Dwell time exceeded exception from the shipment’s Fast Action Button (FAB) menu. See our Understanding the Fast Action Button (FAB) article to learn more about using the FAB.

  • When creating the Dwell time exceeded exception in the FAB, the Location field is required. Use the drop-down to select the stop where the dwell time was exceeded.
  • When resolving the exception, the Reason field must be filled in. Use the drop-down to select from available reasons.
    • Available reasons can be customized for each exception type using the Exception to Reason Code & EDI Codes table in Admin Console > Settings > Shipments. See our article on Mapping reason codes to shipment exception types to learn more about customizing reasons.

You can also resolve the exception manually from the Workbench. See our article Manage exceptions with Workbench to learn more.

Tips & Further reading:

  • Use the Exceptions filter in the Shipments page to filter for shipments with a Dwell time exceeded exception.
  • You can use Turvo’s User Notifications feature to set up notifications for your account when a Dwell time exceeded exception is added to a shipment. 

Was this article helpful?

0 out of 0 found this helpful