Skip to content

Order Search

This guide covers how to search for any order across all stages using the global order search tool. You can find orders by order ID, customer name, surname, or passport number.

Prerequisites

  • You are logged in as a courier team member (any role)
  • Your courier application has been approved
  • You have an active courier organization selected

Steps

From the courier home screen, open the navigation drawer (hamburger menu) and tap Order Search under the Tools section. The search screen opens with the cursor focused in the search field, ready for input.

Info

Order Search is accessible from the navigation drawer on any screen within the courier section. You do not need to navigate back to the home screen first.

Step 2: Enter your search query

Type your search term into the search field at the top of the screen. You can search by:

Search Criterion Example
Order ID The first characters of the order UUID (e.g. A3F2B1C8)
Customer first name John
Customer surname Mokoena
Passport number M12345678

Tip

Search begins automatically once you have typed 3 or more characters. You can also press Enter/Submit to trigger a search with at least 2 characters.

Step 3: Review search results

Results appear as cards below the search field. Each result card displays:

  • Order ID — shown as the first 8 characters in uppercase (e.g. Order #A3F2B1C8)
  • Status chip — colour-coded indicator showing the current order stage
  • Customer name — the customer's first and last name
  • Delivery mode — either "Pickup" or "Door Delivery"
  • Location info — contextual detail based on current status (e.g. pickup point name, driver name, or depot location)
  • Grand total — the order value in Rands (e.g. R450.00)
  • Date created — when the order was placed

The status chip uses colour coding to indicate urgency:

Status Colour Label
Pending Amber Pending
Paid Amber Paid
Procuring Amber Procuring
At Source Depot Amber At Source Depot
In Transit Blue In Transit
At Destination Depot Amber At Dest. Depot
At Pickup Point Amber At Pickup
On Route Blue On Route
Delivered Green Delivered
Completed Green Completed
Cancelled Red Cancelled

Step 4: Navigate to order detail

Tap any result card to open the full Order Detail screen for that order. From there you can view items, shipment history, messaging, and all order actions.

Info

The search only returns orders belonging to your courier organization. You will not see orders assigned to other couriers.

To start a new search, tap the X button in the search bar to clear the current query and results. Then type a new search term.

Result

After using Order Search:

  • You can locate any order across all stages without navigating through individual pipeline screens
  • Tapping a result takes you directly to the order detail screen where you can take actions appropriate to the order's current status
  • Search results are scoped to your active courier organization only
  • Up to 10 results are returned for ID-based searches, and up to 20 for name/passport-based searches

Troubleshooting

Issue Cause Solution
No results found Search term is too short or doesn't match any order Ensure you have typed at least 2-3 characters. Try searching by a different criterion (e.g. order ID instead of name).
Results don't update as I type Query has fewer than 3 characters Type at least 3 characters for automatic search, or press Enter with 2+ characters.
Cannot find a recently placed order The order may belong to a different courier organization Switch to the correct organization using the org switcher on the home screen, then search again.
Search is slow or loading indefinitely Network connectivity issue Check your internet connection. If the issue persists, close and reopen the search screen.
Order shows unexpected status Order has progressed since your last check The search shows real-time status. Tap the result to view full order detail and history.
  • Past Deliveries — browse and filter orders that have been delivered or completed