Vận đơn
Quản lý vận đơn giao hàng — người nhận, bưu cục, COD, toạ độ, trạng thái và liên kết lượt giao hàng.
Trang Vận đơn quản lý từng đơn giao trong module Giao hàng. Vận đơn có thể tạo thủ công hoặc nhận từ luồng tích hợp, rồi gán vào Lượt giao hàng qua Lên kế hoạch giao hàng.
Vị trí menu admin
Quản lý shipper > Vận đơn
Route: /shippingorder
Cột danh sách
| Cột | Ý nghĩa |
|---|---|
| Mã vận đơn | Tracking / random code |
| Giao từ bưu cục | Tên bưu cục; phụ: mã đơn hàng, nhóm vận đơn |
| Lượt giao hàng | Mã lượt (link) hoặc [Chưa gán lượt] |
| Địa chỉ giao hàng | Tên (SĐT), địa chỉ; tag COD nếu có tiền thu hộ; cảnh báo Lỗi tọa độ nếu thiếu lat/lng |
| Trạng thái | Trạng thái tổng của vận đơn |
| Tạo lúc | |
| Thao tác | Sửa (khi đủ quyền) |
Bộ lọc thường dùng: từ khoá (mã vận đơn, mã đơn hàng), loại vận đơn, bưu cục, trạng thái.
Loại vận đơn (khi lọc): Giao hàng cho khách · Luân chuyển hàng hóa nội bộ.
Trạng thái vận đơn (đang dùng trên UI)
Form và danh sách dùng một trường Trạng thái:
| Trạng thái | Ý nghĩa |
|---|---|
| Mới | Vừa tạo |
| Chờ xử lý | Chờ điều phối / xử lý |
| Đang giao hàng | Đang trên đường giao |
| Hoàn thành | Giao xong |
| Thất bại | Giao không thành công |
| Hoàn thành hộ | Giao hộ / hoàn tất dạng đặc biệt |
| Hủy | Đã hủy |
Cờ hỗ trợ điều phối (trên kế hoạch): Đã gán / Chưa gán lượt.
Form thêm / sửa
Heading: Thêm vận đơn / Cập nhật thông tin vận đơn.
Bưu cục
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Giao từ bưu cục | Có | Chọn bưu cục |
| Nhóm vận đơn | Không | Liên kết Nhóm vận đơn |
| Mã vận đơn / Tracking code | Không | Tự động thêm nếu để trống |
Thông tin nhận hàng
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Tên người nhận | Có | |
| Điện thoại liên hệ | Có | |
| Giờ giao dự kiến | Không | Khoảng HH:mm |
| Ngày nhận | Không | |
| Địa chỉ giao hàng | Có | Có nút mở Google Maps để lấy Lat, Long |
| Toạ độ trên bản đồ | Không | Dán Lat, Long thủ công |
| Tỉnh/TP · Quận / Huyện · Phường / Xã | Có | |
| Địa chỉ chi tiết | Không |
Trạng thái (thanh bên)
| Trường | Ghi chú |
|---|---|
| Trạng thái | Các giá trị ở bảng trên |
| TT hiển thị | Chỉ xem / khoá |
Thông tin kiện hàng
| Trường | Ghi chú |
|---|---|
| Mã đơn hàng | Không bắt buộc |
| Giá trị đơn hàng | |
| Tiền COD cần thu | Có thể copy từ giá trị đơn hàng |
| Khối lượng | Đơn vị gram |
| Kích thước (Dài × Rộng × Cao) | cm |
| Ghi chú thông tin đơn hàng |
Dành cho Shipper (khi sửa)
| Trường | Ghi chú |
|---|---|
| Ghi chú từ shipper | |
| Chọn hình | Tối đa 4 file (pdf/png/jpeg) |
Thao tác và luồng liên quan
| Việc cần làm | Ở đâu |
|---|---|
| Thêm / sửa vận đơn | Trang Vận đơn |
| Nhập toạ độ | Form: Google Maps + Toạ độ trên bản đồ |
| Gán / bỏ gán lượt | Lên kế hoạch giao hàng — Gán lượt giao hàng, Thêm lượt mới, Bỏ gán lượt giao hàng |
| Xem vận đơn theo lượt | Click mã lượt → /shippingorder?route_id=… |
| Theo dõi trên bản đồ | Bản đồ giao hàng |
Trang danh sách vận đơn không hiện các nút Import / In / Gán lượt / Tối ưu thứ tự trên header (dù một số key dịch có thể tồn tại trong hệ thống).
Cách dùng nhanh
- Thêm vận đơn → chọn bưu cục và nhóm vận đơn nếu cần.
- Điền người nhận, địa chỉ, vùng hành chính.
- Dán toạ độ (tránh tag Lỗi tọa độ trên danh sách/bản đồ).
- Nhập COD / khối lượng / kích thước nếu cần tính phí hoặc thu hộ.
- Lưu, rồi gán vào lượt trên Lên kế hoạch giao hàng.
Lưu ý
- Thiếu toạ độ → khó hiện đúng trên Bản đồ giao hàng.
- Phí / nhóm sai → kiểm tra Nhóm vận đơn.
- Chưa gán lượt → xử lý ở Lên kế hoạch giao hàng, không phải nút trên danh sách vận đơn.