商品上传
<p>[TOC]</p>
<h1>商品上传接口</h1>
<h3>接口请求地址</h3>
<p>测试地址:<a href="http://erppushtest.kuaidaoyun.com/api/yunfan/itemcreate">http://erppushtest.kuaidaoyun.com/api/yunfan/itemcreate</a>
正式地址:(联系云帆技术支持获取,官方微信号:19180611683对接联调)
测试账号
【app_id】: i1hY3vOmCBWAB9ddDSDTN1RL
【appSecret】: 37f2af0405eaea09c363115273eb02df05cdba7f
正式环境的请求地址及账号信息,请在云帆ERP系统中进行申请。</p>
<h2>请求参数</h2>
<h3>Headers参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">字段</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">必需</th>
<th>默认</th>
<th>注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td></td>
<td>签名,MD5(app_id + PostBody + appSecret)</td>
</tr>
</tbody>
</table>
<h3>PostBody数据</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名称</th>
<th style="text-align: center;">参数类型</th>
<th style="text-align: center;">必需</th>
<th style="text-align: center;">参数说明</th>
<th style="text-align: center;">示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">app_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">系统中申请的appId</td>
<td style="text-align: center;">10001</td>
</tr>
<tr>
<td style="text-align: center;">msg_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">请求消息Id</td>
<td style="text-align: center;">1000168313316464</td>
</tr>
<tr>
<td style="text-align: center;">data</td>
<td style="text-align: center;">Spu</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单详情结构体Data数据</td>
<td style="text-align: center;">详见下面【商品Spu结构体】的说明</td>
</tr>
<tr>
<td style="text-align: center;">timestamp</td>
<td style="text-align: center;">Long</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">毫秒级时间戳</td>
<td style="text-align: center;">1603070658889</td>
</tr>
</tbody>
</table>
<h3>签名说明:</h3>
<p>sign=MD5(app_id + PostBody + appSecret)转小写
注意:由于JSON没有明确的跨语言规范,因此对JSON解析之后再进行重新编码,并不一定能还原原始JSON字符串。所以请严格按照原始报文进行签名和验签!</p>
<h2>商品Spu结构体</h2>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名称</th>
<th style="text-align: center;">参数类型</th>
<th style="text-align: center;">必需</th>
<th style="text-align: center;">参数说明</th>
<th style="text-align: center;">示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">product_id</td>
<td style="text-align: center;">Long</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">平台spu编码(编码重复时,做数据更新)</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">product_type</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品类型(0:普通商品;10:分销商品)</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">product_full_name</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品名称</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">sale_state</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品上下架状态(1:上架状态;0:下架状态)</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">create_time</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品创建时间</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">modified_time</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品更新时间</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">sku_info</td>
<td style="text-align: center;">SkuList []</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品Sku列表</td>
<td style="text-align: center;">详见下面【商品Sku列表结构体 SkuList】的说明</td>
</tr>
<tr>
<td style="text-align: center;">ori_product_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商家spu编码,25个字符</td>
<td style="text-align: center;">""</td>
</tr>
</tbody>
</table>
<h2>商品Sku列表结构体 SkuList</h2>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名称</th>
<th style="text-align: center;">参数类型</th>
<th style="text-align: center;">必需</th>
<th style="text-align: center;">参数说明</th>
<th style="text-align: center;">示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">product_sku_id</td>
<td style="text-align: center;">Long</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">平台sku编码(编码重复时,做数据更新)</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">product_sku_spec</td>
<td style="text-align: center;">ProductSkuSpec[]</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">sku规格信息</td>
<td style="text-align: center;">详见下面【sku规格信息结构体 ProductSkuSpec】的说明</td>
</tr>
<tr>
<td style="text-align: center;">state</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">数据状态(0:有效;1:失效)</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">create_time</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">sku创建时间</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">modified_time</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">sku更新时间</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">sku_images</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">sku图片地址信息</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">sale_price</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">sku销售价格,单位分 默认:0</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">ori_sku_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商家sku编码,25个字符</td>
<td style="text-align: center;">69码</td>
</tr>
<tr>
<td style="text-align: center;">product_sku_cost</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">sku成本价格,单位分 默认:0</td>
<td style="text-align: center;"></td>
</tr>
<tr>
<td style="text-align: center;">stock_amount</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">sku库存数量 默认:0</td>
<td style="text-align: center;">0</td>
</tr>
</tbody>
</table>
<h2>sku规格信息结构体 ProductSkuSpec</h2>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名称</th>
<th style="text-align: center;">参数类型</th>
<th style="text-align: center;">必需</th>
<th style="text-align: center;">参数说明</th>
<th style="text-align: center;">示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">spec_name</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">规格名称</td>
<td style="text-align: center;">颜色</td>
</tr>
<tr>
<td style="text-align: center;">spec_value</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">规格值</td>
<td style="text-align: center;">红色</td>
</tr>
</tbody>
</table>
<h3>请求接口的说明</h3>
<p>1、数据编码采用UTF-8格式,application/json格式
2、采用HTTP或HTTPS传输协议,POST方法</p>
<pre><code class="language-json">{
"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
}</code></pre>
<h2>响应参数</h2>
<table>
<thead>
<tr>
<th style="text-align: center;">参数名称</th>
<th style="text-align: center;">参数类型</th>
<th style="text-align: center;">参数说明</th>
<th style="text-align: center;">示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">success</td>
<td style="text-align: center;">boolean</td>
<td style="text-align: center;">表示本次请求是否成功。 true:成功 false:失败</td>
<td style="text-align: center;">true</td>
</tr>
<tr>
<td style="text-align: center;">message</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">网关返回码描述</td>
<td style="text-align: center;">not found</td>
</tr>
<tr>
<td style="text-align: center;">status</td>
<td style="text-align: center;">int</td>
<td style="text-align: center;">网关返回码,表示本次请求是否成功。200 :成功。</td>
<td style="text-align: center;">200</td>
</tr>
</tbody>
</table>
<h2>成功示例</h2>
<p>{
"status": 200, //状态码
"success": true,
"message": null
}</p>
<h2>异常示例(注意大小写格式)</h2>
<p>{
"Status": 1001, //状态码
"Success": false,
"Message": "sign is error"
}</p>