Skip to main content
Qargo

CONFIGURATION - Use rules to auto-assign fields.

Automate field values and extras on orders, stops, consignments and cargo with auto-assign rules. Rules can add stop and cargo extras and can overwrite existing field values.

Table of contents
  1. Introduction
  2. Terminology
  3. Create a Rule
  4. Using Rules
  5. Auto-assign Order Transport Network
  6. Enable Overwrite on a Rule
  7. Limitations
  8. Auto-assign Stop and Cargo Extras
  9. Do not dispatch: set it automatically with an AI-based stop rule
  10. Troubleshooting
  11. Additional Tips

Introduction

The Auto-Assign feature automatically fills in field values across orders, consignments, and stops based on configurable rules.
This helps to:

  • Standardise data
  • Speed up planning
  • Reduce manual data entry.

This feature’s flexibility allows it to be used for various applications, such as routing decisions, customer references, region codes, and planning guides. Define rules once, and the system will consistently apply them to new or updated items.

Terminology

Term Definition
Rule A set of conditions and resulting field values. Rules determine which fields are automatically populated and when.
Configuration > Rules The central area where you create, manage, and organise auto-assign rules.
Field Any data item on an order, consignment, stop or cargo line that can be populated (e.g., customer reference, region code, vehicle category, extras).
Default Field A standard field provided by the system that can be auto-filled.
Custom Field A user-defined field that can also be auto-filled via rules.
Trigger An event that causes rule evaluation, such as creating a new order, consignment, or stop.
Planning Group A grouping used to organise planning resources and rules for easier management.
Resource People or assets (e.g., drivers, vehicles, departments) that can be assigned or referenced in rules.
Asynchronous Operations that occur in the background after the initial creation, allowing the main workflow to continue without waiting for the rule evaluation.
Synchronous Operations that run immediately in the same process, potentially delaying the initial action until rule evaluation completes.
Extra An additional service or item added to a stop or cargo line, such as taillift, cleaning or ADR handling. Extras can trigger charges on the rate card.
Stop extra An extra that belongs to a stop. Configured under RATES > Order Input, with a setting for which stop types it applies to (Collect, Delivery, Other Stops).
Cargo extra An extra that belongs to a cargo line (good) on an order. Configured under RATES > Order Input.
Cargo fields The auto-assign category used to create rules that add cargo extras.
Do not dispatch A stop setting. Qargo keeps the stop on the trip but does not send it to the driver app or fleet system.

Create a Rule

  • Navigate to CONFIGURATION > Rules.

  • From the ‘Auto-assign’ side menu:

  • Select the field to create the rule on

  • Options include:

    • Consignment fields: default & custom fields associated to consignment

    • Order fields: default & custom fields associate to the order

    • Order transport network: will show networks active on the tenant

    • Stop fields: default and custom fields associated to the stop

    • Cargo fields: extras associated to the cargo (goods) on an order. This category only shows when cargo extras are configured on the account.

    • Trip resource assignment: assign internal & external resources

  • Click ‘Add item’ to start to build a Rule

    • If adding multiple rules, name the rule for easy identification by clicking on ‘Rule 1’ and adding the name.
  • Complete the displayed fields:

    • Field: From the drop down, select which field to populate automatically (e.g., customer reference, region code, postcode zone, vehicle category)

      • Options displayed here directly relate to the active default and custom field on the property
    • Value: Define the value to populate for the selected field. Options displayed will depend on the Field selected

  • Conditions: Define when the rule should run (for example, on creation, or when a specific field is set).

    • Calculation method: Multiple simple rules can run in sequence, or use complex rules (Excel table) to build a specific set of criteria for the conditions to apply to.
    • Metrics / Operator / Value: Select the condition parameters that will apply in order to auto-assign the field.
  • Save the rule.


Using Rules

  • When a new order, consignment, stop or cargo line is created, the system checks the rules that apply to it.
  • Stop fields rules now also run for stops added to an existing order or shipment, not only for stops created together with a new shipment.
  • If a field requires information that is not yet available, the rule can wait for a subsequent input or run asynchronously, depending on the rule’s configuration.

Use case: Orders - Tag an order for zone visibility


Auto-assign Order Transport Network

This can be used when users are members of a Transport Network, or have their own network setup. Auto-assign rules can be used to configure conditions where the transport network is automatically assigned.

  • Set up in the same way as the order, stop and consignment data fields.

  • Navigate to CONFIGURATION > Rules

  • From the side menu ‘Auto-assign’, select ‘Order transport network’

  • Select the transport network from the dropdown

  • Set the conditions that will apply for the transport network to be auto-assigned.

    • Options available will depend on the metrics selected

In the example below, the transport network configured will be pre-filled if the order is created and assigned to the Groupage department; which is also set to be auto-assigned when an order quantity is less than 5 units ordered.


Other Auto-assign options

  • Department rules can be created to automatically allocate an order to a department based on set conditions.

  • Add Resource groups to organise planning boards; easily filter, customise and improve planning and pre-planning visibility.

    • To learn more about Resource groups 👉 Click HERE

Use Planning Groups rules to simplify allocating orders to specific planning groups.

  • To learn more about Planning groups 👉 Click HERE

Enable Overwrite on a Rule

  • NAVIGATE to CONFIGURATION → Rules.

  • SELECT the field type from the Auto-assign side menu (consignment fields, order fields and stop fields).

  • OPEN an existing rule, or CLICK Add item to create a new rule.

  • LOCATE the Overwrite existing values toggle within the rule configuration panel.

  • TOGGLE the switch:

    • Toggle OFF (default) - the rule skips any field that already contains a value. Existing data is preserved.
    • Toggle ON - the rule replaces the existing field value when the configured condition is met on a create or update event.
  • SAVE the rule.

Limitations

  • The toggle is configured per rule. There is no global switch to enable overwriting across all rules at once, and no bulk action to toggle multiple existing rules in one step.
  • Overwriting is on-trigger only - the rule replaces the field value at the moment the configured condition is met (during a create or update event). Previously existing records are not retroactively updated; an edit or re-trigger of the affected record is required for the new behaviour to apply.

Auto-assign Stop and Cargo Extras

Auto-assign rules can now add extras, not just field values. Extras such as taillift, cleaning, customs handling or ADR handling no longer need to be ticked by hand on every stop or cargo line. When a stop or cargo line matches the rule conditions, the chosen extras are added automatically. This saves time and helps make sure the rate card always picks up the charge.

  • Stop extras are set up in the Stop fields category.
  • Cargo extras are set up in the new Cargo fields category.
  • Order fields and Consignment fields do not offer extras.

Use Cases

  • Product-based stop extra: a liquid bulk transport company with a large product catalogue needs a fixed stop extra (for example Baffled) every time a specific product is transported. A stop extras rule with a condition on the cargo product removes the need to add it by hand on each order.
  • Surcharge by area: a pallet network member needs a surcharge stop extra on deliveries to certain postcodes. A stop extras rule with a postcode condition adds the surcharge automatically.
  • Customer-specific extras: a delivery to a specific customer always needs a taillift. A stop extras rule with a customer condition and a Delivery stop type adds Taillift to every matching delivery.
  • Existing auto-assign users: companies that already rely on auto-assign rules for fields can now manage their recurring extras in the same place.

Create a Stop Extras Rule

  1. NAVIGATE to CONFIGURATION > Rules.
  2. SELECT Stop fields from the Auto-assign side menu.
  3. CLICK Add rule to create a new rule, or OPEN an existing rule.
  4. NAME the rule for easy identification (for example “Taillift - Customer X deliveries”).
  5. SELECT Extras from the Field dropdown.
  6. SELECT one or more stop extras from the Value multi-select list.
  7. SET the Conditions in the same way as any other rule (for example a customer, a product on the cargo, or the stop type).
  8. SAVE the rule.

Create a Cargo Extras Rule

  1. NAVIGATE to CONFIGURATION > Rules.
  2. SELECT Cargo fields from the Auto-assign side menu.
  3. CLICK Add item to create a new rule, or OPEN an existing rule.
  4. NAME the rule for easy identification.
  5. SELECT Extras from the Field dropdown.
  6. SELECT one or more cargo extras from the Value multi-select list.
  7. SET the Conditions for the rule.
  8. SAVE the rule.

When Extras Rules Run

  • Stop extras rules run when a stop is created. This includes stops added to an existing order or shipment, not only stops created with a new order.
  • Cargo extras rules run when a cargo line (good) is created. The extra is added to that cargo line only. Other cargo lines on the same order are not changed.
  • The Conditions, Calculation method and Metrics work the same way as for regular field rules.

What Happens on the Order

  • Extras added by a rule behave exactly like extras added by hand. They show on the stop or cargo line, feed into rate cards and invoicing, and count towards resource compatibility.
  • Extras are never duplicated. If the extra is already on the stop or cargo line, the rule skips it.
  • When several rules match the same stop or cargo line, all of their extras are added together. This is different from regular fields, where only one rule’s value is used.

Limitations - Extras

  • Rules only add extras. The Overwrite existing values toggle does not apply to extras. A rule never removes or replaces an extra that is already on the stop or cargo line.
  • Adding cargo later does not re-run stop rules. If cargo is added to an existing consignment, the stop extras rules for that consignment are not checked again. A rule such as “heavy cargo adds a forklift stop extra” only works when the cargo is already on the order at the moment the stop is created.
  • Internal stop type is not available as a condition. Adding an extra based on an internal stop type (for example a customs or cleaning stop) is not supported with these rules yet.
  • Rules do not add stops. Extras rules add extras to stops that already exist. They do not create new stops.
  • Existing records are not updated. Rules only run on new stops and cargo lines. Stops and cargo created before the rule was saved do not get the extra.
  • Only stop and cargo extras. Other items, such as incidents, cannot be added with auto-assign rules.

