Delivery Operations
The Operations section is used by dispatchers and branch users to monitor deliveries, review delivery details, and manage own-fleet assignment.
Deliveries
The Deliveries page is the main operational list for delivery orders.
Use it to:
- View delivery status and order reference.
- Check customer address and delivery fee.
- Review assigned driver or provider.
- View delivery timeline and proof attachments.
- Edit supported delivery fields.
- Override delivery fee when the user has permission.
Delivery Statuses
| Status | Meaning |
|---|---|
| Pending | Delivery was created but is not ready for assignment yet. |
| Pending Assignment | Delivery needs a driver or provider assignment. |
| Assigned | A driver or provider has been assigned. |
| Ready For Pickup | Order is ready to be collected. |
| Picked Up | Driver has picked up the order. |
| On The Way | Driver is moving toward the customer. |
| Arrived | Driver reached the destination. |
| Delivered | Delivery completed successfully. |
| Failed | Delivery could not be completed. |
| Returned | Delivery was returned after failure or return flow. |
| Cancelled | Delivery was cancelled. |
Delivery Show Page
The delivery show page is used to inspect one delivery in detail.
Typical information includes:
- Order reference.
- Customer and address.
- Branch and delivery zone.
- Delivery method.
- Driver or provider assignment.
- Delivery fee and surcharge values.
- Delivery status history.
- Proof attachment when available.
- COD collection channel when relevant.
Dispatch Monitor
The Dispatch Monitor helps dispatchers manage deliveries waiting for assignment.
Use it to:
- See deliveries waiting for assignment.
- View available candidates.
- Assign a delivery to an internal driver.
- Rerun dispatch logic.
- Pause or resume dispatch processing.
- Review automation result messages.
Automation Results
| Result | Meaning |
|---|---|
| Success | Dispatch action completed. |
| Skipped | Delivery was not eligible for automation. |
| Blocked | A required condition was missing. |
| Paused | Dispatch automation is paused. |
| Escalated | Manual action is needed. |
| Failed | Automation attempted the action but failed. |
| Exhausted | Retry attempts were used up. |
Own-fleet Delivery Flow
Own-fleet delivery is the complete live operational path in the current Delivery add-on. It uses internal drivers, the driver panel, internal assignment, COD declaration, driver earnings, payout batches, and payroll export.
- Delivery is created from an order.
- Delivery becomes ready for assignment.
- System or dispatcher assigns an internal driver.
- Driver accepts or rejects the assignment.
- Driver marks the order as picked up.
- Driver completes delivery or reports fail/return.
- Driver declares COD if the driver collected cash.
- Driver earning rules can create earning entries after completion or eligible fail/return.
Driver Actions
| Action | Meaning |
|---|---|
| Accept | Driver accepts assigned delivery or batch. |
| Reject | Driver rejects the assignment. |
| Pickup | Driver confirms order pickup. |
| Deliver | Driver confirms successful delivery. |
| Fail | Driver reports delivery failure with a reason. |
| Return | Driver reports return flow with a reason. |
| Declare COD | Driver declares collected cash amount for COD settlement. |
Delivery Batches
Own-fleet batching groups nearby deliveries into one driver route.
Batching is controlled by branch settings:
- Whether batching is enabled.
- Maximum deliveries per batch.
- Maximum radius.
- Pickup window in minutes.
Batch Statuses
| Status | Meaning |
|---|---|
| Pending | Batch was created and waits for driver action. |
| Active | Driver accepted and is processing the batch. |
| Completed | All batch deliveries are completed. |
| Cancelled | Batch was cancelled. |
Batching can also affect driver earnings through the batch_multiplier earning rule.
Troubleshooting
Driver cannot receive assignment
Check:
- Driver exists and belongs to the correct branch.
- Driver status is available.
- Driver is logged into the driver panel.
- Delivery is own-fleet and pending assignment.
- Dispatch automation is not paused.
Delivery is stuck in pending assignment
Check:
- At least one driver is available.
- Branch settings allow own-fleet assignment.
- Delivery address is inside a valid zone.
- No automation error is blocking dispatch.
- If external courier is expected, provider settings are active.
Driver cannot complete delivery
Check:
- Driver accepted the assignment.
- Delivery is in the correct status for the next action.
- Required proof or COD declaration is provided if configured by the business flow.