Accepting Assignment¶
When a Destination Depot Officer assigns you a door delivery, you receive an "Orders assigned for door delivery" notification. Review the order details and either accept the assignment to begin delivery, or decline with a reason so the depot officer can reassign.
Prerequisites¶
- You are logged in as a Driver
- You have received an "Orders assigned for door delivery" notification
- The order's driver_handover_status is awaiting
Steps¶
Step 1: Open the delivery assignment notification¶
When orders are assigned to you for door delivery, you receive a push notification titled "Orders assigned for door delivery." Tap the notification to open the assignment details, or navigate to your assignments list where new delivery requests appear with an Awaiting badge.
Step 2: Review the order details¶
On the assignment detail screen, review the delivery information:
- Customer address — the full delivery address where you will deliver the order
- Items — a list of items in the order for verification
- Number of orders — how many orders are included in this assignment
- Special instructions — any delivery notes from the customer (if applicable)
Ensure you can fulfil the delivery before accepting.
Step 3: Accept the assignment¶
If you are able to make the delivery, tap the Accept button. This confirms you will deliver the orders to the customer's address.
Step 4: Decline with a reason (if unable to deliver)¶
If you cannot fulfil the delivery, tap the Decline button. A reason field appears — you must provide a reason for declining. Enter your reason (e.g., "Vehicle breakdown", "Outside my delivery zone", "Not available today") and tap Submit.
Result¶
After accepting:
- The order's driver_handover_status transitions from awaiting → accepted
- The order status transitions to on_route
- A delivery token is generated for delivery confirmation (QR code and 6-digit PIN)
- You are now responsible for delivering the order to the customer
- Proceed to Confirming Delivery for next steps
After declining:
- The order's driver_handover_status transitions from awaiting → declined
- Your reason is recorded and visible to the Destination Depot Officer
- The Destination Depot Officer is notified of the decline and can reassign a different driver
- The order remains at the destination depot until a new driver is assigned
Troubleshooting¶
| Issue | Cause | Solution |
|---|---|---|
| Notification not received | Push notifications may be disabled on your device | Check notification settings in the app and enable push notifications |
| Order details not loading | Network connectivity issue | Check your internet connection and pull to refresh the screen |
| Cannot submit decline without reason | Reason field is required | Enter a brief explanation for why you cannot accept the delivery |
| Accept/Decline buttons not visible | The assignment may have been cancelled by the depot officer | Pull to refresh — if the order no longer shows an awaiting status, it has been reassigned |
| Accepted by mistake | You tapped Accept but cannot fulfil the delivery | Initiate a Return to Depot request or contact the Destination Depot Officer immediately |