Hàng đợi đồng bộ: theo dõi và xử lý lỗi đẩy hàng lên sàn

  # Hàng đợi đồng bộ: theo dõi và xử lý lỗi đẩy hàng lên sàn     Bài **Vòng đời sản phẩm** có nhắc: "Chỉ sản phẩm ở trạng thái đang hoạt động mới nằm trong lượt đẩy hàng lên sàn." Bài **Danh mục sản phẩm** cũng nhắc việc sản phẩm thiếu ánh xạ danh mục sẽ "bị loại khỏi lượt đưa hàng lên TikTok Shop, kèm lý do thiếu ánh xạ danh mục." Bài này chỉ đúng chỗ để xem lý do đó và xử lý tiếp.     Bài dành cho người phụ trách kênh bán.     ## Mở màn hình     Trong menu bên trái, nhóm **Cài đặt hệ thống**, chọn **Hàng đợi đồng bộ**. Màn hình có tiêu đề **Hàng đợi & lỗi đồng bộ**, mô tả: "Theo dõi job đẩy dữ liệu qua channel-api và retry các lỗi đồng bộ có request_id."     Việc đẩy hàng lên sàn (ví dụ một lượt đẩy hàng loạt lên TikTok Shop) không hiện kết quả ngay trên màn hình sản phẩm. Nó chạy thành các "job" riêng, và màn hình này là nơi duy nhất xem được trạng thái của từng job đó.     ## Đọc bảng dữ liệu     | Cột | Ý nghĩa |  |---|---|  | **Loại việc** | Loại job (ví dụ job đẩy dữ liệu sản phẩm), kèm mã job bên dưới. |  | **SKU / sản phẩm** | Mặt hàng mà job này xử lý. |  | **Trạng thái** | Xem bảng trạng thái bên dưới. |  | **Lỗi gần nhất** | Câu lỗi trả về, kèm `request_id` nếu có — mã này dùng khi cần nhờ hỗ trợ kỹ thuật tra cứu chi tiết ở phía sàn. |  | **Số lần lỗi** | Job đã thử và lỗi bao nhiêu lần. |  | **Thời gian** | Thời điểm job chạy. |  | **Thao tác** | Nút **Retry**, chỉ hiện với job đang ở trạng thái Lỗi. |     Bảng trạng thái:     | Trạng thái hiển thị | Ý nghĩa |  |---|---|  | **Chờ xử lý** | Job đã được xếp hàng, chưa chạy. |  | **Đang chạy** | Job đang được xử lý. |  | **Thành công** | Job đã hoàn tất, dữ liệu đã sang tới sàn. |  | **Lỗi** | Job thất bại. Có thể bấm **Retry**. |     Dùng ô **Lọc theo status** phía trên bảng để chỉ xem các job Lỗi khi cần rà soát nhanh sau một lượt đẩy hàng lớn. Dòng chữ "X job, Y lỗi trong kết quả hiện tại" cho biết nhanh có bao nhiêu lỗi trong trang đang xem.     ## Xử lý một job lỗi     1. Lọc trạng thái **Lỗi**.  2. Đọc cột **Lỗi gần nhất** để biết nguyên nhân — ví dụ thiếu ánh xạ danh mục, thiếu thuộc tính bắt buộc theo sàn (xem bài Ánh xạ thuộc tính sang sàn), hoặc lỗi từ phía sàn.  3. Sửa đúng nguyên nhân trên sản phẩm hoặc trên cấu hình kênh trước, rồi quay lại đây bấm **Retry**.  4. Nếu lỗi lặp lại nhiều lần với cùng một `request_id`, dùng mã này khi báo cho đội kỹ thuật hoặc bên vận hành sàn.     Bấm **Tải lại** ở góc trên để cập nhật danh sách mà không cần tải lại cả trang.     ## Điểm cần người nghiệp vụ xác nhận     - Chưa xác nhận trên môi trường thật: sau khi bấm **Retry**, kết quả cập nhật ngay trên bảng hay cần bấm **Tải lại** thủ công.  - Chưa rõ job **Chờ xử lý** có tự chuyển sang **Đang chạy** trong bao lâu là bình thường, và tới ngưỡng nào thì nên coi là bị treo và cần báo kỹ thuật thay vì tiếp tục chờ.  - Cần chốt ai được xem và bấm Retry ở màn hình này — hiện mọi tài khoản vào được nhóm Cài đặt hệ thống đều thấy mục Hàng đợi đồng bộ.  - Danh sách job hiện chỉ lọc theo trạng thái, không lọc theo sản phẩm hay theo lượt đẩy hàng cụ thể. Cần xác nhận có cách nào tra theo đúng sản phẩm vừa đẩy hay phải dò trong toàn bộ danh sách.