---
title: "CONFIGURATION - Calculated Activity Duration Rules - What, Why & How."
description: "Configure rule-based stop activity durations that automatically scale with cargo volume and operational context, replacing fixed durations for more accurate ETAs and route planning."
url: https://help.qargo.com/en/articles/629123-configuration-calculated-activity-duration-rules-what-why-how
locale: en
updated: 2026-04-07
---

# CONFIGURATION - Calculated Activity Duration Rules - What, Why & How.

## Summary {#h_37b03fe618}

-   **What?**

    -   A rules-based feature that dynamically calculates stop activity durations based on cargo characteristics and operational conditions
    -   Configured under **Configuration _> Rules_**, following the same pattern as other rule types in Qargo
-   **Why?**

    -   Fixed stop durations do not scale with cargo volume or transport context, leading to inaccurate route ETAs
    -   Planners were performing manual updates to duration values — a time-consuming and error-prone process
-   **How?**

    -   Create **_Stop Duration rules_** that define either a flat time (fixed) or a per-unit formula (e.g. 5 minutes per pallet)
    -   Scope rules with conditions such as transport service, vehicle category, customer, or activity label
    -   Durations recalculate automatically on each route calculation trigger

* * *

## Terminology {#h_aabd22f066}

| **Term** | **Definition** |
| --- | --- |
| _Stop Activity_ | The action performed at a stop, such as Collection, Delivery, or Depot Unload |
| _Stop Activity Group_ | All stop activities at the same location within a route — duration is calculated based on the combined goods workload across the group |
| _Stop Duration_ | The time a vehicle spends at a stop, used by the planning engine for ETAs and route optimisation |
| _Fixed Rule_ | A duration rule applying a flat time value to a matched stop activity, regardless of cargo volume |
| _Formula Rule_ | A duration rule calculating stop time dynamically based on a goods metric (e.g. pallets, loading meters, weight) |
| _Calculation Collection_ | One or more calculations combined to produce a final stop duration (e.g. a fixed base time plus a per-pallet formula) |
| _Goods Metric_ | A measurable cargo characteristic used in a formula rule, such as pallet count, loading meters, or weight |
| _Condition_ | A filter applied to a rule that restricts when it applies — for example, only for a specific transport service, vehicle category, or customer |

* * *

## Overview {#h_2a4873d879}

**Stop activity durations** tell the planning engine how long a vehicle spends at each stop; previously, configured as fixed values per activity type under **Configuration _> Order Input_.**

-   Calculated Activity Duration Rules feature introduces a more powerful approach: rule-based duration calculation under **Configuration _> Rules_**, allowing durations to scale dynamically with cargo volume and operational context.

### Duration Priority Order {#h_0a6abd3266}

When a stop duration is determined, the system applies the following priority order:

1.  **Location-specific duration** — a duration configured directly on the location in _Locations > Locations_ always takes precedence
2.  **Calculated Activity Duration Rule** — if a matching rule is found under _Configuration > Rules > Stop Duration_, it is applied
3.  **Activity default** — if no rule matches, the value configured per activity type under _Configuration > Order Input: Stop options > Activities_ is used as a fallback

:::callout{tone="note"}
🧰 **Internal stop default change:** Internal stops (e.g. depots, parking locations) without an explicitly configured duration now default to **01:00** instead of 00:00. To keep a 0-minute duration on an internal stop, this must be set explicitly on the stop action in **_Locations > Internal stop actions_**.
:::

* * *

## Configuring Stop Duration Rules {#h_42d7945d30}

-   **NAVIGATE** to **Configuration** _> Rules_.
-   **SELECT** _Stop Duration_ from the left-hand side menu to open the rule list.

