P19-退单推送
<p><strong>简要描述：</strong> </p>
<ul>
<li>退单同步</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li>环境地址：<code>https://kylinapi.aupres.com.cn/openapi/v2/order/save</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">说明</th>
<th>类型</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">channelType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">渠道类型 POS</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">couponFee</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">优惠劵金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">couponNo</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">优惠劵码</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">coupons</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单优惠券</td>
<td>array</td>
</tr>
<tr>
<td style="text-align: left;">customerNo</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">客户编号（单渠道唯一标识）</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单备注</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">discountFee</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">折扣金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">discountRate</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">折扣率 <=1</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">exchangeTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单换货时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">freight</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">运费</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">guideCode</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单对应导购</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">isInternal</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">是否是内部订单. Y:否 N:是 . 默认为N</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">isSend</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">isSend, 默认为N</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">memberId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">会员ID</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">memberType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">会员类型 传固定值aupres</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">退单ID</td>
<td>string （主退单表唯一主键字段）</td>
</tr>
<tr>
<td style="text-align: left;">orderItems</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">子订单列表</td>
<td>array</td>
</tr>
<tr>
<td style="text-align: left;">orderStatus</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">订单状态 订单状态： 下单 CREATED 订单取消 CANCELLED 已发货 DELIVERED 卖家已确认CONFIRMED 订单完成 FINISHED 退款开始 REFUND_START 退款中 REFUNDING 退款完成REFUND_FINISHED 退款取消 REFUND_CANCEL</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">orderTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">下单时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">orderType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">订单类型:正常单-NORMAL,退单-REFUND</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">originOrderId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">原始订单ID, 退单时传</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">payTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单付款时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">payment</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">正常单时，代表实付金额；退单时，代表退款金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">pays</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单支付方式</td>
<td>array</td>
</tr>
<tr>
<td style="text-align: left;">pointFlag</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">是否计算积分. 0-不计算积分, 1- 计算积分</td>
<td>int</td>
</tr>
<tr>
<td style="text-align: left;">receiveTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单发货时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">receiverProvince</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">省</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverCity</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">市</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverDistrict</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">区/县</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverAddress</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">收货人地址</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverMobile</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">收货人手机号</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverName</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">收货人姓名</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverTelephone</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">收货人固定电话</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">receiverZipCode</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">邮编</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">refundTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单退货时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">shippingTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单收货时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">shopCode</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">消费门店code</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">shopName</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">消费门店名称</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">shopTypeCode</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">消费门店类型code</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">totalFee</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">应付金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">totalQuantity</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商品总数</td>
<td>int</td>
</tr>
<tr>
<td style="text-align: left;">customizedProperties</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">扩展字段</td>
<td>map</td>
</tr>
</tbody>
</table>
<p><strong>coupons说明：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">说明</th>
<th>类型</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">couponFee</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">优惠金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">couponNo</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">优惠券码</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">instanceId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">权益实例id</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">orderItemId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">子订单号</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">projectId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">权益项目id</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">projectName</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">权益项目名称</td>
<td>string</td>
</tr>
</tbody>
</table>
<p><strong>orderItems说明：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">说明</th>
<th>类型</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">channelType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">渠道</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">discountFee</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">折扣金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">discountRate</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">折扣率 <=1</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">finishTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">订单完成时间, 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">orderItemId</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">子订单ID</td>
<td>string （子退单表唯一主键字段）</td>
</tr>
<tr>
<td style="text-align: left;">orderTime</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">下单时间 格式: yyyy-MM-dd HH:mm:ss</td>
<td>date</td>
</tr>
<tr>
<td style="text-align: left;">orderType</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">子订单类型:正常单 - NORMAL, 退单 - REFUND</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">originOrderItemId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">原始子订单ID, 退单时传</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">payment</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">实付金额</td>
</tr>
<tr>
<td style="text-align: left;">picture</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">商品图片url</td>
<td>array</td>
</tr>
<tr>
<td style="text-align: left;">productCode</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商品Code</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">productName</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商品名称</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">quantity</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">订单数量</td>
<td>int</td>
</tr>
<tr>
<td style="text-align: left;">retailPrice</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">零售价</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">shopTypeCod</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">注册门店类型code</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">skuId</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">商品批次编码</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">子订单状态</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">tagPrice</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">吊牌价</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">totalFee</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">应付金额</td>
<td>number</td>
</tr>
<tr>
<td style="text-align: left;">customizedProperties</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">扩展字段</td>
<td>map</td>
</tr>
</tbody>
</table>
<p><strong>pays说明：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">说明</th>
<th>类型</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">payWayCode</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">支付方式编码</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">payWayName</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">支付方式名称</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">payment</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">支付金额</td>
<td>number</td>
</tr>
</tbody>
</table>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">HTTP Code</th>
<th style="text-align: left;">Description</th>
<th>Schema</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">OK</td>
<td>No Content</td>
</tr>
<tr>
<td style="text-align: left;">201</td>
<td style="text-align: left;">Created</td>
<td>No Content</td>
</tr>
<tr>
<td style="text-align: left;">401</td>
<td style="text-align: left;">Unauthorized</td>
<td>No Content</td>
</tr>
<tr>
<td style="text-align: left;">403</td>
<td style="text-align: left;">Forbidden</td>
<td>No Content</td>
</tr>
<tr>
<td style="text-align: left;">404</td>
<td style="text-align: left;">Not Found</td>
<td>No Content</td>
</tr>
</tbody>
</table>
<p><strong>请求参数示例</strong></p>
<pre><code>{
"shopTypeCode": "TAOBAO",
"channelType": "pos",
"totalFee": 85,
"payment": 85,
"discountRate": 0.85,
"discountFee": 15,
"customizedProperties": {
"string": "update"
},
"memberType": "aupres",
"customerNo": "T000001",
"orderId": "087989aaf6af4e58897794d18axxxxx",
"originOrderId": "087989aaf6af4e58897794d18axxxxx",
"shopCode": "SHOP001",
"shopName": "SHOP001",
"memberId": "1c25f18ad274493882d01660e3exxxxx",
"totalQuantity": 1,
"orderType": "NORMAL",
"orderStatus": "FINISHED",
"freight": 10,
"receiverName": "abc",
"receiverMobile": "18900000000",
"receiverTelephone": "18900000000",
"receiverProvince": "上海",
"receiverCity": "上海",
"receiverDistrict": "浦东新区",
"receiverAddress": "南京东路100号",
"receiverZipCode": "200000",
"couponNo": "C123456",
"couponFee": 15,
"guideCode": "001",
"description": "无",
"pointFlag": 1,
"isInternal": "N",
"isSend": "N",
"coupons": [
{
"orderItemId": "XJLO00001",
"projectId": "string",
"projectName": "全品类8折券",
"instanceId": "string",
"couponNo": "O1JH200D",
"couponFee": 9.99
}
],
"pays": [
{
"payWayCode": "1",
"payWayName": "现金",
"payment": 1
}
],
"payTime": "2021-11-10 09:52:03",
"receiveTime": "2021-11-10 09:52:03",
"shippingTime": "2021-11-10 09:52:03",
"exchangeTime": "2021-11-10 09:52:03",
"refundTime": "2021-11-10 09:52:03",
"orderTime": "2021-11-10 09:52:03",
"orderItems": [
{
"shopTypeCode": "TAOBAO",
"channelType": "TAOBAO",
"totalFee": 85,
"payment": 85,
"discountRate": 0.85,
"discountFee": 15,
"customizedProperties": {
"string": "update"
},
"orderItemId": "bf3a654f1afa4859bb5c0e8846bxxxxx",
"originOrderItemId": "bf3a654f1afa4859bb5c0e8846bxxxxx",
"productCode": "P001",
"productName": "P001",
"quantity": 1,
"status": "FINISHED",
"skuId": "S001",
"tagPrice": 100,
"retailPrice": 100,
"orderType": "NORMAL",
"picture": [
"https://allpro.saas.top/FsB-uzzX4WtCzpDu-Vuwqp2OdNbQ?e=1547742055&token=yNjhOp7gnH4St9yP72OlwuQ6JUNQf49pxAuGWYFt:1eZIUjRKIekGuMGG-c-s7UqNF1Y=;"
],
"finishTime": "2021-11-10 09:52:03",
"orderTime": "2021-11-10 09:52:03"
}
],
"internal": "string",
"send": "string"
}</code></pre>