订单上传
<p>[TOC]</p>
<h1>订单上传接口</h1>
<p>此接口每次上传一个订单信息到云帆,如果有订单更新(不能变更和增减订单的商品的交易明细id),也使用本接口直接推送订单到云帆,开发者请注意严格遵守报文结构要求。
订单状态Status的取值说明:
WAIT_SELLER_SEND_GOODS:等待卖家发货,即:买家已付款
WAIT_BUYER_CONFIRM_GOODS :等待买家确认收货,即:卖家已发货
TRADE_SUCCESS:买家已签收或交易成功
TRADE_CLOSED:交易关闭
订单上传状态流转顺序: <strong>注意:订单状态变更重复推送时,请保证 【tid】和【oid】保持一致</strong>
等待卖家发货-->交易成功;
等待卖家发货-->交易关闭;
等待卖家发货-->等待买家确认收货-->交易成功;
等待卖家发货-->等待买家确认收货-->交易关闭;</p>
<h3>接口请求地址</h3>
<p>测试地址:<a href="http://erppushtest.kuaidaoyun.com/api/yunfan/extopentrade">http://erppushtest.kuaidaoyun.com/api/yunfan/extopentrade</a>
正式地址:(联系云帆技术支持获取,官方微信号:19180611683对接联调)</p>
<p>测试账号
【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;">Data</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单详情结构体Data数据</td>
<td style="text-align: center;">详见下面【订单详情结构体Data】的说明</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>订单详情结构体 Data</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;">order_info</td>
<td style="text-align: center;">OrderInfo</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;">address_info</td>
<td style="text-align: center;">AddressInfo</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;">pay_info</td>
<td style="text-align: center;">PayInfo</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;">orders</td>
<td style="text-align: center;">Orders[]</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;">remark_info</td>
<td style="text-align: center;">RemarkInfo</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单备注</td>
<td style="text-align: center;">null</td>
</tr>
</tbody>
</table>
<h2>订单详情结构体 OrderInfo</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;">tid</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单编号 35位长度以内,仅允许字母数字与中横线</td>
<td style="text-align: center;">C20190729143007187567</td>
</tr>
<tr>
<td style="text-align: center;">pay_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;">2019-08-20 19:09:37</td>
</tr>
<tr>
<td style="text-align: center;">created</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;">2019-08-20 20:09:37</td>
</tr>
<tr>
<td style="text-align: center;">type</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">主订单类型 0:普通订单; 1:送礼订单; 2:代付; 3:分销采购单; 4:赠品; 5:心愿单; 10:拼团; 15:返利; 35:酒店; 40:外卖; 71:美业预约单; 72:美业服务单; 81:礼品卡</td>
<td style="text-align: center;">0</td>
</tr>
<tr>
<td style="text-align: center;">status</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">主订单状态: WAIT_SELLER_SEND_GOODS:等待卖家发货,即:买家已付款, WAIT_BUYER_CONFIRM_GOODS 等待买家确认收货,即:卖家已发货, TRADE_SUCCESS:买家已签收以及订单成功, TRADE_CLOSED:交易关闭</td>
<td style="text-align: center;">WAIT_SELLER_SEND_GOODS</td>
</tr>
<tr>
<td style="text-align: center;">consign_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;">2019-08-20 20:09:37</td>
</tr>
<tr>
<td style="text-align: center;">success_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;">2019-08-20 17:20:28</td>
</tr>
<tr>
<td style="text-align: center;">confirm_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;">2019-08-21 20:09:37</td>
</tr>
<tr>
<td style="text-align: center;">offline_id</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;">2546481</td>
</tr>
<tr>
<td style="text-align: center;">update_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;">2019-08-20 10:19:52</td>
</tr>
<tr>
<td style="text-align: center;">is_retail_order</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">是否零售订单,true:是,false:否</td>
<td style="text-align: center;">false</td>
</tr>
<tr>
<td style="text-align: center;">pay_type</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单支付类型 0:默认值</td>
<td style="text-align: center;">0</td>
</tr>
<tr>
<td style="text-align: center;">close_type</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单关闭类型 0:默认值,0:未关闭; 1:过期关闭; 2:标记退款; 3:订单取消; 4:买家取消; 5:卖家取消; 6:部分退款; 18:扣款失败; 19:0元关单; 22:拒单退款;</td>
<td style="text-align: center;">1</td>
</tr>
</tbody>
</table>
<h2>地址详情结构体 AddressInfo</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;">receiver_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;">delivery_address</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;">翠苑街道黄龙万科中心18楼</td>
</tr>
<tr>
<td style="text-align: center;">delivery_province</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;">delivery_city</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;">delivery_district</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;">receiver_tel</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;">13700000000</td>
</tr>
<tr>
<td style="text-align: center;">delivery_postal_code</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;">330106</td>
</tr>
</tbody>
</table>
<h2>支付结构体 PayInfo</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;">payment</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单实付金额,订单上每个商品最终均摊价,单位:分</td>
<td style="text-align: center;">5</td>
</tr>
<tr>
<td style="text-align: center;">total_fee</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单优惠前总金额,单位:分</td>
<td style="text-align: center;">5</td>
</tr>
<tr>
<td style="text-align: center;">post_fee</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单邮费金额,单位:分</td>
<td style="text-align: center;">5</td>
</tr>
<tr>
<td style="text-align: center;">outer_transactions</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;">OR1533766114265956211</td>
</tr>
<tr>
<td style="text-align: center;">transaction</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;">TR1533766114265956211</td>
</tr>
</tbody>
</table>
<h2>商品明细结构体 Orders</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;">num</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品数量</td>
<td style="text-align: center;">6</td>
</tr>
<tr>
<td style="text-align: center;">oid</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;">1533766114265956211</td>
</tr>
<tr>
<td style="text-align: center;">title</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;">测试商品02</td>
</tr>
<tr>
<td style="text-align: center;">price</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">单商品原价,单位:分</td>
<td style="text-align: center;">8</td>
</tr>
<tr>
<td style="text-align: center;">payment</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">订单明细应付金额,订单上每个商品最终均摊价,单位:分</td>
<td style="text-align: center;">50</td>
</tr>
<tr>
<td style="text-align: center;">total_fee</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品总价(扣除商品级优惠) 单位:分</td>
<td style="text-align: center;">45</td>
</tr>
<tr>
<td style="text-align: center;">pic_path</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;"><a href="http://erp.help.cloudsail.net.cn/_book/help/05_orderhelp/orderdistribution.html/FiaHY0DewCTyROywOgigS7WaXQBg.jpg">http://erp.help.cloudsail.net.cn/_book/help/05_orderhelp/orderdistribution.html/FiaHY0DewCTyROywOgigS7WaXQBg.jpg</a></td>
</tr>
<tr>
<td style="text-align: center;">status</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品状态: WAIT_SELLER_SEND_GOODS:等待卖家发货,即:买家已付款, WAIT_BUYER_CONFIRM_GOODS 等待买家确认收货,即:卖家已发货, TRADE_SUCCESS:买家已签收以及订单成功, TRADE_CLOSED:交易关闭</td>
<td style="text-align: center;">WAIT_SELLER_SEND_GOODS</td>
</tr>
<tr>
<td style="text-align: center;">item_id</td>
<td style="text-align: center;">long</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品id,生成的商品唯一id,对应商品上传接口:product_id</td>
<td style="text-align: center;">495112276</td>
</tr>
<tr>
<td style="text-align: center;">sku_properties_name</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">商品规格信息(无规格商品传空),结构体SkuPropertiesName数组类型的字符串格式,"[{"k":"规格","k_id":14,"v":"袋","v_id":10710}]"</td>
<td style="text-align: center;">"[{"k":"规格","k_id":14,"v":"袋","v_id":10710}]"</td>
</tr>
<tr>
<td style="text-align: center;">discount_price</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">单商品现价,减去了商品的优惠金额。单位:分</td>
<td style="text-align: center;">500</td>
</tr>
<tr>
<td style="text-align: center;">item_type</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单类型 默认:0, 0:普通类型商品; 10:分销商品; 24:周期购</td>
<td style="text-align: center;">0</td>
</tr>
<tr>
<td style="text-align: center;">outer_item_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商品编码,25个字符,可用于和其他系统之间商品的外部id的标识,对应云帆系统展示的商家SPU编码</td>
<td style="text-align: center;">spbm001</td>
</tr>
<tr>
<td style="text-align: center;">fenxiao_payment</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">分销单实付金额 默认:0,单位:分</td>
<td style="text-align: center;">86</td>
</tr>
<tr>
<td style="text-align: center;">buyer_messages</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;">is_present</td>
<td style="text-align: center;">Bool</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">是否赠品,是:true,否:false</td>
<td style="text-align: center;">false</td>
</tr>
<tr>
<td style="text-align: center;">fenxiao_price</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">分销单金额 默认:0,单位:分</td>
<td style="text-align: center;">56</td>
</tr>
<tr>
<td style="text-align: center;">alias</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商品别名,最长50个汉字</td>
<td style="text-align: center;">54564564asodj</td>
</tr>
<tr>
<td style="text-align: center;">outer_sku_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商品规格编码,25个字符,对应云帆系统展示的商家SKU编码</td>
<td style="text-align: center;">spbm001</td>
</tr>
<tr>
<td style="text-align: center;">customs_code</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;">SH</td>
</tr>
<tr>
<td style="text-align: center;">sku_id</td>
<td style="text-align: center;">long</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">规格id 默认:0,生成的商品规格唯一id,对应商品上传接口:product_sku_id</td>
<td style="text-align: center;">3635684788</td>
</tr>
<tr>
<td style="text-align: center;">points_pric</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">商品积分价(非积分商品则为0) 默认:0,如返回值是100则表示100积分。</td>
<td style="text-align: center;">100</td>
</tr>
<tr>
<td style="text-align: center;">express_no</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;">express_code</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;">delivery_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;">2019-08-20 10:19:52</td>
</tr>
<tr>
<td style="text-align: center;">goods_url</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;"><a href="https://h5.youzan.com/v2/showcase/goods?alias=26vavj3339p1x">https://h5.youzan.com/v2/showcase/goods?alias=26vavj3339p1x</a></td>
</tr>
<tr>
<td style="text-align: center;">refund_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;">2019-08-20 10:19:52</td>
</tr>
<tr>
<td style="text-align: center;">refund_fee</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">退款金额,默认:0,单位:分</td>
<td style="text-align: center;">105</td>
</tr>
<tr>
<td style="text-align: center;">refund_type</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">退款类型 默认:-1无,1:买家申请退款,2:商家主动退款, 3:系统退款。</td>
<td style="text-align: center;">1</td>
</tr>
<tr>
<td style="text-align: center;">refund_state</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">退款状态 默认:-1未退款,1:买家已经申请退款,等待卖家同意, 10:卖家拒绝退款, 20:卖家已经同意退货,等待买家退货, 30:买家已经退货,等待卖家确认收货, 40:卖家未收到货,拒绝退款, 50:退款关闭, 60:退款成功</td>
<td style="text-align: center;">1</td>
</tr>
</tbody>
</table>
<h2>备注详情结构体 RemarkInfo</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;">buyer_message</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;">trade_memo</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;">star</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">订单标星等级: 0~5分别表示不同星级,默认:0</td>
<td style="text-align: center;">1</td>
</tr>
</tbody>
</table>
<h2>商品规格信息结构体 SkuPropertiesName</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;">k</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;">k_id</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">规格名称编号</td>
<td style="text-align: center;">4</td>
</tr>
<tr>
<td style="text-align: center;">v</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;">v_id</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">规格值编号</td>
<td style="text-align: center;">400</td>
</tr>
</tbody>
</table>
<h3>云帆请求的说明</h3>
<p>1、数据编码采用UTF-8格式,application/json格式
2、采用HTTP或HTTPS传输协议,POST方法</p>
<pre><code class="language-json">{
"app_id":"i1hY3vOmCBWAB9ddDSDTN1RL",
"msg_id":"eeced9cc441942ff8ec2002178c2ff9b",
"data":{
"address_info":{
"delivery_address":"水印城 1-4-1143",
"delivery_postal_code":"",
"receiver_name":"周XX",
"delivery_province":"四川省",
"delivery_city":"成都市",
"delivery_district":"双流区",
"receiver_tel":"18012630000"
},
"remark_info":{
"buyer_message":"卖家留言",
"trade_memo":"买家备注",
"star":0
},
"pay_info":{
"outer_transactions":[
"396201909050781205290"
],
"post_fee":0,
"total_fee":18970,
"payment":18170,
"transaction":[
"190905210136000381"
]
},
"orders":[
{
"outer_item_id":"",
"discount_price":8990,
"item_type":0,
"num":1,
"oid":"4200000396201909050781205290",
"title":"看得见的放心越光大米4KG",
"fenxiao_payment":0,
"buyer_messages":"{}",
"is_present":false,
"price":8990,
"fenxiao_price":0,
"total_fee":8990,
"alias":"35y166a13ppl1",
"payment":8990,
"outer_sku_id":"6957048900110",
"customs_code":"",
"item_id":425430756,
"item_no":"",
"sku_properties_name":"[{\"k\":\"规格\",\"k_id\":14,\"v\":\"袋\",\"v_id\":10710}]",
"sku_id":36243074,
"pic_path":"https://img.yzcdn.cn/upload_files/2019/05/23/FiCeZY7Sexk3GGdKmPGHI_Dkuy-7.jpg",
"points_price":0,
"express_no":"YD202012345689",
"delivery_time":"2020-05-22 09:53:28",
"express_code":"1",
"status":"TRADE_SUCCESS",
"refund_type":1,
"refund_time":"2020-09-02 12:00:00",
"refund_fee":1500,
"refund_state":60
}
],
"order_info":{
"consign_time":"2020-05-07 16:14:04",
"created":"2020-05-07 16:10:36",
"offline_id":56307550,
"expired_time":"2020-05-07 16:40:36",
"success_time":"2020-05-22 09:53:27",
"type":0,
"confirm_time":"",
"tid":"E20200507161036078000002",
"pay_time":"2020-05-07 16:10:50",
"update_time":"2020-05-22 09:53:28",
"is_retail_order":"false",
"pay_type":10,
"close_type":0,
"status":"TRADE_SUCCESS"
}
},
"timestamp":1603452082572
}</code></pre>
<h2>订单详情结构体Json数据示例</h2>
<p>{
"address_info": {
"delivery_address": "水印城 1-4-1143",
"delivery_postal_code": "",
"receiver_name": "周XX",
"delivery_province": "四川省",
"delivery_city": "成都市",
"delivery_district": "双流区",
"receiver_tel": "18012630000"
},
"remark_info": {
"buyer_message": "卖家留言",
"trade_memo": "买家备注",
"star": 0
},
"pay_info": {
"outer_transactions": ["396201909050781205290"],
"post_fee": 0,
"total_fee": 18970,
"payment": 18170,
"transaction": ["190905210136000381"]
},
"orders": [{
"outer_item_id": "",
"discount_price": 8990,
"item_type": 0,
"num": 1,
"oid": "4200000396201909050781205290",
"title": "看得见的放心越光大米4KG",
"fenxiao_payment": 0,
"buyer_messages": "{}",
"is_present": false,
"price": 89.9,
"fenxiao_price": 0,
"total_fee": 8990,
"alias": "35y166a13ppl1",
"payment": 8990,
"outer_sku_id": "6957048900110",
"customs_code": "",
"item_id": 425430756,
"item_no": "",
"sku_properties_name": "[{\"k\":\"规格\",\"k_id\":14,\"v\":\"袋\",\"v_id\":10710}]",
"sku_id": 36243074,
"pic_path": "<a href="https://img.yzcdn.cn/upload_files/2019/05/23/FiCeZY7Sexk3GGdKmPGHI_Dkuy-7.jpg">https://img.yzcdn.cn/upload_files/2019/05/23/FiCeZY7Sexk3GGdKmPGHI_Dkuy-7.jpg</a>",
"points_price": 0,
"express_no": "YD202012345689",
"delivery_time": "2020-05-22 09:53:28",
"express_code": "1",
"status": "TRADE_SUCCESS",
"refund_type": 1,
"refund_time": "2020-09-02 12:00:00",
"refund_fee": 1500,
"refund_state": 60
}],
"order_info": {
"consign_time": "2020-05-07 16:14:04",
"created": "2020-05-07 16:10:36",
"offline_id": 56307550,
"expired_time": "2020-05-07 16:40:36",
"success_time": "2020-05-22 09:53:27",
"type": 0,
"confirm_time": "",
"tid": "E20200507161036078000002",
"pay_time": "2020-05-07 16:10:50",
"update_time": "2020-05-22 09:53:28",
"is_retail_order": "false",
"pay_type": 10,
"close_type": 0,
"status": "TRADE_SUCCESS"
}
}</p>
<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;">trade 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,
"data": null
}</p>
<h2>异常示例(注意大小写格式)</h2>
<p>{
"Status": 1001, //状态码
"Success": false,
"Message": "sign is error",
"Data": null
}</p>