v2.global_product.add_global_model
POST /api/v2/global_product/add_global_model
Add global model. Only for China mainland sellers and Korean sellers.
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/global_product/add_global_model
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 | 37001402 | ID of global item. |
| global_model | object[] | True | Global model setting list. Limit is [1,50]. | |
| 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 | [1] | Tier index 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 | int32 | True | 100 | stock |
| original_price | float | True | 123.21 | Original price of global item. |
| 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. |
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. |
], "original_price":99.9 } ] }