My Orders are Not grouping

In Dispatch Science, driver run order grouping relies on several key settings to ensure compatibility between orders. If your orders are not grouping, review the checklist below to identify potential configuration issues.

Requirements for Order Grouping

For orders to be grouped for a driver’s run, they must meet the following criteria:

1. Order Profile Grouping Settings

   • Orders must share the same Order Profile settings that support grouping.

2. Allow Grouping from Different Accounts

   • In the Order Profile, the setting "Allow to group orders from different accounts" must be enabled.

3. Reference Fields Configuration

   • Ensure none of the reference fields are set to "Updatable by the driver".

4. Matching Workflows and Steps

   • Orders must use the same Workflow and have the same Workflow Steps selected.

5. No COD Configuration

   • Orders with Cash on Delivery (COD) options will not be grouped.

6. No Identity Requirement

   • If the "Require Identity" step is enabled in the workflow, grouping will be disabled.

7. Overlapping Time Windows

   • Pickup windows must overlap for pickups.

   • Delivery windows must overlap for deliveries.

How to Identify Grouping Keys

To verify grouping compatibility and determine why stops are not grouping, use our Management API:

Step-by-Step Instructions

1. Navigate to the Tenant API.

2. Use the following endpoint:

   bash
   CopyEdit
   GET /api/v1/drivers/{id}/stops
   

3. Replace {id} with the Driver ID.

4. Click Execute and log in using your Dispatch Science credentials.

Example Output

You will see multiple stops with a field called groupKey. Here’s an example of two stops with different

 groupKeys:

makefile
CopyEdit
groupKey: 1_2_True_True_True_False_False_39.1577_-108.7352e07f4df7e884aa47d0dfbde4a47ef2ec47bba163
groupKey: 1_2_True_True_True_False_False_39.1577_-108.73521542418e9e018a877c5dd8925c3ccd270939c2e8

Since the groupKey values differ, these stops cannot be grouped.

Understanding the Group Key Structure

The groupKey is a unique identifier that defines grouping compatibility. It includes the following components:

Final Notes

• Ensure consistency in setup across orders intended to be grouped.

• Use the API to troubleshoot grouping issues.

• If unsure, consult your account administrator to verify workflow and account configurations.