Lỗi Temu API 150010140: Danh mục Books chỉ cho phép 1 SKU

Khi đăng sản phẩm thuộc danh mục sách lên Temu qua API (bg.local.goods.add), yêu cầu chứa nhiều SKU sẽ bị từ chối với mã lỗi 150010140. API vẫn trả về HTTP 200 cùng success: false, vì vậy lỗi rất dễ bị bỏ qua nếu bạn chỉ kiểm tra mã trạng thái — cần đọc cả nội dung phản hồi.

Thông báo lỗi

Status_code: 200
Content: {"success":false,"errorCode":150010140,"errorMsg":"For Books, only one SKU is allowed"}

Vì sao lỗi này xảy ra?

Temu quy định Books là danh mục chỉ chấp nhận sản phẩm đơn: chính xác một SKU và không có biến thể. Đây là quy tắc cấp danh mục, không áp dụng chung cho mọi danh mục — với phần lớn danh mục khác, bạn có thể gắn skuList gồm nhiều SKU (chẳng hạn kích thước, màu sắc hoặc quy cách đóng gói) vào một sản phẩm. Với Books, Temu sẽ từ chối mọi sản phẩm có skuList chứa nhiều hơn một mục. Nếu bạn gửi một sản phẩm sách với nhiều SKU — ví dụ gộp các tựa sách, phiên bản hoặc quy cách đóng gói khác nhau trong cùng một lệnh gọi bg.local.goods.add — toàn bộ yêu cầu sẽ thất bại với lỗi 150010140, ngay cả khi từng SKU riêng lẻ đều hợp lệ.

Lưu ý rằng yêu cầu vẫn trả về Status_code: 200. Lỗi nằm hoàn toàn trong phần nội dung JSON (success: false + errorCode), vì vậy hệ thống tích hợp của bạn phải kiểm tra nội dung phản hồi thay vì chỉ dựa vào mã trạng thái HTTP.

Cách khắc phục

1. Với mọi sản phẩm thuộc danh mục sách, hãy gửi skuList có chính xác một SKU trong mỗi lần gọi bg.local.goods.add.
2. Nếu bạn có nhiều cuốn sách (hoặc nhiều phiên bản, quy cách đóng gói) từng được gộp vào một sản phẩm, hãy tách chúng thành các sản phẩm riêng — mỗi sản phẩm một lệnh gọi API và một SKU — thay vì tạo một sản phẩm có skuList gồm nhiều mục.
3. Trong quy trình đăng sản phẩm, hãy phân nhánh theo danh mục: khi danh mục đích là Books, buộc payload chỉ có một SKU trước khi gửi, để mã nguồn phát hiện quy tắc này thay vì chờ Temu từ chối.
4. Luôn phân tích nội dung phản hồi để kiểm tra success và errorCode; đừng coi HTTP 200 là dấu hiệu yêu cầu thành công trên Open API của Temu.

Tóm lại, sách trên Temu được thiết kế theo mô hình mỗi sản phẩm chỉ có một SKU. Hãy xử lý chúng như sản phẩm đơn trong hệ thống tích hợp của bạn và lỗi sẽ biến mất.

Sau khi xây dựng các hệ thống tích hợp đa kênh trên hơn 20 kênh bán hàng — gồm Temu, Amazon SP-API, eBay, Shopify, TikTok Shop và nhiều nền tảng khác — tôi đã gặp không ít quy tắc riêng theo danh mục chỉ bộc lộ khi API từ chối yêu cầu. Nếu bạn cần hỗ trợ thương mại điện tử hoặc tích hợp API sàn marketplace, hãy tham khảo dịch vụ hỗ trợ thương mại điện tử của Netalith hoặc liên hệ trực tiếp với tôi trên LinkedIn.