Bắt đầu lượt tại đúng Điểm bán.
Viếng thăm
Phiên làm việc tại Điểm bán, nối Check-in, tác vụ thực địa, Đơn hàng, Kiểm kho nhanh, Kiểm tra trưng bày và Checkout. Đây là trang lõi để chứng minh Nhân viên bán hàng đã đi tuyến và đã ghi nhận đúng dữ liệu.
Ghi nhận đặt hàng, tồn tại điểm và trưng bày.
Kết thúc lượt khi dữ liệu đã đủ.
Bỏ qua hoặc giải thích tình huống bất thường.
Tóm tắt
Viếng thăm là bằng chứng thực địa của một ngày bán hàng. Mỗi lượt nên bắt đầu từ Kế hoạch viếng thăm, được Check-in tại Điểm bán, có tác vụ phù hợp và kết thúc bằng Checkout. Nếu không thể đi hoặc không thể kết thúc chuẩn, Bỏ qua và Ngoại lệ giúp dữ liệu vẫn có lý do để Giám sát đối soát.
Việc cần làm
- Chọn đúng lượt Viếng thăm theo Kế hoạch viếng thăm trong ngày.
- Check-in khi đã đến Điểm bán và chuẩn bị làm việc với chủ điểm hoặc người phụ trách.
- Trong lượt, lưu tác vụ cần thiết: ghi nhận nhu cầu đặt hàng, tạo Đơn hàng, Kiểm kho nhanh hoặc Kiểm tra trưng bày.
- Checkout khi hoàn tất, hoặc dùng Bỏ qua/Ngoại lệ nếu lượt không thể thực hiện hoặc kết thúc bình thường.
Dữ liệu cần có
Lượt và Điểm bán
Lượt cần gắn đúng Kế hoạch viếng thăm, ngày, Nhân viên bán hàng và Điểm bán trong phạm vi được giao.
Lookup tại điểm
Endpoint lookup của visits hỗ trợ dữ liệu cần chọn trong lượt, tùy tài nguyên được backend cung cấp.
Dữ liệu tác vụ
Danh sách sản phẩm, Bảng giá, Khuyến mãi, Mã giảm giá và dữ liệu template khi có Kiểm tra trưng bày.
Lý do thực địa
Lý do Bỏ qua hoặc Ngoại lệ cần đủ cụ thể để Sales Admin và Giám sát hiểu bối cảnh.
Thao tác chính
- Mở danh sách hoặc truy vấn Viếng thăm bằng `visits/list` và `visits/query`; mở `visits/detail` để kiểm lượt.
- Thực hiện `visits/checkin` khi bắt đầu làm việc tại đúng Điểm bán.
- Lưu tác vụ đặt hàng bằng `visits/order-task/save` nếu cần ghi nhận có hoặc không có nhu cầu đặt hàng trong lượt.
- Thực hiện Kiểm kho nhanh hoặc Kiểm tra trưng bày trong ngữ cảnh lượt khi dữ liệu backend và UI phù hợp.
- Dùng `visits/checkout` để kết thúc; dùng `visits/skip` khi không thực hiện lượt, hoặc `visits/checkout-exception` khi có bất thường lúc kết thúc.
Trạng thái cần nhớ
| Trạng thái/thao tác | Khi dùng | Dữ liệu quay về |
|---|---|---|
| Check-in | Khi bắt đầu tại Điểm bán. | Thời điểm bắt đầu lượt, căn cứ thực địa và điểm đối soát. |
| Checkout | Khi đã hoàn tất tác vụ tại Điểm bán. | Thời điểm kết thúc và kết quả visit cho Giám sát theo dõi. |
| Bỏ qua | Khi không thực hiện được lượt theo kế hoạch. | Lý do bỏ qua, giúp phân biệt miss visit với tình huống hợp lệ. |
| Ngoại lệ | Khi lượt có bất thường cần giải thích lúc kết thúc. | Ghi chú đối soát để Sales Admin hoặc Giám sát xử lý sau tuyến. |
| Order task | Khi cần ghi nhận nhu cầu hoặc không phát sinh Đơn hàng. | Bối cảnh bán hàng trong lượt, nối với Đơn hàng nếu có. |
Tình huống thực địa
Điểm bán bận hoặc đóng cửa
Không Check-in nếu không làm việc được tại điểm. Dùng Bỏ qua kèm lý do rõ để Giám sát đối chiếu.
Đã Check-in nhưng mất kết nối
Kiểm lại dữ liệu đã lưu; nếu không Checkout chuẩn được, dùng Ngoại lệ theo hướng dẫn vận hành.
Có đơn trong lượt
Tạo Đơn hàng sau khi kiểm Danh sách sản phẩm, Bảng giá, Khuyến mãi và Mã giảm giá, rồi Checkout khi hoàn tất.
Không có đơn nhưng có kiểm tồn
Lưu Kiểm kho nhanh để giải thích vì sao điểm chưa cần đặt thêm hoặc cần theo dõi sell-out.
Không có template trưng bày
Với Kiểm tra trưng bày, dùng luồng xác nhận không có template nếu backend trả về tình huống phù hợp.
Lượt còn treo cuối ngày
Rà lại trước khi kết thúc ngày, vì lượt đang mở làm Giám sát khó đối soát hiệu suất thực địa.
Điểm cần đối chiếu
- API salesman xác nhận `visits/list`, `visits/query`, `visits/detail`, `visits/checkin`, `visits/checkout`, `visits/checkout-exception`, `visits/skip`, endpoint lookup của visits và `visits/order-task/save`.
- Kiểm kho nhanh và Kiểm tra trưng bày được xác nhận là tác vụ backend trong lượt; màn độc lập vẫn cần đối chiếu UI theo sitemap.
- Nếu dữ liệu lượt không về trang quản trị, cần kiểm trạng thái đồng bộ, lượt đang mở và lý do Bỏ qua/Ngoại lệ trước khi kết luận sai thao tác.
Checklist trước/sau thao tác
- Trước Check-in: lượt có đúng Điểm bán, đúng ngày và đúng phạm vi không?
- Trong lượt: tác vụ cần làm đã rõ chưa, gồm Đơn hàng, Kiểm kho nhanh hoặc Kiểm tra trưng bày?
- Trước Checkout: mọi Đơn hàng hoặc tác vụ đã lưu thành công chưa?
- Khi Bỏ qua: lý do có đủ cụ thể để Giám sát không phải hỏi lại không?
- Cuối ngày: còn lượt nào đang mở hoặc Ngoại lệ nào chưa báo không?
