<返回添加商品

Items/addItems

接口说明

添加商品

访问权限

access token方式

请求URL地址

支持格式

XML/JSON

是否使用HTTPS连接

HTTP请求方式

POST

是否需要登录

调用示例

https://api.100msh.com:543/v1/Items/addItems.json?access_token=your_token&partner_id=13&url_identifying=mN7XaN

请求参数说明

字段 说明 类型
goods_info

商品所需数据数组

json
goods 详见下表

array

itempropvalue 详见下表 array
salesprop 详见下表 array
addition 详见下表 array
images 详见下表 array
goods

商品基本信息

array
cate_id 商品分类ID

int

type_id 商品类型ID int
partner_cate_id 商家商品分类ID int
brand_id 关键字品牌ID int
item_model 商品型号 string
item_code 条形码 string
cost_price 成本价 string
was_price 市场价 string
now_price 商城价 string
item_spec 销售规格(如:600ml) string
item_unit 商品销售单位 string
item_weight 商品重量(单位:kg) string
item_name 商品名 string
item_promo_title 商品促销语 string
item_keyword 关键字 string
item_size 商品(,,) string
is_public 是否公开 int
createdby 添加人 string
creationdate 添加时间 string
modifiedby 最后修改人 string
is_nature0 到店消费 int
is_nature1 上门服务 int
is_nature2 免费配送 int
is_sales 销售/展示 int
itempropvalue

拓展属性

array
prop_ids 拓展属性id组合数组array(1,2,3...)

string

prop_value 属性值数组 array
salesprop

销售属性

array
salesprop_ids 销售属性组成的字符串1,2,3...

string

salesprop_group_id   int
salesprop_value_id_arr 销售属性组成的数组array(1,2,3....) array
addition

附加属性

array
item_desc 销售属性组成的字符串1,2,3...

string

salesprop_group_id   int
salesprop_value_id_arr 销售属性组成的数组array(1,2,3....) array
salesprop_value_id_arr 销售属性组成的数组array(1,2,3....) array
images

商品图片

array
image_order 商品图片排序

int

is_add_env_watermark 是否打环保水印 int
up_file

商品图片

file
api参数
字段 说明 类型 是否必填
partner_id 商家ID int
url_identifying 商家授权标识 string
goods_info

商家商品分类信息

{
"goods": {
"cate_id": 913,
"type_id": 2,
"partner_cate_id": 228,
"brand_id": "0",
"item_model": "商品型号",
"item_code": "dsdsds",
"cost_price": "11",
"was_price": "22",
"now_price": "333",
"item_spec": "销售规格",
"item_unit": "件",
"item_weight": "12",
"item_name": "QQ_Q1",
"item_promo_title": "促销语",
"item_keyword": "商品关键字",
"item_size": "12,12,12",
"is_public": 0,
"modifiedby": "25",
"is_nature0": "1",
"is_nature1": "0",
"is_nature2": "0",
"is_sales": "1"
},
"itempropvalue": {
"prop_ids": "3,1",
"prop_value": {
"1": "属性三",
"3": "M"
}
},
"salesprop": {
"salesprop_ids": "",
"salesprop_group_id": "",
"salesprop_value_id_arr": []
},
"addition": {
"item_desc": "详细信息",
"specifications": "参数规格",
"packing_list": "包装清单",
"sales_service": "售后服务"
},
"image_order": [],
"is_add_env_watermark": ""
}

array
up_file 商品图片 file
验证参数

access_token:授权的access token。

返回结果示例

XML示例

<?xml version="1.0" encoding="UTF-8" ?> 
<response>
    <data>
        <insert_id> 214</insert_id>
     </data>
</response>

JSON示例

{
"insert_id": 214
}

返回结果字段说明

字段 说明 类型
result 当前执行ID int

错误代码释义

错误代码 说明
4000801 参数partner_id(商家ID)不合法,请检查
4000825 添加失败,数组goods_info(商品信息)为空,请检查
4000848 添加失败 ,商品编号生成失败,请检查cate_id参数
4000845 添加商品失败,请检查