> ## Documentation Index
> Fetch the complete documentation index at: https://tomotek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# US-OWN-28: Theo dõi hành trình giao hàng (Shipping Tracking)

> Chủ nuôi theo dõi tiến trình di chuyển của kiện hàng theo thời gian thực (Real-time Timeline) thông qua dữ liệu cập nhật từ đối tác vận chuyển.

## 1. Điều kiện tiên quyết (Pre-conditions)

* Đơn hàng đã được Merchant chuyển sang trạng thái ít nhất là `Chờ lấy hàng (Pending Pickup)`.
* Khách hàng đang ở trong màn hình Chi tiết Đơn hàng (`US-OWN-17`).

## 2. Tiêu chí chấp nhận (Acceptance Criteria)

> [accordion] Giao diện Hành trình (Timeline UI)
>
> * Hệ thống cung cấp một nút / khu vực `[Xem hành trình]` nổi bật trong Chi tiết đơn.
> * Giao diện hiển thị dưới dạng **Dòng thời gian dọc (Vertical Stepper)**.
> * Điểm thời gian mới nhất (Current Status) luôn hiển thị trên cùng với màu nổi bật (Xanh lá / Cam).
> * Các bước đã qua (Past Steps) hiển thị mờ hơn.

> [accordion] Kịch bản 1: Đơn hàng qua ViettelPost
>
> * **Dữ liệu Auto-sync:** Hệ thống nhận dữ liệu tự động từ API Callback (Webhook) của ViettelPost.
> * **Nội dung hiển thị:**
>   * Ngày & Giờ chính xác tới từng phút.
>   * Chi tiết trạm trung chuyển (Ví dụ: `Đơn hàng đã đến bưu cục Cầu Giấy`, `Đang vận chuyển đến kho phân loại tổng`, `Bưu tá Nguyễn Văn A đang đi giao`).
> * Trạng thái tổng của đơn hàng (Master Status) sẽ tự động nhảy theo tiến trình này mà không cần sự can thiệp của con người.

> [accordion] Kịch bản 2: Đơn hàng Tự vận chuyển (Merchant tự giao)
>
> * Không có Timeline chi tiết.
> * Chỉ hiển thị một thông báo tĩnh: *"Đơn hàng này được Shop tự điều phối giao đến bạn. Vui lòng giữ liên lạc qua điện thoại."*
> * Hiển thị nút `[Gọi cho Shop]` để người dùng tiện liên lạc giục giao hàng.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.