Vận chuyển & Theo dõi vận đơn (Shipments)

This content is not available in your language yet.

Trang Danh sách Vận đơn (/app/shipments) là nơi quản lý và theo dõi trạng thái di chuyển của toàn bộ các đơn vận chuyển được sinh ra từ quy trình tạo đơn hàng trên TrolyPage.

Các Hãng Vận chuyển Hỗ trợ

Hệ thống tích hợp đa dạng nhà vận chuyển qua 2 cổng chính:

Cổng Goship: Hỗ trợ giao hàng tiêu chuẩn đa nhà xe (GHN, GHTK, J&T Express, Ninja Van, Best Express, ViettelPost…).
Giao hỏa tốc nội thành (On-demand): AhaMove (mã 1), GrabExpress (mã 2) với badge 🚀 Hỏa tốc.
Cổng ViettelPost: Kết nối trực tiếp tài khoản ViettelPost của shop.

Bảng quản lý Danh sách Vận đơn

Bảng hiển thị đầy đủ thông tin chi tiết từng kiện hàng:

Cột	Dữ liệu hiển thị
Mã vận đơn	Mã Tracking Number từ nhà xe (vd `GS123456789`) hoặc ID vận đơn hệ thống.
Mã đơn hàng	Link chuyển trực tiếp tới đơn hàng liên quan (/app/orders).
Khách hàng	Tên người nhận, SĐT và địa chỉ giao hàng.
Nhà vận chuyển	Tên hãng (GHN, GHTK, ViettelPost…) + Badge `Platform` hoặc `Tenant` + Badge `Hỏa tốc` (nếu giao trong ngày).
Phí ship & COD	Tiền cước vận chuyển + Tiền thu hộ COD.
Trạng thái	Trạng thái hiện tại từ hãng (Đang xử lý, Đã lấy hàng, Đang giao, Giao thành công, Chuyển hoàn…).
Thao tác	👁️ Theo dõi (Mở modal `ShipmentTrackModal` tra cứu hành trình) hoặc 🔄 Làm mới.

Bấm vào bất kỳ vận đơn nào để mở modal tra cứu chi tiết:

1. Thông tin tổng quan bưu kiện

Nhà vận chuyển & Mã vận đơn.
Gói dịch vụ (Tiêu chuẩn / Hỏa tốc).
Cước phí vận chuyển & Số tiền thu hộ COD.
Trạng thái đối soát hoàn tiền COD (settlement.refund_status).

2. Timeline Hành trình di chuyển (Status Timeline)

Hiển thị toàn bộ các mốc nhật ký di chuyển của bưu kiện từ hệ thống nhà xe theo thứ tự thời gian:

08:30 15/07: Đơn hàng đã được tạo thành công trên hệ thống Goship.
10:15 15/07: Shipper đã lấy hàng thành công tại kho.
14:00 15/07: Đã nhập kho luân chuyển.
09:00 16/07: Đang giao hàng đến người nhận.
11:30 16/07: Giao hàng thành công (Đã thu tiền COD).

3. Đồng bộ dữ liệu realtime (`/refresh`)

Bấm nút Cập nhật dữ liệu từ hãng để chủ động gọi API sang Goship/ViettelPost cập nhật trạng thái mới nhất ngay lập tức mà không cần chờ cronjob định kỳ.

Bước tiếp theo

Đơn hàng — Quy trình tạo vận đơn từ đơn hàng.
Thanh toán & Vận chuyển — Cấu hình kho lấy hàng và kết nối SePay/Goship.
AI Tra cứu Vận chuyển — Tool shipping_tracker & goship_tracker cho AI.