云帆ERPAPI

云帆ERP开放平台API


商品上传

<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;">&quot;&quot;</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>{ &quot;status&quot;: 200, //状态码 &quot;success&quot;: true, &quot;message&quot;: null }</p> <h2>异常示例(注意大小写格式)</h2> <p>{ &quot;Status&quot;: 1001, //状态码 &quot;Success&quot;: false, &quot;Message&quot;: &quot;sign is error&quot; }</p>

页面列表

ITEM_HTML