商品上传

商品上传接口

接口请求地址

测试地址:http://erppushtest.kuaidaoyun.com/api/yunfan/itemcreate
正式地址:
测试账号
【app_id】: i1hY3vOmCBWAB9ddDSDTN1RL
【appSecret】: 37f2af0405eaea09c363115273eb02df05cdba7f
正式环境的请求地址及账号信息,请在云帆ERP系统中进行申请。

请求参数

Headers参数

字段 类型 必需 默认 注释
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”
}