Past Deliveries¶
This guide covers the Past Deliveries archive, where you can browse and filter orders that have reached a final state — delivered, completed, cancelled, or failed. Use it to review historical delivery performance, look up specific completed orders, or check cancellation details.
Prerequisites¶
- You are logged in as a courier staff member with deliveries read permission for the relevant country
- Your courier application has been approved
- You can access the Deliveries screen from the courier home screen
Steps¶
Step 1: Open Past Deliveries¶
From the Deliveries screen, tap the history icon (clock icon) in the top app bar. This opens the Past Deliveries screen showing your completed delivery archive.
Info
The Past Deliveries screen loads all orders from the courier orders provider and filters to only those with a final status.
Step 2: Filter by time period¶
Use the period filter chips at the top of the screen to narrow results by time range:
| Filter | Behaviour |
|---|---|
| This week | Shows orders from the last 7 days |
| This month | Shows orders from the last 30 days (selected by default) |
| All time | Shows all past deliveries with no date restriction |
Tap a chip to switch between periods. The order count updates immediately to the right of the chips, displaying the total number of matching orders.
Step 3: Browse the order list¶
Each order card displays:
- Order reference — the first 8 characters of the order ID in uppercase (e.g.
#A1B2C3D4) - Date — the date the order was last updated, formatted as day/month/year (e.g. "12 Jun 2025")
- Grand total — the order value in Rand (e.g. "R 450")
- Status badge — colour-coded indicator showing either "Completed" (green) or "Cancelled" (red)
Tip
Pull down on the list to refresh and load the latest order data. You can also tap the refresh icon in the app bar.
Step 4: View order details¶
Tap any order card to navigate to the full Order Detail screen, where you can review the complete order history, items, shipment information, and any associated documents.
Result¶
After using the Past Deliveries screen:
- You can identify which orders were successfully delivered versus cancelled
- The time period filters help narrow large archives to a manageable view
- Tapping through to order details provides full audit trail access for any historical delivery
- The included statuses are:
delivered,completed,cancelled, andpayment_failed
Troubleshooting¶
| Issue | Cause | Solution |
|---|---|---|
| "No past deliveries" message shown | No orders match the selected time period filter | Switch to "All time" to see the full archive. If still empty, no orders have reached a final state yet. |
| Order count shows 0 | Period filter is too narrow | Select a wider time period — try "This month" or "All time". |
| List not updating after delivery completion | Data is cached from previous load | Pull down to refresh the list, or tap the refresh icon in the app bar. |
| Cannot find a specific order | Order may still be in an active status | Use Order Search to find orders across all stages regardless of status. |
| Screen not accessible | Missing deliveries read permission | Ask your courier owner to grant deliveries read access for your assigned country. See Roles & Permissions. |