Skip to main content

Order management

The Danh sách đơn hàng (Order list) page is where you look up every order you have created. It is also the first screen you see after signing in.

Order list with the search box and filters
  1. Search by order ID or tracking code
  2. Order creation date range
  3. Filter by service
  4. Filter by creator
  5. Filter by status
  6. Clear active filters
  7. Download order data
  8. Copy order ID
  9. Hover to see the cancellation reason
Order list with the search box and filters

Find an order​

  • Quick search by order ID or tracking code.
  • Filter by date range, service, creator, and status. Click Xoá bộ lọc (Clear filters) to go back to the defaults.
  • Want to see a branch's orders? Change the Đang quản lý (Managing) box in the left menu. See Managing.
Cannot see your colleagues' orders?

By default, each person only sees their own orders. You need the Xem đơn của toàn công ty (View company-wide orders) permission to see orders created by others. See Roles & permissions.

Information in each row​

ColumnContent
Mã đơn (Order ID)Order ID (click the icon to copy) and service name
Điểm lấy hàng (Pickup point)Sender's name, phone number, and address
Điểm giao hàng (Drop-off point)First recipient, plus "+N điểm giao khác" (+N other drop-off points) if the order has multiple points
Thời gian tạo (Created at)When the order was created
Tổng COD (Total COD)Total cash on delivery amount for the order
Phí (Fee)Delivery fee
Trạng thái (Status)Current status and when it was last updated

Order statuses​

The Trạng thái (Status) filter has 8 options. Click each status in the diagram to see what it means, what you need to do, and what happens to the money.

Before finding a driver (if any)
→→→→
↳ No driver accepts / you cancel / driver cancels too often →↺ Driver cancels after accepting: the order goes back to “Đang tìm tài xế” (ASSIGNING)
Đang tìm tài xế (ASSIGNING)
What it means
The system is offering the order to drivers near the pickup point.
What you should do
Wait. If nobody accepts for too long, the order is cancelled automatically. Peak hours and remote areas usually take longer.
Money
If paid by "Tài khoản" (company account): the fee was charged when ordering.
Trạng thái (Status) filter showing the number of orders in each status
Trạng thái (Status) filter showing the number of orders in each status
The number next to each status

The filter shows the number of orders currently in that status. Only Hoàn thành (COMPLETED) and Đã huỷ (CANCELLED) do not show a number, so the page loads faster; you can still filter and view them in full.

Order details​

Click a row to open the order details.

Order details: order information, driver, fee table, and route
  1. Expand to full screen · copy order ID
  2. Huỷ đơn (Cancel order), greyed out when the order can no longer be cancelled
  3. Chia sẻ link theo dõi (Share tracking link)
  4. Kiểm thử (Testing), Staging only
  5. Order status
  6. 3 tabs: Chi tiết (Details) · Lịch sử (History) · Kiểm thử (Testing)
  7. Rate the driver once the order is finished
  8. Đơn vị vận chuyển (Carrier): driver, license plate, assigned by
  9. Bảng phí (Fee table): stop fee, special services, distance, discount, total COD
  10. Phí bồi hoàn (Reimbursement fee), if any
  11. Hành trình (Route): status of each point
Order details: order information, driver, fee table, and route

Buttons in the top-right corner:

ButtonUsed to
⊘ Huỷ đơn (Cancel order)Cancel the order. The button is greyed out when the order is in a status that cannot be cancelled (e.g. already Hoàn thành (COMPLETED))
Chia sẻ link theo dõi (Share tracking link)Get a link so the recipient can follow the order's route
Kiểm thử (Testing)Open the Kiểm thử (Testing) tab (Staging only)
SectionContent
Thông tin đơn (Order information)Orderer, waybill code, payment method, service
Đơn vị vận chuyển (Carrier)Driver's name and phone number, license plate, assigned by
Kiện hàng & ghi chú (Packages & notes)Order notes
Hành trình · N điểm (Route · N points)Each point with its status: pickup point Đã lấy hàng (Picked up), drop-off point Đã giao (Delivered) or Thất bại (Failed)
Bảng phí (Fee table)Phí điểm dừng (Stop fee) · Phí dịch vụ đặc biệt (Special service fee) · Phí khoảng cách (Distance fee) · Giảm giá (Discount) · Tổng cộng (Total) · Tổng COD (Total COD)
Dịch vụ thêm (Add-on services)The special requests that were selected
Phí bồi hoàn (Reimbursement fee)Reimbursement amounts incurred on the order. Approve them in Reimbursement
Completed ≠ everything delivered successfully

A multi-point order moves to Hoàn thành (COMPLETED) once the driver has finished handling every point, including points marked Thất bại (Failed) (recipient absent, wrong address…). Always check the Hành trình (Route) section to see the result of each point.

History tab​

A timeline of every event on the order, from creation to the end. Use it when you need to know what happened, when, and by whom, for example when a customer asks why an order was delivered late or why a point failed.

