OMS 对外开放接口说明

OMS 对外开放接口说明


退货订单查询

<h5>简要描述</h5> <ul> <li>退货订单查询</li> </ul> <h5>请求URL</h5> <ul> <li><code>/v1/return/order/search</code> </li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>请求参数示例</h5> <pre><code>{ "beginCreateTime": "2022-05-01", "endCreateTime": "2022-05-03", "beginReturnTime": "2022-05-01", "endReturnTime": "2022-05-03", "beginReturnCompleteTime": "2022-05-01", "endReturnCompleteTime": "2022-05-03", "foNos": [ "FO2000050101-XOD" ], "pageNum": "不传默认为1", "pageSize": "不传默认为10", "returnOrderCodes": [ "RO2022050101" ], "rmaCodes": [ "RMA2022050101" ] } </code></pre> <h5>json字段说明</h5> <table> <thead> <tr> <th style="text-align: left;">字段名</th> <th style="text-align: left;">必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">beginCreateTime</td> <td style="text-align: left;">否</td> <td>string</td> <td>创建时间起始</td> </tr> <tr> <td style="text-align: left;">endCreateTime</td> <td style="text-align: left;">否</td> <td>string</td> <td>创建时间结束</td> </tr> <tr> <td style="text-align: left;">beginReturnTime</td> <td style="text-align: left;">否</td> <td>string</td> <td>退货时间起始</td> </tr> <tr> <td style="text-align: left;">endReturnTime</td> <td style="text-align: left;">否</td> <td>string</td> <td>退货时间结束</td> </tr> <tr> <td style="text-align: left;">beginReturnCompleteTime</td> <td style="text-align: left;">否</td> <td>string</td> <td>退货完成时间起始</td> </tr> <tr> <td style="text-align: left;">endReturnCompleteTime</td> <td style="text-align: left;">否</td> <td>string</td> <td>退货完成时间结束</td> </tr> <tr> <td style="text-align: left;">foNos</td> <td style="text-align: left;">否</td> <td>array</td> <td>发货批次号集合 [ &quot;FO2000050101-XOD&quot; ]</td> </tr> <tr> <td style="text-align: left;">pageNum</td> <td style="text-align: left;">是</td> <td>number</td> <td>页码</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">是</td> <td>number</td> <td>页大小</td> </tr> <tr> <td style="text-align: left;">returnOrderCodes</td> <td style="text-align: left;">否</td> <td>array</td> <td>退货单号集合 [ &quot;RO2022050101&quot; ]</td> </tr> <tr> <td style="text-align: left;">rmaCodes</td> <td style="text-align: left;">否</td> <td>array</td> <td>退件处理单号集合 [ &quot;RMA2022050101&quot; ]</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>{ "msg": "操作成功", "code": 200, "data": [ { "returnOrderCode": "RT202302080002-YTD", "foNo": null, "orderNo": "", "afterSalesNo": "AS10202302080002", "warehouseCode": "WAREHOUSEUK", "returnOrderType": 1, "returnReason": "1", "returnNotes": null, "returnTrackNo": "0208a", "returnTime": null, "trackNo": "", "imagesUrl": null, "notes": null, "referenceNo": null, "afterSalesStatus": 40, "status": 60, "details": [ { "sku": "AX99001103", "productCode": "XOD6000018", "returnQty": 1, "dealWay": 5 } ], "costs": null, "afterSalesList": null, "returnLabelFlag": 1, "returnLabelNumber": "abc", "returnLabelUrl": "http:\/\/localhost:9300\/statics\/wmsabc\/2023\/06\/19\/33cf5d65-7a3d-4b30-87d5-a454d7532707.pdf?FO202304130002.pdf", "returnLabelMessage": "3", "deliverLabelNumber": "f1111", "deliverLabelUrl": "2", "deliverLabelMessage": "1" } ] } </code></pre> <h5>成功返回示例的参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>提示</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>返回码</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">array</td> <td>返回数据集合</td> </tr> <tr> <td style="text-align: left;">returnOrderCode</td> <td style="text-align: left;">string</td> <td>退货单号</td> </tr> <tr> <td style="text-align: left;">foNo</td> <td style="text-align: left;">object</td> <td>发货批次号</td> </tr> <tr> <td style="text-align: left;">orderNo</td> <td style="text-align: left;">string</td> <td>订单号</td> </tr> <tr> <td style="text-align: left;">afterSalesNo</td> <td style="text-align: left;">string</td> <td>售后方案编码</td> </tr> <tr> <td style="text-align: left;">warehouseCode</td> <td style="text-align: left;">string</td> <td>到货仓库编码</td> </tr> <tr> <td style="text-align: left;">returnOrderType</td> <td style="text-align: left;">string</td> <td>退件类型</td> </tr> <tr> <td style="text-align: left;">returnReason</td> <td style="text-align: left;">int</td> <td>退件原因</td> </tr> <tr> <td style="text-align: left;">returnNotes</td> <td style="text-align: left;">string</td> <td>退件说明</td> </tr> <tr> <td style="text-align: left;">returnTrackNo</td> <td style="text-align: left;">string</td> <td>退件跟踪号</td> </tr> <tr> <td style="text-align: left;">returnTime</td> <td style="text-align: left;">object</td> <td>退件时间</td> </tr> <tr> <td style="text-align: left;">trackNo</td> <td style="text-align: left;">string</td> <td>跟踪号</td> </tr> <tr> <td style="text-align: left;">imagesUrl</td> <td style="text-align: left;">string</td> <td>图片附件</td> </tr> <tr> <td style="text-align: left;">notes</td> <td style="text-align: left;">string</td> <td>描述</td> </tr> <tr> <td style="text-align: left;">referenceNo</td> <td style="text-align: left;">string</td> <td>关联单号</td> </tr> <tr> <td style="text-align: left;">afterSalesStatus</td> <td style="text-align: left;">int</td> <td>售后方案状态 10新建20待客户同意 30(客户已同意)仓库处理中 40已完成</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td>退件单状态 20待审核25审核不通过30异常35待客户确认40待仓库处理50仓库处理中55确认收货60完成处理100已作废</td> </tr> <tr> <td style="text-align: left;">details</td> <td style="text-align: left;">array</td> <td>退件详情</td> </tr> <tr> <td style="text-align: left;">details.sku</td> <td style="text-align: left;">string</td> <td>SKU</td> </tr> <tr> <td style="text-align: left;">details.productCode</td> <td style="text-align: left;">string</td> <td>产品编码</td> </tr> <tr> <td style="text-align: left;">details.returnQty</td> <td style="text-align: left;">int</td> <td>退货数量</td> </tr> <tr> <td style="text-align: left;">details.dealWay</td> <td style="text-align: left;">int</td> <td>处理方式 1重新上架2退回国内3良品上架4良品贴标上架5直接销毁 8产品升级 9检查10维修11拆件 12维修并发运 13上架不良品</td> </tr> <tr> <td style="text-align: left;">returnLabelFlag</td> <td style="text-align: left;">int</td> <td>是否需要回邮单 0:不需要 1:需要</td> </tr> <tr> <td style="text-align: left;">returnLabelNumber</td> <td style="text-align: left;">string</td> <td>回邮单跟踪号</td> </tr> <tr> <td style="text-align: left;">returnLabelUrl</td> <td style="text-align: left;">string</td> <td>回邮单地址</td> </tr> <tr> <td style="text-align: left;">returnLabelMessage</td> <td style="text-align: left;">string</td> <td>回邮单错误提示</td> </tr> <tr> <td style="text-align: left;">deliverLabelNumber</td> <td style="text-align: left;">string</td> <td>发运单跟踪号</td> </tr> <tr> <td style="text-align: left;">deliverLabelUrl</td> <td style="text-align: left;">string</td> <td>发运单地址</td> </tr> <tr> <td style="text-align: left;">deliverLabelMessage</td> <td style="text-align: left;">string</td> <td>发运单号错误提示</td> </tr> </tbody> </table>

页面列表

ITEM_HTML