v2.product.init_tier_variation
POST /api/v2/product/init_tier_variation
This API allows you to update the tier structure of a product. Defining only color creates one tier, while color + size creates two tiers (tối đa supported). Supported changes include: no tier ↔ one/two tiers, one tier ↔ two/no tier, and two tiers ↔ one/no tier. For details, see Developer Guide. Please wait at least 5 seconds after creating an item before creating variants, as processing may be delayed.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/product/init_tier_variation
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để chỉ định thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| item_id | int64 | True | 1000 | ID of item |
| model | object[] | True | Model info list, model number at most 50 | |
| tier_index | int32[] | True | [0] | Tier index of this model. If you want to update one tier/two tier to no tier, can just pass the tier_variation and standardise_tier_variation as [], and pass the model >> tier_index as [], meanwhile pass the original_price, seller_stock, etc., to set the price and stock for the modified product with no tier structure. |
| original_price | float | True | 38.3 | Giá gốc of this model. **For CO local VAT responsible seller：**Please remember the price you set in here must be VAT inclusive. If you have any doubts on how to calculate VAT for your product please refer to the Seller Education Hub（https://seller.shopee.com.co/edu/article/13565） |
| model_sku | string | False | SKU | Seller SKU of this model, model_sku length information needs to be no more than 100 characters. |
| seller_stock | object[] | True | new stock info（Please notice that stock(including Seller Stock and Shopee Stock) should be larger than or equal to real-time reserved stock） | |
| location_id | string | False | location id, you can get the location id from v2.shop.get_warehouse_detail api, if seller don't have any warehouse, you don't need to upload this field. | |
| stock | int32 | True | stock | |
| gtin_code | string | False | - GTIN is an identifier for trade items, developed by the international organization GS1. - They have 8 to 14 digits. The most common are UPC, EAN, JAN and ISBN. - GTIN will help boost positioning in online marketing channels like Google and Facebook. - That incorporation with GTIN will also aid in Search and Recommendation in Shopee itself allowing buyers to have higher likelihood of finding one's listing. Note: If you want to set “Item without GTIN”, please pass the gtin_code as "00". The validation rule is based on the value return in gtin_validation_rule" field in v2.product.get_item_limit API - Mandatory: This field is required and must contain a correctly formatted GTiN number. - Flexible: This field is required and must contain either a correctly formatted GTlN number or "00" to declare that the item/model has no valid GTlN. - Optional: This field is optional and can contain a correctly formatted GTiN number, "00" or be omitted entirely. | |
| weight | float | False | 1.1 | The weight of this model, the unit is KG. If don't set the weight of this model, will use the weight of item by default. If set the dimension of this model, them must set the weight of this model. |
| dimension | object | False | The dimension of this model. If don't set the dimension of this model, will use the dimension of item by default. | |
| package_height | int32 | True | 11 | The height of package for this model, the unit is CM. |
| package_length | int32 | True | 11 | The length of package for this model, the unit is CM. |
| package_width | int32 | True | 11 | The width of package for this model, the unit is CM. |
| pre_order | object | False | Đặt hàng trước information of this model. Notes: If don't set the DTS of this model, will use the DTS of the item by default. | |
| is_pre_order | boolean | True | false | Whether the model is pre order. |
| days_to_ship | int32 | False | 2 | Số ngày giao hàng. Please get the days_to_ship range from the get_dts_limit API. |
| standardise_tier_variation | object[] | False | There is at least one standardise_tier_variation and tier_variation. If you want to update one tier/two tier to no tier, can just pass the tier_variation and standardise_tier_variation as [], and pass the model >> tier_index as [], meanwhile pass the original_price, seller_stock, etc., to set the price and stock for the modified product with no tier structure. | |
| variation_id | int32 | True | 1 | standardise biến thể theo cấp ID. |
| variation_name | string | False | name1 | standardise biến thể theo cấp name |
| variation_group_id | int32 | False | 2 | standardise biến thể theo cấp group ID |
| variation_option_list | object[] | True | standardise biến thể theo cấp option list | |
| variation_option_id | int32 | False | standardise biến thể theo cấp option ID. | |
| variation_option_name | string | False | option2 | standardise biến thể theo cấp option value |
| image_id | string | False | 82becb4830bd2ee90ad6acf8a9dc26d7 | standardise biến thể theo cấp option image ID |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi. | |
| message | string | Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi. | |
| warning | string | Warning message. | |
| request_id | string | The identifier for an API request for error tracking | |
| response | object | ||
| item_id | int64 | 1234 | ID of item |
| tier_variation | object[] | Variations of item | |
| name | string | Color | Tên biến thể |
| option_list | object[] | Options of this variation | |
| image | object | Image of this option | |
| image_url | string | https://cf.shopee.sg/file/82becb4830bd2ee90ad6acf8a9dc26d7 | URL of image |
| option | string | Red | Option name |
| model | object[] | ||
| tier_index | object[] | Tier index of model. Index starts from 0. | |
| model_id | int64 | 3813 | ID of model |
| model_sku | string | SKU | Seller SKU of this model |
| price_info | object[] | ||
| original_price | float | Giá gốc | |
| seller_stock | object[] | new stock info | |
| location_id | string | location id | |
| stock | int32 | stock | |
| weight | float | 1.1 | The weight of this model, the unit is KG. If don't set the weight of this model, will use the weight of item by default. If set the dimension of this model, them must set the weight of this model. |
| dimension | object | The dimension of this model. If don't set the dimension of this model, will use the dimension of item by default. | |
| package_height | int32 | 11 | The height of package for this model, the unit is CM. |
| package_length | int32 | 11 | The length of package for this model, the unit is CM. |
| package_width | int32 | 11 | The width of package for this model, the unit is CM. |
Dữ liệu gử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}] }
]
}Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/product/init\_tier\_variation?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp")
.header("Content-Type","application/json")
.body("{
"model": [
{
"gtin_code": "-",
"model_sku": "SKU",
"original_price": 38.3,
"seller_stock": [
{
"location_id": "-",
"stock": 0
}
],
"weight": 1.1
}
],
"standardise_tier_variation": [
{
"variation_group_id": 2,
"variation_id": 1,
"variation_name": "name1",
"variation_option_list": [
{
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7",
"variation_option_id": 0,
"variation_option_name": "option2"
}
]
}
],
"tier_variation": [
{
"name": "Color",
"option_list": [
{
"image": {
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7"
},
"option": "Red"
}
]
}
]
}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/product/init\_tier\_variation?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => '{
"model": [
{
"gtin_code": "-",
"model_sku": "SKU",
"original_price": 38.3,
"seller_stock": [
{
"location_id": "-",
"stock": 0
}
],
"weight": 1.1
}
],
"standardise_tier_variation": [
{
"variation_group_id": 2,
"variation_id": 1,
"variation_name": "name1",
"variation_option_list": [
{
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7",
"variation_option_id": 0,
"variation_option_name": "option2"
}
]
}
],
"tier_variation": [
{
"name": "Color",
"option_list": [
{
"image": {
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7"
},
"option": "Red"
}
]
}
]
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location --request POST 'https://partner.shopeemobile.com/api/v2/product/init\_tier\_variation?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp'
--header 'Content-Type: application/json'
--data-raw '{
"model": [
{
"gtin_code": "-",
"model_sku": "SKU",
"original_price": 38.3,
"seller_stock": [
{
"location_id": "-",
"stock": 0
}
],
"weight": 1.1
}
],
"standardise_tier_variation": [
{
"variation_group_id": 2,
"variation_id": 1,
"variation_name": "name1",
"variation_option_list": [
{
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7",
"variation_option_id": 0,
"variation_option_name": "option2"
}
]
}
],
"tier_variation": [
{
"name": "Color",
"option_list": [
{
"image": {
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7"
},
"option": "Red"
}
]
}
]
}'
import requests
import json
url = "https://partner.shopeemobile.com/api/v2/product/init\_tier\_variation?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign×tamp=timestamp"
payload=json.dumps({
"model": [
{
"gtin_code": "-",
"model_sku": "SKU",
"original_price": 38.3,
"seller_stock": [
{
"location_id": "-",
"stock": 0
}
],
"weight": 1.1
}
],
"standardise_tier_variation": [
{
"variation_group_id": 2,
"variation_id": 1,
"variation_name": "name1",
"variation_option_list": [
{
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7",
"variation_option_id": 0,
"variation_option_name": "option2"
}
]
}
],
"tier_variation": [
{
"name": "Color",
"option_list": [
{
"image": {
"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7"
},
"option": "Red"
}
]
}
]
})
headers = {
'Content-Type': 'application/json'
}
response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False)
print(response.text)
, "option": "Cream stripe" }, { "image": { "image_url": "https://cf.shopee.sg/file/img-blue" }, "option": "Blue stripe" }, { "image": { "image_url": "https://cf.shopee.sg/file/img-mint" }, "option": "Mint stripe" } ] }, { "name": "Size", "option_list": [ { "option": "S" }, { "option": "M" }, { "option": "L" } ] } ], "model": [ { "tier_index": [0,0], "model_id": 43464493931, "model_sku": "SKU-Cream-S", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 3 }], "weight": 1.1 }, { "tier_index": [0,1], "model_id": 43464493932, "model_sku": "SKU-Cream-M", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 2 }], "weight": 1.1 }, { "tier_index": [0,2], "model_id": 43464493933, "model_sku": "SKU-Cream-L", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 0 }], "weight": 1.1 }, { "tier_index": [1,0], "model_id": 43464493934, "model_sku": "SKU-Blue-S", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 1 }], "weight": 1.1 }, { "tier_index": [1,1], "model_id": 43464493935, "model_sku": "SKU-Blue-M", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 4 }], "weight": 1.1 }, { "tier_index": [1,2], "model_id": 43464493936, "model_sku": "SKU-Blue-L", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 3 }], "weight": 1.1 }, { "tier_index": [2,0], "model_id": 43464493937, "model_sku": "SKU-Mint-S", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 1 }], "weight": 1.1 }, { "tier_index": [2,1], "model_id": 43464493938, "model_sku": "SKU-Mint-M", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 2 }], "weight": 1.1 }, { "tier_index": [2,2], "model_id": 43464493939, "model_sku": "SKU-Mint-L", "price_info": [{ "original_price": 100000 }], "seller_stock": [{ "location_id": "-", "stock": 5 }], "weight": 1.1 } ] } }