申请退换货【Return】
<p><strong>简要描述:</strong> </p>
<ul>
<li>申请退换货【Return】,该API,添加和修改合在一起了!</li>
<li>杭州女装网的售后,分 refund(售前退款,未发货的订单走的流程) 和return(售后退换货,发货的订单走的流程),请注意区分 到底是走 refund 还是 return </li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://open.hznzcn.com/order/return/submit</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;添加时不需要填写,修改是必填</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</td>
</tr>
<tr>
<td style="text-align: left;">OrderItemIds</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单产品明细(OrderProduct)的id字符串;格式如 “1,2,3”; 英文半角逗号分割 ;需要和下面的ReturnProNums顺序一一对应;</td>
</tr>
<tr>
<td style="text-align: left;">ReturnProNums</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>售后数量的字符串;格式如 “1,2,3”; 英文半角逗号分割 ;需要和上面和OrderItemIds顺序一一对应</td>
</tr>
<tr>
<td style="text-align: left;">DealType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>售后处理方式;1=退货;2=换货;</td>
</tr>
<tr>
<td style="text-align: left;">Cause</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>老版退换货原因类型【不建议使用,只是为了兼容,和NewCause二选一】;<br/>0=七天无理由;<br/>1=商品质量问题;<br/> 2=收到商品与描述不符;<br/>3=其他;<br/>4=未发商品;<br/>5=未收到货</td>
</tr>
<tr>
<td style="text-align: left;">NewCause</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>新版的退换货原因类型【建议使用,和Cause二选一】; <br/> 1=七天无理由退换货 ;<br/>2=拍错/不喜欢/效果不好;<br/>11=平台发错货;<br/>12=商品质量问题;<br/>21=收到商品描述不符;<br/>51=货物破损已拒签;<br/>52=多拍/拍错/不想要;<br/>53=快递一直未送到;<br/>54=快递无跟踪记录;55=空包/少货;31=其他 ;</td>
</tr>
<tr>
<td style="text-align: left;">IsBackExpress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>是否需要拦截快递,为了客户体验度,如 是未收到货的情况,可以根据实际需求,填写是否拦截<br/>【如果老版退货原因是 Cause=5(未收到货) 】<br/>或<br/>【如果新版退货原因是 Cause=51,52,53,54,55(都属于未收到货) 】</td>
</tr>
<tr>
<td style="text-align: left;">Express</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>快递公司(最大长度50个字符); <br/>【如果退货原因是 Cause=4(未发商品) 或者 Cause=5(未收到货)】<br/>或<br/>【如果新版退货原因是 Cause=51,52,53,54,55(都属于未收到货) 】,无需填写</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个字符); <br/>【如果退货原因是 Cause=4(未发商品) 或者 Cause=5(未收到货)】<br/>或<br/>【如果新版退货原因是 Cause=51,52,53,54,55(都属于未收到货) 】,无需填写</td>
</tr>
<tr>
<td style="text-align: left;">AboutMoreInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>补充说明(最大长度250字符)</td>
</tr>
<tr>
<td style="text-align: left;">PicPath</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>图片路径(最大长度500);多张图片时,请用 英文分号分割;如 “图片全路径1;图片全路径2” ;<br/>如果退货原因是 Cause=1(商品质量问题) 时,必填 ;</td>
</tr>
<tr>
<td style="text-align: left;">SendDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>发货时间,时间格式字符串,如 “2018-12-10”,不填写就默认当前日期</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"Data": 3311840,
"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;">int</td>
<td style="text-align: left;">申请成功后返回的 退换货申请ID;该ID可用于访问 <a href="https://www.showdoc.cc/230407611622153?page_id=1355267994183000" title="点击访问 退换货申请详细【Return】API文档">[4]退换货申请详细【Return】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>