Do not dispatch: set it automatically with an AI-based stop rule

An AI-based rule under Stop fields can set Do not dispatch on a stop, based on the stop’s activity. Qargo keeps those stops on the trip but does not send them to the driver app or fleet system.

Prerequisites

Qargo Intelligence must be enabled; the AI-based rule type only shows when Qi is active.

Create a Do not dispatch rule

  1. NAVIGATE to CONFIGURATION > Rules.
  2. SELECT Stop fields from the Auto-assign side menu.
  3. CLICK Add rule and choose AI-based.
  4. ENTER the rule in plain words into ‘Qargo AI Rules Agent’ chat, for example “When a new stop’s activity is End of day, do not dispatch it”.
  5. Review the rule and CLICK Validate rule, then Save rule.
  6. SAVE the rule panel.

How it works

  • When it runs: on every new stop. That covers Create order, order import, the API, and stops added with Edit order or Add stop.
  • Existing stops: editing a stop does not run the rule again. A new or changed rule does not update stops that already exist.
  • Manual rules: they cannot set Do not dispatch. Only AI-based rules can.
  • Switch back: the planner can still dispatch an excluded stop from the planning board, with Do not dispatch > This stop.


Troubleshooting

Issue Resolution
Field Not Auto-Populated Check that the rule is configured for the correct scope (order, consignment, trip, stop).\
Verify that the rule’s trigger is set to run at the appropriate time (creation vs. update).\
Ensure there are no conflicting rules that overwrite the value after it is set.
Incorrect Values Review the rule’s Value definitions and any dependencies on other fields.\
Confirm that the rule’s conditions match the actual data context.
Rule Not Triggering Confirm that the rule is enabled\
Check whether the rule relies on data that isn’t available at creation time.
Data Inconsistency after Updates If a field is overwritten by a later rule, adjust the rule priorities or add additional conditions to prevent unintended overwrites.
Field value not overwritten despite toggle ON Confirm the rule’s trigger condition is being met on the record.\
Verify the rule scope matches the entity type (order, consignment, or stop).\
Check whether a later rule is resetting the field to a previous value.
Field remains empty after rule runs with toggle ON Rules run on create/update events — the rule may not have fired yet.\
Re-save or re-trigger the affected record to evaluate the rule.
Unexpected values on existing records Rules with toggle ON do not retroactively update existing records.\
Only records created or edited after the toggle was enabled will reflect the overwrite behaviour.
Extras not shown in the Field dropdown Extras are only offered in Stop fields and Cargo fields, not in Order fields or Consignment fields.
Cargo fields category not visible The category only shows when cargo extras are configured. Add cargo extras under RATES > Order Input first.
Stop fields category not visible The category only shows when stop fields are available on the account. Contact the Qargo Account Manager for help.
Extra not listed in the Value picker Check that the extra exists under RATES > Order Input and is not archived.
Stop extra not added to a stop Check the extra’s Collect, Delivery and Other Stops setting allows that stop type. - Check the rule conditions match the stop. - Check the stop was created after the rule was saved.
Stop extra not added after cargo was added to an order Adding cargo later does not re-run stop rules. The cargo must be on the order when the stop is created.
Existing extra not replaced or removed by a rule Expected behaviour. Rules only add extras, and the Overwrite existing values toggle does not apply to extras.
More extras than expected on a stop or cargo line Several rules matched. Extras from all matching rules are added together. Review conditions on overlapping rules.
Cargo extra added to the wrong cargo lines Cargo extras have no stop type setting, so the rule conditions alone decide. Make the conditions more specific.
Do not dispatch not offered in a Manual rule Only AI-based rules can set Do not dispatch. Create the rule with the AI-based rule type.
Existing stops not excluded after saving the rule Rules only run on new stops. Exclude existing stops on the planning board with Do not dispatch.

Additional Tips

  • Start with a small set of high-impact rules and expand gradually to avoid complex interdependencies.
  • Document each rule with a short description of its purpose and the fields it affects.
  • Use a standard naming convention for rules to make discovery easy (e.g., “Route_Zones_AutoFill” or “CustomerRefs_Defaults”).
  • Regularly review and retire rules that are no longer needed or have been superseded by new configurations.

The Auto-Assign feature simplifies data management by automatically populating key fields according to well-defined rules. Streamline workflow, reduce manual data entry, and improve consistency across trips, orders, consignments, and stops.