Quản lý thông tin cơ bản sản phẩm
1. Lấy danh sách sản phẩm
1.1 Lấy tất cả sản phẩm trong shop
API này cho phép bạn lấy danh sách tất cả sản phẩm trong shop hoặc lọc theo khoảng thời gian update_time và trạng thái sản phẩm.
1.2 Tìm kiếm item_id
API này cho phép bạn tìm kiếm danh sách item_id dựa trên một số điều kiện cụ thể, bao gồm:
- Danh sách item_id chứa từ khóa tên sản phẩm
- Danh sách item_id chứa từ khóa SKU
- Danh sách item_id thiếu thuộc tính bắt buộc
- Danh sách item_id thiếu thuộc tính tùy chọn
2. Lấy thông tin sản phẩm
API: v2.product.get_item_base_info + v2.product.get_model_list
Nếu sản phẩm không có biến thể, bạn chỉ cần gọi v2.product.get_item_base_info để lấy thông tin cơ bản của sản phẩm. Ngược lại, bạn cũng cần gọi API v2.product.get_model_list để lấy giá và tồn kho của các biến thể.
Trường "has_model" trong API v2.product.get_item_base_info cho biết sản phẩm có biến thể hay không.
3. Lấy dữ liệu thống kê sản phẩm
API: v2.product.get_item_extra_info
API này có thể lấy dữ liệu về lượt xem, lượt thích, lượt bán, đánh giá và điểm sao của sản phẩm.
Dữ liệu lượt xem là thống kê 30 ngày gần nhất, dữ liệu lượt bán là giá trị tích lũy.
4. Lấy thông tin khuyến mãi của sản phẩm
API: v2.product.get_item_promotion
API này cho phép bạn lấy thông tin về tất cả các chương trình khuyến mãi đang diễn ra hoặc sắp tới mà sản phẩm đang tham gia. Nếu sản phẩm được thêm vào nhiều chương trình khuyến mãi, trường promotion_id của v2.product.get_item_base_info sẽ trả về một trong số các promotion_id đó. Chúng tôi khuyến nghị bạn tiếp tục gọi API v2.product.get_item_promotion để lấy toàn bộ thông tin khuyến mãi.
5. Cập nhật thông tin sản phẩm
-
API này hỗ trợ cập nhật thông tin sản phẩm ngoại trừ thông tin size_chart/price/stock/model. Các trường được tải lên sẽ được cập nhật, các trường không được tải lên sẽ không thay đổi.
-
Đối với item_sku/wholesale/video_upload_id, hỗ trợ thao tác xóa — bạn có thể tải lên chuỗi rỗng để xóa.
Ví dụ xóa item_sku:
{
"item_id": 800182459,
"item_sku": ""
}
-
Vui lòng tham khảo FAQ về cách cập nhật mô tả mở rộng.
-
Nếu bạn không cập nhật một số trường nhưng nhận được thông báo lỗi về các trường đó, đây là tình huống bình thường vì mỗi lần cập nhật chúng tôi sẽ xác minh tính hợp lệ của toàn bộ thông tin sản phẩm. Do đó nếu không đáp ứng yêu cầu, vui lòng chỉnh sửa lại.
6. Ẩn hoặc xóa sản phẩm
"unlist" : true nghĩa là sản phẩm sẽ bị ẩn; "unlist" : false nghĩa là sản phẩm sẽ được hiển thị lại.
API này có thể thay đổi item_status thành "deleted". Lưu ý rằng sau khi xóa, bạn sẽ không thể cập nhật sản phẩm và người bán không thể xem sản phẩm này qua Seller Center.
Đối với sản phẩm bị xóa bởi Shopee hoặc người bán, trong vòng 90 ngày bạn vẫn có thể lấy thông tin sản phẩm qua API. Sau 90 ngày, dữ liệu sản phẩm sẽ bị xóa vĩnh viễn khỏi cơ sở dữ liệu Shopee và bạn không thể truy vấn bất kỳ thông tin nào về sản phẩm này nữa. Nếu cần, hãy lưu thông tin sản phẩm kịp thời.
7. Cập nhật hình ảnh bảng size
API: v2.product.update_size_chart
API này có thể được dùng để thêm hoặc cập nhật hình ảnh bảng size của sản phẩm. Nếu bạn gặp lỗi "Your shop can not edit image size chart", vui lòng xem thông báo.
8. Đăng ký thương hiệu
API: v2.product.register_brand
Người bán có thể đăng ký thương hiệu riêng của mình qua API này. Nếu Shopee duyệt thương hiệu thành công, bạn sẽ nhận được brand_id hợp lệ để thêm hoặc cập nhật sản phẩm.
Về quy trình xét duyệt cụ thể, vui lòng xem FAQ.
*Nội dung sau đây chỉ áp dụng cho người bán CNSC/KRSC.
9. Lấy danh sách sản phẩm toàn cầu
API: v2.global_product.get_global_item_list
API này cho phép bạn lấy danh sách tất cả global_item_id hoặc lọc theo khoảng thời gian update_time dưới merchant. API này sẽ không trả về danh sách các global_item_id đã bị xóa.
10. Lấy ID sản phẩm toàn cầu
API: v2.global_product.get_global_item_id
Bằng cách gọi API này, bạn có thể nhanh chóng tìm thấy global_item_id của một sản phẩm shop.
11. Lấy thông tin sản phẩm toàn cầu
API: v2.global_product.get_global_item_info + v2.global_product.get_global_model_list
-
Nếu sản phẩm toàn cầu không có biến thể, bạn chỉ cần gọi v2.global_product.get_global_item_info để lấy thông tin. Ngược lại, bạn cũng cần gọi v2.global_product.get_global_model_list để lấy thông tin tồn kho và giá của các biến thể.
-
Dữ liệu thống kê và thông tin khuyến mãi không được lưu trên sản phẩm toàn cầu.
Bạn có thể gọi v2.product.get_item_extra_info để lấy dữ liệu thống kê của sản phẩm shop và v2.product.get_item_promotion để lấy dữ liệu khuyến mãi của sản phẩm shop.
12. Cập nhật sản phẩm toàn cầu
API: v2.global_product.update_global_item
- Vì một số trường có thể được quản lý chung bởi sản phẩm toàn cầu và sản phẩm shop, bạn có thể xem chi tiết trong bài viết "Tạo sản phẩm toàn cầu". Bạn có thể thiết lập đồng bộ trường qua API v2.global_product.set_sync_field, khi đó Shopee sẽ tự động đồng bộ sang sản phẩm shop sau khi bạn cập nhật sản phẩm toàn cầu.
13. Xóa sản phẩm toàn cầu
API: v2.global_product.delete_global_item
Sản phẩm toàn cầu không hỗ trợ ẩn, chỉ có thể xóa. Sau khi sản phẩm toàn cầu bị xóa, tất cả sản phẩm shop đã xuất bản cũng sẽ bị xóa theo.
14. Cập nhật hình ảnh bảng size
API: v2.global_product.update_size_chart
API này cho phép bạn thêm hoặc cập nhật bảng size của sản phẩm toàn cầu. Nếu bạn muốn cập nhật bảng size của từng sản phẩm shop riêng lẻ, bạn có thể gọi API v2.product.update_size_chart.
Bạn có thể xem FAQ này để tìm hiểu thêm về quyền truy cập giao diện module sản phẩm mà người bán CNSC/KRSC có.