商品上传接口
接口请求地址
测试地址:http://erppushtest.kuaidaoyun.com/api/yunfan/itemcreate
正式地址:(联系云帆技术支持获取,官方微信号:19180611683对接联调)
测试账号
【app_id】: i1hY3vOmCBWAB9ddDSDTN1RL
【appSecret】: 37f2af0405eaea09c363115273eb02df05cdba7f
正式环境的请求地址及账号信息,请在云帆ERP系统中进行申请。
请求参数
字段 |
类型 |
必需 |
默认 |
注释 |
sign |
String |
是 |
|
签名,MD5(app_id + PostBody + appSecret) |
PostBody数据
参数名称 |
参数类型 |
必需 |
参数说明 |
示例值 |
app_id |
String |
是 |
系统中申请的appId |
10001 |
msg_id |
String |
是 |
请求消息Id |
1000168313316464 |
data |
Spu |
是 |
订单详情结构体Data数据 |
详见下面【商品Spu结构体】的说明 |
timestamp |
Long |
是 |
毫秒级时间戳 |
1603070658889 |
签名说明:
sign=MD5(app_id + PostBody + appSecret)转小写
注意:由于JSON没有明确的跨语言规范,因此对JSON解析之后再进行重新编码,并不一定能还原原始JSON字符串。所以请严格按照原始报文进行签名和验签!
商品Spu结构体
参数名称 |
参数类型 |
必需 |
参数说明 |
示例值 |
product_id |
Long |
是 |
平台spu编码(编码重复时,做数据更新) |
|
product_type |
Integer |
是 |
商品类型(0:普通商品;10:分销商品) |
|
product_full_name |
String |
是 |
商品名称 |
|
sale_state |
Integer |
是 |
商品上下架状态(1:上架状态;0:下架状态) |
|
create_time |
String |
是 |
商品创建时间 |
|
modified_time |
String |
是 |
商品更新时间 |
|
sku_info |
SkuList [] |
是 |
商品Sku列表 |
详见下面【商品Sku列表结构体 SkuList】的说明 |
ori_product_id |
String |
否 |
商家spu编码 |
“” |
商品Sku列表结构体 SkuList
参数名称 |
参数类型 |
必需 |
参数说明 |
示例值 |
product_sku_id |
Long |
是 |
平台sku编码(编码重复时,做数据更新) |
|
product_sku_spec |
ProductSkuSpec[] |
是 |
sku规格信息 |
详见下面【sku规格信息结构体 ProductSkuSpec】的说明 |
state |
Integer |
是 |
数据状态(0:有效;1:失效) |
|
create_time |
String |
是 |
sku创建时间 |
|
modified_time |
String |
是 |
sku更新时间 |
|
sku_images |
String |
是 |
sku图片地址信息 |
|
sale_price |
Integer |
否 |
sku销售价格,单位分 默认:0 |
|
ori_sku_id |
String |
否 |
商家sku编码 |
69码 |
product_sku_cost |
Integer |
否 |
sku成本价格,单位分 默认:0 |
|
stock_amount |
Integer |
否 |
sku库存数量 默认:0 |
0 |
sku规格信息结构体 ProductSkuSpec
参数名称 |
参数类型 |
必需 |
参数说明 |
示例值 |
spec_name |
String |
是 |
规格名称 |
颜色 |
spec_value |
String |
是 |
规格值 |
红色 |
请求接口的说明
1、数据编码采用UTF-8格式,application/json格式
2、采用HTTP或HTTPS传输协议,POST方法
{
"data":{
"product_id":4000001,
"ori_product_id":"1111001",
"product_type":10,
"product_full_name":"鹿测试商品王撒迪斯羊毛厚款开衫2216",
"sale_state":0,
"create_time":"01/01/0001 00:00:00",
"modified_time":"12/31/9999 23:59:59",
"sku_info":[
{
"product_sku_id":14003316,
"product_sku_spec":[
{
"spec_name":"颜色",
"spec_value":"碳灰100号"
}
],
"state":0,
"create_time":"10/27/2020 17:30:55",
"modified_time":"10/27/2020 17:30:55",
"sku_images":"http://img.yzcdn.cn/upload_files/2018/08/10/FnyJwXDY7dylI2q1c23tl1AxctZ7.jpg",
"sale_price":31810,
"ori_sku_id":"1111000001",
"product_sku_cost":21982,
"stock_amount":0
}
]
},
"app_id":"i1hY3vOmCBWAB9ddDSDTN1RL",
"msg_id":"035fd89b-50b7-4f90-b208-48e5a9d6eea1",
"timestamp":1603819855123
}
响应参数
参数名称 |
参数类型 |
参数说明 |
示例值 |
success |
boolean |
表示本次请求是否成功。 true:成功 false:失败 |
true |
message |
String |
网关返回码描述 |
not found |
status |
int |
网关返回码,表示本次请求是否成功。200 :成功。 |
200 |
成功示例
{
“status”: 200, //状态码
“success”: true,
“message”: null
}
异常示例(注意大小写格式)
{
“Status”: 1001, //状态码
“Success”: false,
“Message”: “sign is error”
}