退换货申请列表【Return】
<p><strong>简要描述：</strong> </p>
<ul>
<li>退换货申请列表【Return】</li>
<li>杭州女装网的售后，分 refund（售前退款，未发货的订单走的流程） 和return（售后退换货，发货的订单走的流程），请注意区分 到底是走 refund 还是 return</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://open.hznzcn.com/order/return/list</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
<li>x-www-form-urlencoded</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;">app_key</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>App应用标识，女装网提供</td>
</tr>
<tr>
<td style="text-align: left;">access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>授权成功的Token，若访问的API和用户有关，该项为必填项， 具体请查看 <a href="https://www.showdoc.cc/230407611622153?page_id=1313862750462126" title="点击查看 获取授权，token 文档">[1]获取授权，token 文档</a></td>
</tr>
<tr>
<td style="text-align: left;">stamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳，有效期为 <strong>3</strong> 分钟，示例值：636806795462062641，具体参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1313894411972991" title="点击查看时间戳的说明文档">[2]时间戳说明文档</a></td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名，将除了sign以为的的所有请求参数进行签名加密处理后的字符串，示例值：0895AB9BCE9AA031D4EE3CC38C3E0702，具体参考<a href="https://www.showdoc.cc/230407611622153?page_id=1313915454654841" title="点击查看签名生成说明文档">[3]签名生成说明文档</a></td>
</tr>
</tbody>
</table>
<p><strong>API请求参数：</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;">BeginDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开始时间，格式如：“2018-12-01”</td>
</tr>
<tr>
<td style="text-align: left;">EndDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>结束时间，格式如：“2018-12-02” ；(和BeginDate的最大有效间隔是1年)</td>
</tr>
<tr>
<td style="text-align: left;">PageIndex</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>第几页（大于0，小于等于100）</td>
</tr>
<tr>
<td style="text-align: left;">PageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>一页数据大小（暂不支持自定义，默认20）</td>
</tr>
<tr>
<td style="text-align: left;">PageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>一页数据大小（暂不支持自定义，默认20）</td>
</tr>
<tr>
<td style="text-align: left;">Status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>售后状态【查询状态】;<br/>0=全部;<br/>1=包裹寄回中;<br/>2=等待审核;<br/>3=未通过;<br/>4=已完成 ;<br/>该状态只是用于查询，代表某组状态，对售后进行归类，实际返回的售后状态值可能不一致</td>
</tr>
<tr>
<td style="text-align: left;">OrderCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>女装网或淘宝订单编号(最大长度20字符)</td>
</tr>
<tr>
<td style="text-align: left;">ExpressCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>寄回的快递单号(最大长度50字符)</td>
</tr>
<tr>
<td style="text-align: left;">ProductNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品货号(最大长度100字符)</td>
</tr>
<tr>
<td style="text-align: left;">Receiver</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收件人(最大长度50字符)</td>
</tr>
<tr>
<td style="text-align: left;">ReturnCause</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>旧版退换货原因；和下面的NewReturnCause同时有效； <br/>-1=全部；<br/>0=七天无理由；<br/>1=商品质量问题；<br/>2=收到商品与描述不符；<br/>3=其他；<br/>4=未发商品；<br/>5=未收到货</td>
</tr>
<tr>
<td style="text-align: left;">NewReturnCause</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>新版退换货原因；和上面的ReturnCause同时有效； <br/>0:全部；<br/>1:七天无理由；<br/>2:拍错/不喜欢；<br/>11:平台发错货；<br/>12:商品质量问题；<br/>21:商品与描述不符 ；<br/>51:已拒收； <br/>52:不想要；<br/>53:快递未送达；<br/>54:无物流记录；<br/>55:空包/少货；<br/>31:其他；<br/>41:未发商品；</td>
</tr>
<tr>
<td style="text-align: left;">TheShopId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>货源地ID</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"Items": [
{
"ReturnInfo": {
"Id": 3312047,
"ReturnCode": "1903200018",
"OrderId": 13173572,
"OrderCode": "2019032015050199",
"DealType": 1,
"Cause": "5",
"CauseDescribe": "未收到货",
"NewCause": "53",
"NewCauseDescribe": "快递一直未送到",
"IsBackExpress": 1,
"Express": "申通",
"ExpressCode": "3332547895105",
"IsSubmitOnAlipay": 0,
"SendDate": "2019-03-20T17:27:32",
"Status": 1,
"StatusName": "退货已登记，等待售后确认",
"GatheredStatus": 1,
"GatheredStatusName": "包裹寄回中",
"UserId": "18003971236",
"ApplyDate": "2018-12-22T13:20:56.53",
"AboutExpressFee": null,
"Remark": null,
"PaymentType": "0",
"ReturnMoney": 32,
"PicPath": "sale_support/201812/71a8ce21-0781-4d1b-85c7-78e78ec4a40a.jpg,sale_support/201812/48f5fcad-39a9-459f-8ffd-734f44c3195f.jpg,sale_support/201812/fa243e47-a0cb-4994-b2a2-1818ecf489f6.jpg,sale_support/201812/cd355dfc-2d68-4b52-9219-debcdfa7818b.jpg",
"ModifyDate": "2018-12-22T13:14:15.893",
"ConsigneeRealName": "陈智宇",
"OrderPaymentType": "51",
"TheShop": 5,
"Received": 0,
"Consignmentdate": "2018-12-22T12:47:05.78",
"OrderFrom": "淘宝",
"OuterOrderCode": "303544129321010833"
},
"OrderInfo": {
"OrderId": 13172725,
"OrderCore": {
"Id": 13172725,
"OrderCode": "2018122210405767",
"UserId": "18003971236",
"TheShop": 5,
"TheShopName": "广州",
"OrderDate": "2018-12-22T10:40:57.54",
"PayTime": "2018-12-22T10:41:01.613",
"ShopDate": "2018-12-22T10:37:38.443",
"GatheredStatusName": "售后中",
"OrderStatus": 2,
"OrderStatusName": "已发货",
"PaymentStatus": 2,
"PaymentStatuName": "已付款",
"OgisticsStatus": 5,
"OgisticsStatusName": "已发货",
"ReturnStatus": 1,
"ReturnStatusName": "已审核"
},
"OrderItems": null,
"OrderData": null,
"OrderPost": {
"OrderId": 13172725,
"DeliveryMode": 4,
"DeliveryModeName": "韵达",
"ShipperCode": "YD",
"ExpressCode": "3833573497977",
"ConsigneeRealName": "陈智宇",
"ConsigneePhone": "15088667406",
"ConsigneeProvince": "330000,330100,330109",
"ConsigneeAddress": "浙江省 杭州市 萧山区 宁围镇飞虹路1261号 丰瑞北苑18幢1单元1701",
"ConsigneeZip": "000000",
"ConsigneeTel": null,
"ConsigneeWW": "newzhiyinzhijiao",
"PackageType": 5,
"PackageNum": 1,
"Weight": 1300
},
"OrderParam": null,
"OrderRemark": null,
"OrderOuter": null,
"OrderSub": null,
"OrderExt": null,
"OrderMemoMember": null,
"OrderOper": null
},
"ReturnProList": [
{
"Id": 4351515,
"ReturnId": 3311832,
"OrderId": 13172725,
"ProId": 632462,
"ProName": "安吉丽拉 AJLL88422",
"ProSpec": "蓝色,均码",
"ProPrice": 35,
"ProNum": 1,
"OrderDetailId": 16039906,
"ProductCode": "-1",
"ProductImgUrl": "http://img.hznzcn.com/images/goods_crawler/20181220/20181220095113184.jpg",
"ReturnFee": 3
}
]
},
{
"ReturnInfo": {
"Id": 3311833,
"ReturnCode": "1812220002",
"OrderId": 13172731,
"OrderCode": "2018122209221989",
"DealType": 1,
"Cause": "0",
"Express": "百世快递",
"ExpressCode": "321485634123",
"IsSubmitOnAlipay": 0,
"SendDate": "2018-12-23T00:00:00",
"Status": 1,
"StatusName": null,
"GatheredStatus": 1,
"GatheredStatusName": "包裹寄回中",
"UserId": "18003971236",
"ApplyDate": "2018-12-22T09:45:37.093",
"AboutExpressFee": null,
"Remark": null,
"PaymentType": "0",
"ReturnMoney": 56,
"PicPath": null,
"ModifyDate": "2018-12-22T14:39:30.28",
"ConsigneeRealName": "陈智宇",
"OrderPaymentType": "51",
"TheShop": 5,
"Received": 0,
"Consignmentdate": "2018-12-22T09:45:37.07",
"OrderFrom": "淘宝",
"OuterOrderCode": "303811298385010833"
},
"OrderInfo": {
"OrderId": 13172731,
"OrderCore": {
"Id": 13172731,
"OrderCode": "2018122209221989",
"UserId": "18003971236",
"TheShop": 5,
"TheShopName": "广州",
"OrderDate": "2018-12-22T09:22:19.447",
"PayTime": "2018-12-22T09:22:25.477",
"ShopDate": "2018-12-22T14:18:13.1",
"GatheredStatusName": "售后中",
"OrderStatus": 2,
"OrderStatusName": "已发货",
"PaymentStatus": 2,
"PaymentStatuName": "已付款",
"OgisticsStatus": 5,
"OgisticsStatusName": "已发货",
"ReturnStatus": 1,
"ReturnStatusName": "已审核"
},
"OrderItems": null,
"OrderData": null,
"OrderPost": {
"OrderId": 13172731,
"DeliveryMode": 4,
"DeliveryModeName": "韵达",
"ShipperCode": "YD",
"ExpressCode": "3833573511675",
"ConsigneeRealName": "陈智宇",
"ConsigneePhone": "15088667406",
"ConsigneeProvince": "330000,330100,330109",
"ConsigneeAddress": "浙江省 杭州市 萧山区 宁围镇 飞虹路1261号 丰瑞北苑18幢1单元1701",
"ConsigneeZip": "000000",
"ConsigneeTel": null,
"ConsigneeWW": "newzhiyinzhijiao",
"PackageType": 5,
"PackageNum": 1,
"Weight": 1300
},
"OrderParam": null,
"OrderRemark": null,
"OrderOuter": null,
"OrderSub": null,
"OrderExt": null,
"OrderMemoMember": null,
"OrderOper": null
},
"ReturnProList": [
{
"Id": 4351516,
"ReturnId": 3311833,
"OrderId": 13172731,
"ProId": 632492,
"ProName": "安吉丽拉 AJLL8847C",
"ProSpec": "黑色,均码",
"ProPrice": 59,
"ProNum": 1,
"OrderDetailId": 16039921,
"ProductCode": "AJLL8847C-1",
"ProductImgUrl": "http://img.hznzcn.com/images/goods_crawler/20181220/20181220161523323.jpg",
"ReturnFee": 3
}
]
}
],
"TotalCount": 0,
"HasNext": 0,
"Code": "0",
"Msg": null
}</code></pre>
<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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Items</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">1页的 退换货申请详细聚合对象列表（IList<ReturnUnion>），具体参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1355267994183000" title="点击查看 退换货详情API 文档">[4]退换货详情API</a> 的对象</td>
</tr>
<tr>
<td style="text-align: left;">TotalCount</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">总记录数（这边没实现）</td>
</tr>
<tr>
<td style="text-align: left;">HasNext</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是否还有下一页,0:没有，1：有（这边没实现）</td>
</tr>
<tr>
<td style="text-align: left;">Code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">请求状态码 ，具体参考<a href="https://www.showdoc.cc/230407611622153?page_id=1314533986849160" title="点击查看请求状态码【ResponseCode】文档">[5]ResponseCode文档</a></td>
</tr>
<tr>
<td style="text-align: left;">Msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">请求相关信息</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>