Xử lý sự cố
Trang này giúp bạn xác định sự cố thuộc nhóm nào và mở đúng trang có hướng xử lý. Mỗi trang quy trình có mục "Khi có vấn đề" riêng cho lỗi của nghiệp vụ đó.
Định vị sự cố theo nhánh
Mỗi nhánh có một điểm bắt đầu:
- Thiếu màn hình hay nút: thường do quyền, module, gói hoặc phạm vi kho. Xem Người dùng và bảo mật và bảng thông báo bị chặn bên dưới.
- Số không khớp: kiểm tra trạng thái phiếu trước, sổ kho sau. Xem Xuất, chuyển và điều chỉnh và Theo dõi báo cáo.
- Thiết bị: kiểm tra lần lượt đầu đọc, MQTT broker và cấu hình. Xem Quản lý RFID. Với máy quét cầm tay, xem thêm Máy quét cầm tay.
- Kênh bán: kiểm tra kết nối và màn hình Đồng bộ kênh bán. Xem Đơn từ kênh bán.
Tra nhanh theo triệu chứng
| Triệu chứng | Kiểm tra | Trang xử lý |
|---|---|---|
| Không thấy một mục menu | Vai trò, module đã bật, tính năng của gói | Người dùng và bảo mật, Cấu hình và tích hợp |
| Tồn chưa đổi sau nhập hoặc xuất | Phiếu còn ở Đã gửi hoặc Đã duyệt | Mua hàng và nhập kho |
| Không chọn được kho trên phiếu | Chức năng của kho và phạm vi kho của tài khoản | Danh mục và kho hàng, Người dùng và bảo mật |
| Tồn hai kho không khớp sau chuyển | Phiếu chuyển còn trên đường | Xuất, chuyển và điều chỉnh |
| RFID đọc thiếu | Thẻ bị che, hướng đặt, vật liệu, kết nối | Quản lý RFID |
| RFID đọc dư thẻ lạ | Vùng đọc lan sang kệ bên | Quản lý RFID |
| Báo trùng mã EPC | Lịch sử thẻ và sản phẩm đang gắn | Quản lý RFID, tra Thẻ RFID → Kiểm tra hàng trước khi sửa liên kết |
| Đơn sàn không thấy về | Kết nối kênh và mục Nhật ký sự kiện trong Đồng bộ kênh bán | Đơn từ kênh bán |
| Cổng an ninh kêu hoặc không kêu | Trạng thái thanh toán của thẻ, chế độ cổng, giờ canh, quy tắc bỏ qua | Cấu hình và tích hợp |
| Nhãn RFID bị từ chối hoặc in lỗi | Mã quét có dẫn tới đúng một sản phẩm, máy in đã thử, trạng thái lệnh in | Cấu hình và tích hợp, Quản lý RFID |
| Lô hàng từ doanh nghiệp liên kết không nhận được | Liên kết còn hoạt động, các dòng đã ánh xạ, lỗi toàn vẹn | Cấu hình và tích hợp |
| Webhook hoặc API không chạy | Khóa còn bật, phạm vi, địa chỉ https, lần gửi gần nhất | Cấu hình và tích hợp |
| Không nhận thông báo, email hoặc Telegram | Công tắc thông báo của bạn, SMTP, bot Telegram | Cấu hình và tích hợp |
| Không đăng nhập được | Trạng thái tài khoản, tài khoản bị tạm khóa do nhập sai mật khẩu, mã 2FA | Người dùng và bảo mật |
| Hai báo cáo lệch nhau | Múi giờ, kho, khoảng ngày, trạng thái giao dịch | Theo dõi báo cáo |
| Thấy ít dữ liệu hơn đồng nghiệp | Phạm vi kho được gán | Người dùng và bảo mật |
| Cuối ca lệch tiền mặt | Hoàn tiền và hủy đơn trong ca | Bán hàng, trả hàng và kiosk |
| Kiểm kê ra cả loạt hàng thiếu | Phiếu chuyển và phiếu chờ duyệt còn treo | Kiểm kê và đối soát |
Đọc các thông báo bị chặn
Khi một thao tác bị từ chối, thông báo cho biết điều gì chặn nó:
| Thông báo | Nghĩa là | Cách xử lý |
|---|---|---|
| "Bạn không có quyền thực hiện thao tác này. Hãy hỏi quản trị viên." | Tài khoản thiếu quyền của thao tác | Cấp quyền qua vai trò, xem Người dùng và bảo mật |
| "Tính năng này không có trong doanh nghiệp này. Hãy hỏi quản trị viên hoặc nhà cung cấp dịch vụ." | Module đang tắt | Bật ở Cài đặt → Tính năng hoặc nhờ nhà cung cấp |
| "Gói hiện tại chưa có tính năng này. Hãy nâng cấp gói để sử dụng." | Gói thuê bao không có tính năng | Liên hệ nhà cung cấp |
| "Đã đạt giới hạn của gói dịch vụ ({current}/{limit}). Hãy nâng cấp gói hoặc xóa bớt dữ liệu trước khi thêm mới." | Chạm hạn mức người dùng, sản phẩm, kho, thẻ, đơn, kiosk hoặc đầu đọc | Nâng gói hoặc xóa bớt |
| "Bạn không có quyền truy cập kho này. Hãy nhờ quản trị viên cấp quyền." | Kho ngoài phạm vi được gán | Nhờ gán thêm kho |
| "Thời gian dùng thử đã kết thúc. Hãy chọn gói để tiếp tục." | Hết dùng thử | Chọn gói |
| "Gói đăng ký đang ở chế độ chỉ xem. Hãy gia hạn để thay đổi dữ liệu." | Quá hạn hoặc bị tạm ngưng, vẫn xem được nhưng không sửa được | Gia hạn gói |
| "Quá nhiều yêu cầu. Vui lòng đợi một lát rồi thử lại." | Gửi quá nhiều yêu cầu trong thời gian ngắn | Đợi một lát rồi thử lại |
Thu thập bằng chứng trước khi sửa
Sửa dữ liệu khi chưa đủ bằng chứng có thể làm một lỗi nhỏ thành lỗi không truy được nguồn gốc. Trước khi thay đổi bất kỳ số nào:
- Chụp màn hình thông báo lỗi cùng bộ lọc đang dùng.
- Ghi lại số chứng từ hoặc mã đơn liên quan.
- Xuất hoặc chụp các dòng Sổ kho liên quan.
- Sự cố RFID thì ghi thêm mã EPC, tên đầu đọc và vị trí đọc.
- Sự cố tích hợp thì ghi tên kênh, thời điểm và trạng thái lần đồng bộ gần nhất.
Quản trị → Nhật ký hoạt động ghi lại ai làm gì, và thường trả lời được câu "số này đổi lúc nào, do ai":

Hướng dẫn vận hành
Đừng điều chỉnh tồn chỉ để xóa chênh lệch. Khi cần điều chỉnh, lập phiếu với lý do rõ ràng và ghi tham chiếu tới bằng chứng đã thu thập, xem Xuất, chuyển và điều chỉnh.
Đọc tiếp
- Kiểm kê và đối soát tồn kho: khi nghi ngờ lan rộng hơn một vài món.
- Theo dõi báo cáo: trình tự truy nguyên khi hai con số cãi nhau.
- Cấu hình và tích hợp: khi nghi lỗi đến từ một thay đổi cấu hình.

