v2.global_product.init_tier_variation

POST /api/v2/global_product/init_tier_variation

Only for China mainland sellers and Korean sellers. If you only define color, it is one tier, if you define color and size, it is two tier. Support two tier structures at most. This API can change no tier to one tier, no tier to two tier, one tier to two tier, two tier to one tier, one tier to no tier, two tier to no tier. Please create variants after an interval of 5 seconds after creating an item, as there may be a delay.

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/global_product/init_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_model	object[]	True		Model info list, model number at most 50
original_price	float	True	12.34	Original price of global model.
seller_stock	object[]	False		seller_stock of global item
location_id	string	False	CNZ	location_id of stock, if the merchant has 3PF shop, the location_id cannot be empty, can use the get_merchant_warehouse_location_list API to obtain the location_id list of the merchant, if the merchant does not have 3PF shop (only has normal CBSC shop), the location_id can be empty
stock	int64	True	100	stock
global_model_sku	string	False	sku	Sku of global model. model_sku length information needs to be no more than 100 characters.
tier_index	int32[]	True	[0,1]	Tier index of global model. Index starts from 0. 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 global_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.
weight	float	False	1.1	The weight of this global model, the unit is KG. If don't set the weight of this global model, will use the weight of global item by default. If set the dimension of this global model, them must set the weight of this global model.
dimension	object	False		The dimension of this global model. If don't set the dimension of this global model, will use the dimension of global item by default.
package_height	int32	True	11	The height of package for this global model, the unit is CM.
package_length	int32	True	11	The length of package for this global model, the unit is CM.
package_width	int32	True	11	The width of package for this global model, the unit is CM.
pre_order	object	False		Pre-order information of this global model. Notes: If don't set the DTS of this global model, will use the DTS of the global item by default.
days_to_ship	int32	True	2	Days to ship. Please get the days_to_ship range from the get_dts_limit API.
global_item_id	int32	True	22001469	ID of global item.
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 global_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		standardise tier variation ID
variation_name	string	False		standardise tier variation name
variation_group_id	int32	False		standardise tier variation group ID
variation_option_list	object[]	True		standardise tier variation option list
variation_option_id	int32	True		standardise tier variation option ID
variation_option_name	string	False		standardise tier variation option value
image_id	string	False		standardise tier variation option image ID

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.