COD Shipments
Version: 1.0.0
Route: /all-courier and /all-courier/[slug] (examples: /all-courier/tcs, /all-courier/mnp, /all-courier/call-courier)
Who can access: can_view on all-courier. Create/edit/delete need can_edit / can_delete. Admin bypasses.
Screenshot(s)






What this page does
Manages COD consignments across all couriers or a single courier. Statuses: InProcess, Return, Delivered.
Layout
- Heading for all-courier or courier name (e.g. TCS)
- Search field, Filters, Add Entry (when allowed)
- Desktop table / mobile cards of shipments
- Actions: tracking, timeline, status update, Shopify links, sync tools (courier-dependent)
- Sidebar: COD Shipments expands to each courier (TCS, M&P, Call Courier, …)
Steps
Open all shipments
- Click Open menu → COD Shipments (parent link opens
/all-courier).
Open a courier list
- Click Open menu → expand COD Shipments → TCS (or M&P / Call Courier).
- Review consignments, COD amounts, and status columns.
Filter and search
- Use the search box for consignment / contact text.
- Click Filters to set date range, status (InProcess / Return / Delivered), COD amount, etc.
- Apply filters and review the refreshed table.
Add or edit a shipment (editor/admin)
- Click Add Entry.
- Fill consignment number, dates, COD amount, status, and other fields.
- Save; cancel to discard.
Status and claims
- Use row actions to Update status (choose InProcess, Return, or Delivered).
- When prompted, confirm Add to Claimed Submitted? if moving into the claims workflow.
- On supported couriers, use Sync InProcess status for bulk tracking sync (Demo Mode mocks external APIs).
Tables
Typical columns: consignment number, booking/status date, contact, product detail, COD amount, status, courier status, additional details, actions.
Modals
| Modal | Purpose |
|---|---|
| Add / Edit Entry | Create or update shipment |
| Update status | Change shipment status |
| Tracking popup | Live/mocked tracking |
| Timeline popup | Audit events |
| Delete confirm | Remove shipment when can_delete |
| Add to Claimed Submitted? | Optional claim workflow |
Permissions
| Flag | page_key all-courier |
|---|---|
can_view | See lists |
can_edit | Add Entry, edit, sync actions |
can_delete | Delete consignments |
| Admin | All |
Errors
| Message / situation | Notes |
|---|---|
| Courier not found | Invalid slug — pick a courier from the sidebar |
| No InProcess consignments… | Sync tool found nothing under current filters |
| Viewer cannot Add Entry | Missing can_edit |