获取退货数量情况列表【Return】
<p><strong>简要描述:</strong> </p>
<ul>
<li>获取订单的 退货数量情况 列表【Return】</li>
<li>如果申请退换货时,不知道能退什么货,可以请求该API,可以得到订单退了多少货,能退什么货</li>
<li>杭州女装网的售后,分 refund(售前退款,未发货的订单走的流程) 和return(售后退换货,发货的订单走的流程),请注意区分 到底是走 refund 还是 return
<strong>请求URL:</strong> </li>
<li><code>http://open.hznzcn.com/order/return/productnum/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;">OrderId</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>{
"Data": [
{
"OrderProductId": 16039941,
"OrderId": 13172740,
"DeliveryCount": 1,
"ReturnNum": 0,
"ReturnLeftNum": 1
},
{
"OrderProductId": 16039942,
"OrderId": 13172740,
"DeliveryCount": 1,
"ReturnNum": 0,
"ReturnLeftNum": 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;">订单的退货数量情况列表(List<ReturnProductNum>) ,具体参考下面的 <strong>ReturnProductNum参数说明</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>ReturnProductNum参数说明</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;">OrderProductId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单产品Id,就是订单产品明细(OrderProduct)的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;">DeliveryCount</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">总的发货的数量</td>
</tr>
<tr>
<td style="text-align: left;">ReturnNum</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">已经经退换货的数量(正在退的 + 已经退成功的)</td>
</tr>
<tr>
<td style="text-align: left;">ReturnLeftNum</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">未申请退换货的数量(可以申请的数量)</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
</li>
</ul>