获取退换货申请详情【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/get</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;">ReturnId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>退换货申请id ；和OrderId二选一，优先这个</td>
</tr>
<tr>
<td style="text-align: left;">OrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>订单id ；和ReturnId二选一 <br/>注：当订单有多个售后时，请调用 <strong>退换货申请列表</strong> API</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
"Data": {
"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": "待确认",
"StatusDescription": "退货已登记，等待售后确认",
"GatheredStatus": 1,
"GatheredStatusName": "包裹寄回中",
"UserId": "18003971236",
"ApplyDate": "2019-03-20T17:27:32",
"AboutExpressFee": "是打个电话",
"Remark": null,
"PaymentType": "0",
"ReturnMoney": 73.75,
"PicPath": null,
"ModifyDate": "2019-03-20T17:27:32.41",
"ConsigneeRealName": "ZXB",
"OrderPaymentType": "51",
"TheShop": 1,
"Received": 1,
"Consignmentdate": "2019-03-20T18:16:04.827",
"OrderFrom": null,
"OuterOrderCode": null
},
"OrderInfo": {
"OrderId": 13173572,
"OrderCore": {
"Id": 13173572,
"OrderCode": "2019032015050199",
"UserId": "18003971236",
"TheShop": 1,
"TheShopName": "杭州",
"OrderDate": "2019-03-20T15:05:01.257",
"PayTime": "2019-03-20T15:05:03.677",
"ShopDate": "2019-03-20T15:08:44.197",
"GatheredStatusName": "已退货",
"OrderStatus": 5,
"OrderStatusName": "已退换货",
"PaymentStatus": 2,
"PaymentStatuName": "已付款",
"OgisticsStatus": 5,
"OgisticsStatusName": "已发货",
"ReturnStatus": 1,
"ReturnStatusName": "已审核"
},
"OrderItems": [
{
"Id": 16042595,
"OrderId": 13173572,
"ProId": 553310,
"ProClass": "145",
"ProName": "颖儿家 YEJ8808 两件套 配腰带",
"ProImg": "http://img.hznzcn.com/images/goods_new/20180325/20180325141403842.jpg",
"ProPrice": 75,
"ProNum": 2,
"AddTime": "2019-03-20T15:05:01.257",
"ProOtherPara": "已发货",
"Specification": "蓝色,S",
"ProductNo": "YEJ8808-1",
"PickedCount": 2,
"ShopPrice": "298.00",
"DeliveryCount": 2,
"PickingStatus": 1,
"BrandId": 4698,
"CostPrice": 0,
"SeniorQCFee": 3,
"ServiceFee": 2,
"ReturnFee ":1,
"PostFree": 0,
"SendFast": 1,
"IsPresell": 0,
"IsGift": 0
},
{
"Id": 16042596,
"OrderId": 13173572,
"ProId": 553310,
"ProClass": "145",
"ProName": "颖儿家 YEJ8808 两件套 配腰带",
"ProImg": "http://img.hznzcn.com/images/goods_new/20180325/20180325141403842.jpg",
"ProPrice": 75,
"ProNum": 2,
"AddTime": "2019-03-20T15:05:01.257",
"ProOtherPara": "已发货",
"Specification": "蓝色,M",
"ProductNo": "YEJ8808-2",
"PickedCount": 2,
"ShopPrice": "298.00",
"DeliveryCount": 2,
"PickingStatus": 1,
"BrandId": 4698,
"CostPrice": 0,
"SeniorQCFee": 3,
"ServiceFee": 2,
"ReturnFee ":0,
"PostFree": 0,
"SendFast": 1,
"IsPresell": 0,
"IsGift": 0
},
{
"Id": 16042597,
"OrderId": 13173572,
"ProId": 553310,
"ProClass": "145",
"ProName": "颖儿家 YEJ8808 两件套 配腰带",
"ProImg": "http://img.hznzcn.com/images/goods_new/20180325/20180325141403842.jpg",
"ProPrice": 75,
"ProNum": 2,
"AddTime": "2019-03-20T15:05:01.257",
"ProOtherPara": "已发货",
"Specification": "蓝色,L",
"ProductNo": "YEJ8808-3",
"PickedCount": 2,
"ShopPrice": "298.00",
"DeliveryCount": 2,
"PickingStatus": 1,
"BrandId": 4698,
"CostPrice": 0,
"SeniorQCFee": 3,
"ServiceFee": 2,
"ReturnFee ":1,
"PostFree": 0,
"SendFast": 1,
"IsPresell": 0,
"IsGift": 0
},
{
"Id": 16042598,
"OrderId": 13173572,
"ProId": 553310,
"ProClass": "145",
"ProName": "颖儿家 YEJ8808 两件套 配腰带",
"ProImg": "http://img.hznzcn.com/images/goods_new/20180325/20180325141403842.jpg",
"ProPrice": 75,
"ProNum": 2,
"AddTime": "2019-03-20T15:05:01.257",
"ProOtherPara": "已发货",
"Specification": "蓝色,XL",
"ProductNo": "YEJ8808-4",
"PickedCount": 2,
"ShopPrice": "298.00",
"DeliveryCount": 2,
"PickingStatus": 1,
"BrandId": 4698,
"CostPrice": 0,
"SeniorQCFee": 3,
"ServiceFee": 2,
"ReturnFee ":1,
"PostFree": 0,
"SendFast": 1,
"IsPresell": 0,
"IsGift": 0
}
],
"OrderData": null,
"OrderPost": {
"OrderId": 13173572,
"DeliveryMode": 25,
"DeliveryModeName": "安能物流",
"ShipperCode": "ANEKY",
"ExpressCode": "633215784569",
"ConsigneeRealName": "ZXB",
"ConsigneePhone": "15023014879",
"ConsigneeProvince": "320000,320200,320203",
"ConsigneeAddress": "江苏省 无锡市 南长区 大厦市场非官方个",
"ConsigneeZip": null,
"ConsigneeTel": null,
"ConsigneeWW": null,
"PackageType": 5,
"PackageNum": 1,
"Weight": 3400
},
"OrderParam": null,
"OrderRemark": null,
"OrderOuter": null,
"OrderSub": null,
"OrderExt": null,
"OrderMemoMember": null,
"OrderOper": null
},
"ReturnProList": [
{
"Id": 4351932,
"ReturnId": 3312047,
"OrderId": 13173572,
"ProId": 553310,
"ProName": "颖儿家 YEJ8808 两件套 配腰带",
"ProSpec": "蓝色,M",
"ProPrice": 75,
"ProNum": 1,
"OrderDetailId": 16042596,
"ProductCode": "YEJ8808-2",
"ProductImgUrl": "http://img.hznzcn.com/images/goods_new/20180325/20180325141403802.jpg",
"ReturnFee": 1
}
]
},
"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;">Data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">退换货申请详细聚合信息对象，具体参考下面的 <strong>Data参数说明</strong></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】文档">[4]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>Data参数说明</strong></p>
<ul>
<li>
<p>退换货申请详细聚合对象（ReturnUnion）</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;">ReturnInfo</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">退换货申请详细信息对象，具体参考下面的 <strong>ReturnInfo参数说明</strong></td>
</tr>
<tr>
<td style="text-align: left;">OrderInfo</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">订单信息聚合对象，数结构请参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1341355580836267" title="点击访问 订单详细API 文档">[5]订单详细API </a></td>
</tr>
<tr>
<td style="text-align: left;">ReturnProList</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">退换货申请相关的退货产品对象列表（List<ReturnPro>），具体参考下面的 <strong>ReturnPro参数说明</strong></td>
</tr>
</tbody>
</table>
</li>
</ul>
<p><strong>ReturnInfo参数说明</strong></p>
<ul>
<li>
<p>退换货申请详细对象</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;">Id</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">退换货申请ID，就是请求参数ReturnId</td>
</tr>
<tr>
<td style="text-align: left;">ReturnCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">退换货编号</td>
</tr>
<tr>
<td style="text-align: left;">OrderId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单ID</td>
</tr>
<tr>
<td style="text-align: left;">OrderCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单编号</td>
</tr>
<tr>
<td style="text-align: left;">DealType</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">期望处理方式</td>
</tr>
<tr>
<td style="text-align: left;">Cause</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">老版退换货事由</td>
</tr>
<tr>
<td style="text-align: left;">CauseDescribe</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">老版退换货事由描述</td>
</tr>
<tr>
<td style="text-align: left;">NewCause</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">新版退换货事由，建议使用新版</td>
</tr>
<tr>
<td style="text-align: left;">NewCauseDescribe</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">新版退换货事由描述，建议使用新版</td>
</tr>
<tr>
<td style="text-align: left;">IsBackExpress</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是否收需要拦截快递，0=否；1=是</td>
</tr>
<tr>
<td style="text-align: left;">Express</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">快递公司</td>
</tr>
<tr>
<td style="text-align: left;">ExpressCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">快递单号</td>
</tr>
<tr>
<td style="text-align: left;">IsSubmitOnAlipay</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是否已经在支付宝提交申请</td>
</tr>
<tr>
<td style="text-align: left;">SendDate</td>
<td style="text-align: left;">DateTime</td>
<td style="text-align: left;">发货时间</td>
</tr>
<tr>
<td style="text-align: left;">Status</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">处理状态；<br/>0=已申请；<br/>1=已审核；<br/>2=已售后确认；<br/>3=已退换货【退款完成】；<br/>4=结束【用户放弃】；<br/>5=审核未通过 ；<br/>6=退款中;</td>
</tr>
<tr>
<td style="text-align: left;">StatusName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">一个综合情况的状态名称，可能会和Status的说明不一样！<br/>实际以Status 为主！</td>
</tr>
<tr>
<td style="text-align: left;">StatusDescription</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">状态的描述，描述当前状态的具体信息，如 “退货已登记，等待售后确认”，“暂未收到退货包裹（当天签收包裹预计会有3-6小时延时）”等</td>
</tr>
<tr>
<td style="text-align: left;">GatheredStatus</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">综合流程节点；<br/>0=提交申请；<br/>1=包裹寄回中；<br/>2=等待审核；<br/>3=审核未通过；<br/>4=已完成；</td>
</tr>
<tr>
<td style="text-align: left;">GatheredStatusName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">综合流程节点名称</td>
</tr>
<tr>
<td style="text-align: left;">UserId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户账号名</td>
</tr>
<tr>
<td style="text-align: left;">ApplyDate</td>
<td style="text-align: left;">DateTime</td>
<td style="text-align: left;">申请时间</td>
</tr>
<tr>
<td style="text-align: left;">AboutExpressFee</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">关于补交邮资的说明</td>
</tr>
<tr>
<td style="text-align: left;">Remark</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">备注</td>
</tr>
<tr>
<td style="text-align: left;">PaymentType</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">退款方式</td>
</tr>
<tr>
<td style="text-align: left;">PicPath</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">照片路径,图片路径(最大长度500)；格式如 “图片全路径1,图片全路径2”，可用 英文逗号 分割 ;</td>
</tr>
<tr>
<td style="text-align: left;">ModifyDate</td>
<td style="text-align: left;">DateTime</td>
<td style="text-align: left;">修改时间，可为 <strong>NULL</strong></td>
</tr>
<tr>
<td style="text-align: left;">ReturnMoney</td>
<td style="text-align: left;">decimal</td>
<td style="text-align: left;">退货金额，未退款时，为 <strong>NULL</strong></td>
</tr>
<tr>
<td style="text-align: left;">ConsigneeRealName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单收货人</td>
</tr>
<tr>
<td style="text-align: left;">OrderPaymentType</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单支付类型</td>
</tr>
<tr>
<td style="text-align: left;">TheShop</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">货源地ID</td>
</tr>
<tr>
<td style="text-align: left;">Received</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是否收到货;0=否；1=是</td>
</tr>
<tr>
<td style="text-align: left;">Consignmentdate</td>
<td style="text-align: left;">DateTime</td>
<td style="text-align: left;">退退货登录的最后修改时间，可为 <strong>NULL</strong></td>
</tr>
<tr>
<td style="text-align: left;">OrderFrom</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单来源</td>
</tr>
<tr>
<td style="text-align: left;">OuterOrderCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单外部单号</td>
</tr>
</tbody>
</table>
</li>
</ul>
<p><strong>ReturnPro参数说明</strong></p>
<ul>
<li>
<p>退换货的售后产品对象</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;">Id</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">退换货产品记录ID【注意，这是记录id】</td>
</tr>
<tr>
<td style="text-align: left;">ReturnId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">退换货申请ID</td>
</tr>
<tr>
<td style="text-align: left;">OrderId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单ID</td>
</tr>
<tr>
<td style="text-align: left;">OrderDetailId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单明细id【就是订单的 OrderItems 的 id】</td>
</tr>
<tr>
<td style="text-align: left;">ProId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">产品id【找女装网的相关产品，用这个ID】</td>
</tr>
<tr>
<td style="text-align: left;">ProductCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">产品货号</td>
</tr>
<tr>
<td style="text-align: left;">ProName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">产品名称</td>
</tr>
<tr>
<td style="text-align: left;">ProSpec</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商品规格</td>
</tr>
<tr>
<td style="text-align: left;">ProPrice</td>
<td style="text-align: left;">decimal</td>
<td style="text-align: left;">商品价格</td>
</tr>
<tr>
<td style="text-align: left;">ProNum</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">商品数量</td>
</tr>
<tr>
<td style="text-align: left;">ProductImgUrl</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商品图片</td>
</tr>
<tr>
<td style="text-align: left;">ReturnFee</td>
<td style="text-align: left;">decimal</td>
<td style="text-align: left;">单件退货费</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
</li>
</ul>