v2.global_product.update_tier_variation

POST /api/v2/global_product/update_tier_variation

Update global product tier variation. Only for China mainland sellers and Korean sellers.This api can only be used without changing the tier structure, you can add options, delete options, and update the option image by this api.

Endpoint URL

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

Common Request Parameters

Name	Type	Sample	Description
partner_id	int	1	Partner ID is assigned upon registration is successful. Required for all requests.
timestamp	timestamp	1610000000	This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
merchant_id	int	1	Shopee’s unique identifier for a merchant. Required for all merchant level requests(CB CNSC user calling global product related APIs).
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by partner_id, api path, timestamp, access_token, merchant_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Request Parameters

Name	Type	Required	Sample	Description
global_item_id	int64	True	2200146923	ID of global item.
model_list	object[]	False
model_id	int64	True	1002066586922	ID of model
tier_index	int32	True		Model's tier_variation
standardise_tier_variation	object[]	False		item standardise tier variation There is at least one standardise_tier_variation and tier_variation
variation_id	int	True		standardise tier variation ID
variation_name	string	False		standardise tier variation name
variation_group_id	int	False		standardise tier variation group ID
variation_option_list	object[]	True		standardise tier variation option list
variation_option_id	int	True
variation_option_name	string	False
image_id	string	False

Response Parameters

Name	Type	Sample	Description
error	string		Indicate error type if hit error. Empty if no error happened.
message	string		Indicate error details if hit error. Empty if no error happened.
warning	string		Warning message.
request_id	string	98eae35efff24dd0974c21a847127184	The identifier for an API request for error tracking.

, { "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 }