Quản lý tồn kho và giá
1. Lấy giá sản phẩm
- Nếu sản phẩm không có biến thể, hãy dùng API v2.product.get_item_base_info để lấy thông tin giá.
- Nếu sản phẩm có biến thể, hãy dùng API v2.product.get_model_list để lấy thông tin giá.
Phản hồi API:
"price_info": [
\{
"current\_price": 7678,
"original\_price": 13960,
"inflated\_price\_of\_current\_price": 9137,
"inflated\_price\_of\_original\_price": 16612,
"currency": "COP"
\}
Lưu ý:
-
Nếu sản phẩm đang có khuyến mãi, current_price sẽ hiển thị giá khuyến mãi trong thời gian khuyến mãi. Nếu không, current_price=original_price. original_price là giá gốc của sản phẩm.
-
Nếu sản phẩm có nhiều chương trình khuyến mãi, bạn có thể lấy từng giá khuyến mãi qua API v2.product.get_item_promotion.
-
Nếu bạn là người bán ID / CO / PL, inflated_price_of_current_price/inflated_price_of_original_price là giá đã bao gồm thuế; nếu bạn là người bán từ các khu vực khác, inflated_price_of_current_price=current_price, inflated_price_of_original_price=original_price.
2. Cập nhật giá sản phẩm
- Nếu sản phẩm có biến thể, bạn có thể tải lên nhiều biến thể của sản phẩm này để cập nhật giá trong một lần gọi.
- API này chỉ hỗ trợ cập nhật một item_id trong một lần gọi. Nếu cần cập nhật nhiều hơn một item_id, bạn có thể yêu cầu nhiều lần.
- Vui lòng kiểm tra phạm vi giá có thể cập nhật qua price_limit trong API v2.product.get_item_limit.
2.1 Ví dụ cập nhật giá sản phẩm không có biến thể.
{
"item_id": 1000,
"price_list": [{"original_price": 11.11}]
}
2.2 Ví dụ cập nhật giá sản phẩm có biến thể.
{
"item_id": 2000,
"price_list": [{"model_id": 3456, "original_price": 11.11}, {"model_id": 1234, "original_price": 22.22}]
}
Lưu ý rằng nếu bạn là người bán ID / CO / PL, original_price được cập nhật là giá chưa bao gồm thuế.
3. Cập nhật giá sản phẩm toàn cầu
*Phần sau chỉ áp dụng cho người bán xuyên biên giới đã nâng cấp CNSC/KRSC.
API: v2.global_product.update_price
- Nếu sản phẩm toàn cầu có biến thể, bạn có thể cập nhật giá của nhiều biến thể trong một lần gọi.
- API này chỉ hỗ trợ cập nhật một global_item_id trong một lần gọi. Nếu cần cập nhật nhiều hơn một global_item_id, bạn có thể yêu cầu nhiều lần.
- Đối với giá của sản phẩm toàn cầu, hãy kiểm tra tiền tệ giá trước qua API v2.merchant.get_merchant_info.
- Nếu bạn muốn giá sản phẩm toàn cầu tự động đồng bộ sang sản phẩm shop, hãy bật tính năng đồng bộ giá qua API v2.global_product.set_sync_field. Shopee sẽ tự động cập nhật dựa trên công thức. Nếu không, bạn có thể cập nhật giá qua API v2.product.update_price.
4. Lấy tồn kho sản phẩm
- Nếu sản phẩm không có biến thể, hãy dùng API v2.product.get_item_base_info để lấy thông tin tồn kho.
- Nếu sản phẩm có biến thể, hãy dùng API v2.product.get_model_list để lấy thông tin tồn kho.
Phản hồi API:
Json
{
"stock_info_v2": {
"summary_info": {
"total_reserved_stock": 0,
"total_available_stock": 389
},
"seller_stock": [
{
"location_id": "IDZ",
"stock": 90
}
],
"shopee_stock": [
{
"location_id": "IDG",
"stock": 99
},
{
"location_id": "IDM",
"stock": 200
}
]
}
}
Lưu ý:
- Sản phẩm có thể có cả seller_stock và shopee_stock, hoặc có thể có tồn kho từ nhiều địa điểm.
- Để biết thêm logic tính tồn kho, vui lòng tham khảo FAQ
5. Cập nhật tồn kho sản phẩm
- Nếu sản phẩm có biến thể, bạn có thể tải lên nhiều biến thể của sản phẩm này để cập nhật tồn kho trong một lần gọi.
- API này chỉ hỗ trợ cập nhật một item_id trong một lần gọi. Nếu cần cập nhật nhiều hơn một item_id, bạn có thể yêu cầu nhiều lần.
- Người bán chỉ có thể cập nhật seller_stock, không thể cập nhật shopee_stock.
- Vui lòng kiểm tra stock_limit trong API v2.product.get_item_limit để biết phạm vi tồn kho có thể cập nhật.
5.1 Ví dụ cập nhật tồn kho sản phẩm không có biến thể.
{
"item_id": 1000,
"stock_list": [{"seller_stock": [{"stock": 100}]}]
}
5.2 Ví dụ cập nhật tồn kho sản phẩm có biến thể.
{
"item_id": 2000,
"stock_list": [{"model_id": 3456, "seller_stock": [{"stock": 100}]}, {"model_id": 1234, "seller_stock": [{"stock": 100}]}]
}
Lưu ý:
- Nếu sản phẩm có biến thể, chênh lệch giá giữa các biến thể không được vượt quá một bội số nhất định. Ví dụ, sản phẩm BR, giá biến thể đắt nhất chia cho giá biến thể rẻ nhất không được vượt quá 4.
| Khu vực | Bội số |
| BR | 4 |
| SG/VN/TW/TH/PH/MX | 5 |
| ID/MY | 7 |
| CL/CO | 9 |
| CNSC | 7 |
- Khi sản phẩm tham gia một số chương trình khuyến mãi nhất định, người bán không được phép chỉnh sửa giá gốc của sản phẩm. Để biết thêm chi tiết, vui lòng xem FAQ: https://open.shopee.com/faq/140
6. Cập nhật tồn kho sản phẩm toàn cầu
*Phần sau chỉ áp dụng cho người bán xuyên biên giới đã nâng cấp CNSC/KRSC.
API: v2.global_product.update_stock
- Nếu sản phẩm toàn cầu có biến thể, bạn có thể cập nhật tồn kho của nhiều biến thể trong một lần gọi.
- Vì người bán xuyên biên giới đã nâng cấp CNSC/KRSC chỉ có thể quản lý tồn kho sản phẩm shop qua sản phẩm toàn cầu, điều đó có nghĩa là bạn chỉ có thể gọi API v2.global_product.update_stock để cập nhật tồn kho. Sau khi cập nhật tồn kho sản phẩm toàn cầu, nó sẽ tự động đồng bộ sang sản phẩm shop. Việc dùng API v2.product.update_stock để cập nhật tồn kho sẽ dẫn đến lỗi.
- API này chỉ hỗ trợ cập nhật một global_item_id mỗi lần. Nếu cần cập nhật nhiều hơn một global_item_id, bạn có thể yêu cầu nhiều lần.
- Vui lòng kiểm tra stock_limit trong API v2.global_product.get_global_item_limit để biết phạm vi tồn kho có thể cập nhật.