Automatic Detentions

Modified on Tue, 21 Nov, 2023 at 8:14 AM

In logistics and transportation, detention management is a crucial but often challenging task. To address this issue, we offer an automatic detentions functionality.


This is how it works: 

  • Automated Detention Status Checks:
    The system will check every load to identify whether there is upcoming, ongoing, or completed detention.


  • Efficient Communication through Email Notifications:
    Depending on the identified detention status, the system generates a series of email notifications. These notifications are directed towards fleet managers, accounting departments, and customers, ensuring everyone is well-informed.
  • First Email (30 Minutes Before Detention):

    The first email notification is dispatched 30 minutes before the detention is set to begin. This proactive notification allows stakeholders to prepare for potential delays and make necessary adjustments.
    Please note that the time frame can be changed according to your needs in the Automatic Detentions settings.


    Email example:


  • Second Email (At the Start of Detention):

    The second email notification is sent precisely as the detention period commences, ensuring that all relevant parties are immediately informed.


  • Email example:

  • Third Email (Short-Term Detention - Up to 30 Minutes):

    In cases where a brief detention is expected (up to 30 minutes), a third email notification is triggered.


  • Email example:


  • Fourth Email (After Completion/End of Detention):

    The final email notification is sent after the detention period ends.


  • Email example:


  • All email notifications for detentions will be logged in Logs section in the load page:

  • Seamless Load Status Updates:
    Alongside email notifications, the workflow simplifies load management by updating the load status to "Delivered-Pending" following the delivery of cargo with detention features.
    Information about automatic change of load status will be visible in Logs section in the load page:



Logic of time calculation is based on the following examples of open and set time of appointments:





*Tolerance time limit: If the driver is up to 10 minutes late for the appointment, we will still consider the load for the detention process and send a Detention Started email notification. However, the email notification should still indicate that the detention time is [Time In] - 10 minutes.

Additionally, there are three columns available in the All Loads page that are related to automatic detentions: 

Detention, Detention duration and Paid detention amount.



Information about specific customer's detentions can be found by visiting their profile and opening the Overview tab.



To enable or disable automatic detentions and manage them, please open the Automatic Detentions settings. You can enable or disable automatic notifications in general, select which detention notifications you need, specify the upcoming detention notification time before the detention beginning time, and set the detention start delay time.


Please note that a prerequisite for using the automatic detention functionality is Samsara.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article