![](https://help.qargo.com/media/bc53bcb9c817-image.png)

-   **CLICK** _Add item_ to create a new stop duration rule.
-   **NAME** the rule for easy identification — for example, _"Pallets – Groupage"_ or _"Fixed – General Haulage"_.

## Select the Rule Type {#h_62bfb22e52}

Two rule types are available:

-   **Fixed** — applies a flat time value to the matched stop activity. Suitable when stop time is consistent regardless of cargo volume.
-   **Formula** — calculates stop duration dynamically based on a goods metric. Suitable when stop time should scale with the amount of cargo being loaded or unloaded.

![](https://help.qargo.com/media/c33b674689e2-image.png)

### Configure a Fixed Rule {#h_280e7c81b1}

-   **SELECT** _Fixed_ as the rule type.
-   **ENTER** the duration value (hours and minutes) to apply to matching stops.

![](https://help.qargo.com/media/d14701de962d-image.png)

### Configure a Formula Rule {#h_cea0a623e7}

-   **SELECT** _Formula_ as the rule type.
-   **SELECT** the goods metric to calculate against — available options include pallet count, loading meters, weight, and volume.
-   **ENTER** the time value per unit (for example, _5 minutes per pallet_).

![](https://help.qargo.com/media/a58cc8cb6e26-image.png)

-   Multiple calculations (optional) can be combined within a single rule to form a _Calculation Collection_. For example, a base loading time of 15 minutes plus 5 minutes per pallet.
-   **CLICK** _Add calculation_ to add further steps to the same rule.

:::callout{tone="info"}
📚 Rules can be scoped to specific stop activity types — for example, _Collection_ or _Delivery_. If no activity type is set, the rule applies across all activity types.\
A single rule cannot combine an activity type condition with an internal stop type condition. Where both scenarios require coverage, create two separate rules.
:::

### Add Conditions (Optional) {#h_835e7fbb74}

Conditions restrict when a rule applies, allowing different durations for different operational contexts. The following condition types are available:

-   Transport service
-   Vehicle category
-   Customer
-   Container type
-   Service level
-   Stop action
-   Stop activity label
-   Location
-   Goods-related metrics (e.g. quantity, loading meters)

**CLICK** _Add condition_\
**SELECT** the relevant metric, operator, and value

::video{src="/media/video/0110b6dbaef4-2026-04-06_18-18-33-1-.mp4"}

:::callout{tone="info"}
📚 Rules are evaluated in the order they appear in the rule list. The **first matching rule** is applied. To adjust priority, **DRAG** rules to reorder them.
:::

* * *

## Calculation Behaviour {#h_f784290537}

Stop durations are recalculated on **each route calculation trigger**. The following actions trigger a recalculation:

-   Adding or removing a stop from a route
-   Reordering stops on a route
-   Updating consignment goods data (e.g. changing pallet count)

Duration is calculated at the **stop activity group** level. This means the system sums goods data across all consignments sharing the same stop location. For example, if three consignments are collected at the same warehouse, the system combines their pallet counts to determine the total stop duration.

![](https://help.qargo.com/media/9e54dd9a1065-image.png)

:::callout{tone="note"}
‼️ Changes to certain order-level condition fields (such as transport service or customer) do not immediately trigger a duration recalculation. The updated duration will be applied on the next route recalculation — for example, when a stop is next added, removed, or reordered.
:::

### Additional Use Case Examples {#h_67a27a6eb0}

-   **Multi-service operations**: A transport company running both FTL and pallet-network services configures a fixed 45-minute rule for FTL deliveries and a formula rule of 8 minutes per pallet for pallet-network deliveries. Durations are applied automatically based on the transport service on each order.
-   **Customer-specific loading times**: A logistics provider creates a condition-based rule scoped to a specific customer whose depot consistently requires longer handling time, improving ETA accuracy for that customer's orders.
-   **Vehicle category differentiation**: A carrier sets distinct durations for vans (shorter) versus articulated lorries (longer) at the same stop type, reflecting real-world differences in handling time per vehicle category.

* * *

## Troubleshooting {#h_38d060d7c7}

| **Issue** | **Likely Cause** | **Resolution** |
| --- | --- | --- |
| Duration not updating after changing goods data | Route recalculation may not have fired | Add or remove a stop to trigger a new route calculation |
| Wrong rule being applied | A higher-priority rule is matching first | Review rule order in _Configuration > Rules > Stop Duration_ and drag rules to reorder |
| Rule not applying at all | Conditions on the rule do not match the order context | Verify that the rule's conditions (transport service, vehicle, activity type) match the order being planned |
| Stop showing 00:00 duration unexpectedly | Internal stop defaults have changed | If 0 minutes is required, configure this explicitly on the stop action in _Locations > Internal stop actions_ |
| Need to cover both activity type and internal stop type in one rule | This combination is not supported in a single rule | Create two separate rules — one scoped to the activity type and one to the internal stop type |
| Duration recalculation not reflecting a condition change | Order-level condition changes do not trigger recalculation | The updated duration will apply on the next route recalculation |


## Related articles

- [CONFIGURATION - Use rules to auto-assign fields.](https://help.qargo.com/en/articles/545498-configuration-use-rules-to-auto-assign-fields.md)
- [What is the difference between the time window and stop duration on my order?](https://help.qargo.com/en/articles/133867-what-is-the-difference-between-the-time-window-and-stop-duration-on-my-order.md)
- [PLANNING - Using Planning groups](https://help.qargo.com/en/articles/133863-planning-using-planning-groups.md)
- [RATES - Chargeable weight conversions - Add Conditions](https://help.qargo.com/en/articles/567376-rates-chargeable-weight-conversions-add-conditions.md)
- [RATE CARD - Waiting Time Configuration](https://help.qargo.com/en/articles/153215-rate-card-waiting-time-configuration.md)