Lịch sử (History) tab: timeline of order events, with the webhook section of one step expanded
  1. Number next to the tab name = number of events + number of webhook sends
  2. Icon by event type: green means success, red means failure
  3. Time and actor (the orderer or Hệ thống (System))
  4. Click "N webhook" to see the callbacks sent at this step
  5. Result per endpoint: response code 200 / 429…
  6. Events for each drop-off point (package N)
Lịch sử (History) tab: timeline of order events, with the webhook section of one step expanded

Each event shows the event name, the time, and Bởi (By): the orderer's name (for the Tạo đơn (Create order) step) or Hệ thống (System) (for automated steps).

EventMeaningMatching order status
Tạo đơn (Create order)The order was created (on the portal or via the API)—
Tìm tài xế (Find driver)The system starts looking for a driverĐang tìm tài xế (ASSIGNING)
Đã nhận (Accepted)A driver accepted the orderĐã có tài xế (ACCEPTED)
Thực hiện (In progress)The driver picked up the goods and started deliveringĐang giao (IN PROCESS)
Giao hàng thành công gói thứ N (Package N delivered)Drop-off point N has been delivered—
Giao hàng thất bại gói thứ N (Package N failed)Drop-off point N could not be delivered—
Hoàn thành (COMPLETED)The driver has finished handling every pointHoàn thành (COMPLETED)

Webhooks at each step. Each step where Ahamove sent a callback has an N webhook label (N = number of registered endpoints). Click the label to expand it:

  • Callback x/N: number of endpoints that received it successfully out of the total, e.g. 1/2 means 1 of 2 endpoints received it successfully.
  • Each endpoint #1, #2… with its response code: 200 means received successfully; any other code (e.g. 429) means the endpoint rejected it.
Troubleshoot delivery and integration issues with the History tab
  • Late delivery? Compare the times between Tìm tài xế (Find driver) → Đã nhận (Accepted) (waiting for a driver) and Thực hiện (In progress) → Giao hàng thành công (Delivered) (delivery time).
  • A point failed? Find the Giao hàng thất bại gói thứ N (Package N failed) line, then match it with point N in the Hành trình (Route) section of the Chi tiết (Details) tab.
  • Your system is not receiving updates? Expand the webhook label at that step to see which code the endpoint returned. See the full data in the Callback log, or the Kiểm thử (Testing) tab on Staging.

Testing tab (Staging only)​

For partners integrating the API: run a test of an order's lifecycle and see the callbacks Ahamove sends to your webhook at each step.

Staging only

This tab only supports the Staging environment for test runs. Orders and statuses here are test data: there is no real driver and no charges.

Kiểm thử (Testing) tab in order details: status sequence, Tiếp tục (Continue) button, callback list, and callback data
  1. Test status sequence; the current step is highlighted
  2. Tiếp tục (Continue): move the order to the next status
  3. List of callbacks sent for this order
  4. Refresh the list
  5. Resend (Retry) a callback
  6. Dữ liệu yêu cầu (Request data) / Dữ liệu phản hồi (Response data) of the selected callback
Kiểm thử (Testing) tab in order details: status sequence, Tiếp tục (Continue) button, callback list, and callback data
Create an order on Staging (via the API or Lên đơn (Create order)), then open the Kiểm thử (Testing) tab
Click Tiếp tục (Continue) to move the order to the next status

Example flow with a failed delivery: Tạo đơn (Create order) → Đang tìm tài xế (ASSIGNING) → Tài xế đã nhận (ACCEPTED) → Đang giao hàng (IN PROCESS) → Giao hàng thất bại (Delivery failed) → Đang trả hàng (Returning) → Đã trả hàng (Returned).

The new step is highlighted; Ahamove sends a callback to your webhook.
Check the callback list

Each row has Status (the order status in the callback, e.g. ASSIGNING, ACCEPTED, IN PROCESS, COMPLETED), Callback Time, and the Response Code your webhook returned. 200 means received successfully; any other code (e.g. 429) means your endpoint rejected it.

Click a row to see the Callback data

The Dữ liệu yêu cầu (Request data) tab: the Webhook URL, Method, Headers, and Body Ahamove sent. The Dữ liệu phản hồi (Response data) tab: what your webhook returned. Click the copy icon on each block to grab the data for comparison.

Fix the endpoint if there is an error, then click Retry callback on that row to resend it
Callback data contains sensitive information

The Headers and Body blocks may contain credentials (e.g. the Authorization header) and recipient data. Do not take screenshots of them or share them verbatim outside your team.

To run the test cases required before go-live, see Integrations › Testing.

Export data​

Click Tải dữ liệu đơn hàng (Download order data) in the right corner to export the order list using the current filters.

note

Sending the order file by email requires the Xuất danh sách đơn ra email (Export order list to email) permission. See Roles & permissions.