Route Dispatching — Settings

Before using Route Dispatching, you need to enable it in two places: the Menu Manager (so users can access the Route Dispatch screen) and Function Groups (so the Create Waypoint button appears on the order screen).

Step 1: Add the Route Dispatch Menu Item

1. Go to Settings → Menu Manager.

2. Select the menu group from the toggle buttons at the top (e.g., Main).

3. Click Add Menu to add a top-level accordion menu item, or click an existing accordion menu to select it, then click Add Sub Item.

4. Configure the menu item:

   Field	Value
   Name	Route Dispatch
   Icon	local_shipping
   Router Link	route-dispatch
   Router Link Active	route-dispatch
   Access	Leave blank or set to restrict to specific user types
   Minimized	Toggle off (show by default)

5. Click Save on the menu item editor.

6. Click Save on the Menu Manager to persist changes.

The Route Dispatch link now appears in the app's navigation menu.

Step 2: Add the "Create Waypoint" Function Button

The Create Waypoint button appears on the order screen. It assigns the current open order to a delivery route as a waypoint.

1. Go to Settings → Authorizations and Access → Function Groups.

2. Find the function group used for your order screen (e.g., Order Buttons). If you're unsure which group, check your Transaction Settings under the Multi-Function Button Lists section (multiButtonOrderHeader).

3. Click Edit on the function group.

4. Click Add Button to create a new button.

5. Configure the button:

   Field	Value
   Name	Create Waypoint
   Icon	route
   Function	Select assignToRoute from the function dropdown

6. Configure the button properties as needed. Recommended settings:

   Property	Setting
   Allow for Staff User	On
   Allow only when balance is greater Than 0	On
   Allow suspended Orders	On

7. Save the button and save the function group.

8. Users must log out and log back in for the new button to appear on the order screen.

Step 3: Verify the Setup

1. Navigate to the Route Dispatch screen from the menu — it should show the route list.
2. Open an order in the POS — the Create Waypoint button should appear in your function button group.
3. Click Create Waypoint on an order with a shipping address — the order should appear in the Pending section of the Route Dispatch list.