Chuyển tới nội dung chính

v2.global_product.update_tier_variation

POST /api/v2/global_product/update_tier_variation

Cập nhật tier variation sản phẩm toàn cầu. Chỉ dành cho người bán Trung Quốc đại lục và người bán Hàn Quốc. API này chỉ có thể được dùng mà không thay đổi cấu trúc tier. Bạn có thể thêm tùy chọn, xóa tùy chọn và cập nhật hình ảnh tùy chọn qua API này.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/global_product/update_tier_variation

Tham số chung

TênKiểuMẫuMô tả
partner_idint1Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamptimestamp1610000000Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
merchant_idint1Mã định danh duy nhất của Shopee cho một merchant. Bắt buộc cho mọi yêu cầu cấp merchant (người dùng CB CNSC gọi các API liên quan đến sản phẩm toàn cầu).
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, merchant_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

TênKiểuBắt buộcMẫuMô tả
global_item_idint64True2200146923ID của sản phẩm toàn cầu.
model_listobject[]False
model_idint64True1002066586922ID của model.
tier_indexint32Truetier_variation của model.
standardise_tier_variationobject[]FalseTier variation chuẩn hóa của sản phẩm. Phải có ít nhất một trong standardise_tier_variation và tier_variation.
variation_idintTrueID tier variation chuẩn hóa.
variation_namestringFalseTên tier variation chuẩn hóa.
variation_group_idintFalseID nhóm tier variation chuẩn hóa.
variation_option_listobject[]TrueDanh sách tùy chọn tier variation chuẩn hóa.
variation_option_idintTrue
variation_option_namestringFalse
image_idstringFalse

Tham số Response

TênKiểuMẫuMô tả
errorstringCho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
messagestringCho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
warningstringThông báo cảnh báo.
request_idstring98eae35efff24dd0974c21a847127184Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.

, { "variation_option_id": 0, "variation_option_name": "Blue stripe", "image_id": "img-blue" }, { "variation_option_id": 0, "variation_option_name": "Mint stripe", "image_id": "img-mint" } ] }, { "variation_id": 0, "variation_group_id": 0, "variation_name": "Size", "variation_option_list": [ { "variation_option_id": 0, "variation_option_name": "S" }, { "variation_option_id": 0, "variation_option_name": "M" }, { "variation_option_id": 0, "variation_option_name": "L" } ] } ], "model": [ { "tier_index": [0,0], "model_sku": "SKU-Cream-S", "original_price": 100000, "seller_stock": [{"stock":3}] }, { "tier_index": [0,1], "model_sku": "SKU-Cream-M", "original_price": 100000, "seller_stock": [{"stock":2}] }, { "tier_index": [0,2], "model_sku": "SKU-Cream-L", "original_price": 100000, "seller_stock": [{"stock":0}] }, { "tier_index": [1,0], "model_sku": "SKU-Blue-S", "original_price": 100000, "seller_stock": [{"stock":1}] }, { "tier_index": [1,1], "model_sku": "SKU-Blue-M", "original_price": 100000, "seller_stock": [{"stock":4}] }, { "tier_index": [1,2], "model_sku": "SKU-Blue-L", "original_price": 100000, "seller_stock": [{"stock":3}] }, { "tier_index": [2,0], "model_sku": "SKU-Mint-S", "original_price": 100000, "seller_stock": [{"stock":1}] }, { "tier_index": [2,1], "model_sku": "SKU-Mint-M", "original_price": 100000, "seller_stock": [{"stock":2}] }, { "tier_index": [2,2], "model_sku": "SKU-Mint-L", "original_price": 100000, "seller_stock": [{"stock":5}] } ] "global_item_id": 100918870 }