Last Updated on : 2022-09-27 06:12:08download
Add a commodity to the commodity database of a specified store.
POST: /v1.0/sellercenter/commodity
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. |
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. |
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
}
]
}
{
"result": {
"commodity_code": "CMaplyr4bzck***"
},
"t": 1624969838836,
"success": true
}
For more information, see error code.
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedback