Add Commodity
Last Updated on : 2022-09-27 06:12:08download
Add a commodity to the commodity database of a specified store.
API address
POST: /v1.0/sellercenter/commodity
Request parameter
Description of body
| Parameter name | Type | IN | Required | Description |
|---|---|---|---|---|
| title | String | true | The commodity title with up to 80 characters. | |
| description | String | false | The commodity description with up to 250 characters. | |
| brand | String | false | The commodity brand with up to 30 characters. | |
| code | String | false | The commodity code or model with up to 50 characters. | |
| pid | String | false | The commodity PID with up to 16 characters. | |
| first_category_code | String | true | The code of the level-1 category. | |
| second_category_code | String | true | The code of the level-2 category. | |
| third_category_code | String | true | The code of the level-3 category. | |
| video | String | false | The video to display a commodity. When this API is used, you must upload a video URL, so the video file can be accessed by using a browser. It only supports a video in the MP4 format, no more than 50 MB. The recommended duration is 9-30 seconds. | |
| video_pic | String | false | The image to display a video. When this API is used, you must upload an image URL, so the image file can be accessed by using a browser. The field is required when video is not empty. | |
| show_pictures | List | true | The image to display a commodity. When this API is used, you must upload an image URL, so the image file can be accessed by using a browser. It supports up to 10 images in JPG, PNG, or GIF format, each of which is no more than 500 KB. The recommended dimension is 750 × 750 pixels. | |
| detail_pictures | List | true | The image to display commodity details. When this API is used, you must upload an image URL, so the image file can be accessed by using a browser. It supports up to 15 images in JPG, PNG, or GIF format, each of which is no more than 3 MB. The recommended dimension is 750 × 750 pixels. | |
| sku_list | List | true | The list of SKUs. Maximum value: 100. | |
| postage_type | Integer | true | The type of postage. Valid values:
| |
| postage_fee | BigDecimal | false | The postage fee of a specified commodity. The field is required if postageType is 2. | |
| install_type | Integer | false | The installation type. Valid values:
| |
| install_fee | BigDecimal | false | The installation fee. | |
| is_jump | Boolean | false | Indicates whether to navigate to a third-party page. Valid values:
| |
| jump_link | String | false | The navigation link of a specified commodity. The field is required if isJump is set to true. | |
| publish | Boolean | false | Indicates whether to list a specified commodity. Valid values:
| |
| mall_code | String | true | The code of a specified mall. | |
| site_code | String | true | The code of a specified site. |
Description of sku_list
| Parameter name | Type | IN | Required | Description |
|---|---|---|---|---|
| original_price | BigDecimal | false | The original price of the SKU. It supports up to two decimal places. | |
| sale_price | BigDecimal | true | The sales price of the SKU. It supports up to two decimal places. | |
| inventory | Integer | true | The inventory. It supports an integer. | |
| weight | BigDecimal | true | The weight in kilograms (KG). It supports up to three decimal places. | |
| external_code | String | true | The external code. | |
| sku_attr_list | List | true | The list of SKU attributes. |
Description of sku_attr_list
| Parameter name | Type | IN | Required | Description |
|---|---|---|---|---|
| attr_code | String | true | The code of a specified attribute. | |
| attr_value_id | Long | true | The ID of a specific attribute value. |
Return parameter
| Parameter name | Type | Description |
|---|---|---|
| result | CommodityAddOpenApiVO | The returned result. |
Description of result
| Parameter name | Type | Description |
|---|---|---|
| commodity_code | String | The unique code of a specified commodity. |
Request example
POST: /v1.0/sellercenter/commodity
{
"mall_code": "8h4tiureddm***",
"site_code": "CN",
"title": "Refrigerator",
"brand": "",
"code": "define_code",
"detail_pictures": [
"http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
],
"first_category_code": "12",
"second_category_code": "1312",
"third_category_code": "131211",
"install_fee": 1,
"install_type": 2,
"is_jump": false,
"pid": "",
"postage": 100,
"postage_type": 1,
"publish": true,
"show_pictures": [
"http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
],
"video": "",
"video_pic": "",
"sku_list": [
{
"external_code": "",
"inventory": 100,
"original_price": 1,
"sale_price": 2,
"sku_attr_list": [
{
"attr_code": "COLOR",
"attr_value_id": 1001
}
],
"weight": 0
}
]
}
Return example
{
"result": {
"commodity_code": "CMaplyr4bzck***"
},
"t": 1624969838836,
"success": true
}
Error code
For more information, see error code.
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedbackMarketing Cooperation
Business Cooperation
Customer Service
Media Inquiry
© 2023 Tuya Inc.