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.