Skip to content

Dispatcher Response

This guide explains what happens from the Destination Depot Officer's perspective when a dispatcher responds to a batch assignment — either accepting or declining — and how to handle each scenario.

Prerequisites

  • You have assigned a dispatcher to a batch
  • The batch dispatcher_handover_status is currently awaiting
  • The dispatcher has received their assignment notification

Steps

Step 1: Monitor the batch status

After assigning a dispatcher, the batch's dispatcher handover status shows as Awaiting. You can view this on the Batch Detail screen. The dispatcher will respond by either accepting or declining the assignment.

Scenario A: Dispatcher Accepts

Step 2a: Dispatcher accepts the batch

When the dispatcher accepts the assignment:

  1. The batch dispatcher_handover_status changes from awaiting to accepted
  2. The batch status changes to dispatched
  3. All orders in the batch transition to at_pickup_point once the dispatcher delivers them
  4. You receive a confirmation that the batch has been dispatched

Step 3a: Verify batch dispatched

Navigate to the batch list to confirm the batch now shows Dispatched status. No further action is required from you — the dispatcher is now responsible for delivering the batch to the pickup point.

Scenario B: Dispatcher Declines

Step 2b: Dispatcher declines the batch

When the dispatcher declines the assignment:

  1. The batch dispatcher_handover_status changes from awaiting to declined
  2. The dispatcher's decline reason is displayed on the batch
  3. Orders remain at at_country_depot status — they are not dispatched
  4. You receive a notification that the dispatcher declined

Step 3b: View the decline reason

The decline reason provided by the dispatcher is shown on the Batch Detail screen. Common reasons include vehicle issues, scheduling conflicts, or route unavailability. Review the reason to decide your next action.

Step 4b: Cancel the awaiting assignment

If you need to cancel the current assignment before reassigning:

  1. Open the batch that has a declined status
  2. Tap the Cancel Assignment button
  3. The dispatcher_handover_status resets to none
  4. The batch is now unassigned and ready for a new dispatcher

Step 5b: Reassign a different dispatcher

After cancelling, reassign the batch to a different dispatcher:

  1. Tap the Assign Dispatcher button on the batch
  2. Select a different dispatcher from the available team members
  3. The dispatcher_handover_status changes to awaiting and a new notification is sent to the selected dispatcher

Tip

If a dispatcher repeatedly declines, consider assigning a different dispatcher to avoid delivery delays.

Result

Scenario Dispatcher Handover Status Batch Status Order Status Next Action
Dispatcher accepts accepted dispatched Move to at_pickup_point on delivery None — dispatcher handles delivery
Dispatcher declines declined pending at_country_depot Cancel assignment, then reassign a different dispatcher

Notifications triggered

  • On accept: Batch marked as dispatched; dispatcher proceeds to deliver to pickup point
  • On decline: Destination Depot Officer notified of decline with reason; batch available for reassignment

Troubleshooting

Issue Cause Solution
Batch stuck on "Awaiting" Dispatcher has not responded yet Wait for the dispatcher to respond, or contact them directly
Cannot reassign after decline Assignment not cancelled first Cancel the current assignment, then reassign
Same dispatcher declines again Underlying issue not resolved Assign a different dispatcher
Orders not moving to at_pickup_point Dispatcher accepted but hasn't delivered yet This is expected — orders transition once the dispatcher confirms arrival at the pickup point