OMS接口文档

OMS接口文档


退换货单查询

<p><strong>简要描述:</strong> </p> <ul> <li>获取退换货信息</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://localhost:8080/api/billoperation/apiaction?token=607dce83a9894872a0f9fac9bbba31ed</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </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;">billnum</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>单据编码 ec_refundorder</td> </tr> <tr> <td style="text-align: left;">action</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>操作类型 searchInfos</td> </tr> <tr> <td style="text-align: left;">partParam</td> <td style="text-align: left;">是</td> <td style="text-align: left;">map</td> <td>查询条件集合</td> </tr> <tr> <td style="text-align: left;">headselectfields</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>需要返回的退换货单头字段 如tid,status 按逗号分隔 默认返回全部,强烈建议按需查询提高效率 返回字段可以参考:<a href="https://www.showdoc.cc/265424688438926?page_id=1968707423503684">https://www.showdoc.cc/265424688438926?page_id=1968707423503684</a></td> </tr> <tr> <td style="text-align: left;">headdefineselectfields</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>需要返回的退换货单头自定义字段 如define1,define2 如果不需要返回自定义项 此参数可不传</td> </tr> <tr> <td style="text-align: left;">bodyselectfields</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>需要返回的退换货单体字段 如tid,status 按逗号分隔 默认返回全部,强烈建议按需查询提高效率 返回字段可以参考:<a href="https://www.showdoc.cc/265424688438926?page_id=1968707423503684">https://www.showdoc.cc/265424688438926?page_id=1968707423503684</a></td> </tr> <tr> <td style="text-align: left;">bodydefineselectfields</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>需要返回的退换货单体自定义字段 如define1,define2 如果不需要返回自定义项 此参数可不传</td> </tr> <tr> <td style="text-align: left;">shipdetailfields</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>需要返回的退换货单退货明细自定义字段 如果不需要返回 此参数可不传</td> </tr> <tr> <td style="text-align: left;">pageIndex</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>页码</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>每页数据行数</td> </tr> <tr> <td style="text-align: left;">start_created</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>退款申请时间开始。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">end_created</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>退款申请时间结束。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">start_rpttime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>查询日结时间开始。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">end_rpttime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>查询日结时间结束。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">start_modified</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>修改时间开始。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">end_modified</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>修改时间结束。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">start_inboundtime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>查询入库时间开始。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">end_inboundtime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>查询入库时间结束。格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">inbound_status</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>入库状态</td> </tr> <tr> <td style="text-align: left;">plat</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>平台</td> </tr> <tr> <td style="text-align: left;">order_status</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>订单交易状态</td> </tr> <tr> <td style="text-align: left;">tid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>交易编号</td> </tr> <tr> <td style="text-align: left;">refund_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>退款单号</td> </tr> <tr> <td style="text-align: left;">oribillid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>退款单原单id</td> </tr> <tr> <td style="text-align: left;">ids</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>退换货订单ids 多个id用英文逗号分隔</td> </tr> <tr> <td style="text-align: left;">refund_phase</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>退款阶段</td> </tr> <tr> <td style="text-align: left;">refund_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>退款类型</td> </tr> <tr> <td style="text-align: left;">isClosed</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>关闭状态 0-未关闭,1-已关闭</td> </tr> <tr> <td style="text-align: left;">shopcode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>店铺编码</td> </tr> <tr> <td style="text-align: left;">wmsDeliveryCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>WMS入库单号</td> </tr> <tr> <td style="text-align: left;">blendId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>勾对ID</td> </tr> </tbody> </table> <p><strong>订单交易状态</strong></p> <table> <thead> <tr> <th style="text-align: left;">需要传入值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">waiting_buyer_to_pay</td> <td style="text-align: left;">待付款</td> </tr> <tr> <td style="text-align: left;">buyers_have_paid</td> <td style="text-align: left;">待发货</td> </tr> <tr> <td style="text-align: left;">sellers_have_been_shipped</td> <td style="text-align: left;">已发货</td> </tr> <tr> <td style="text-align: left;">sellers_have_been_shipped</td> <td style="text-align: left;">部分发货</td> </tr> <tr> <td style="text-align: left;">trade_closed</td> <td style="text-align: left;">交易关闭</td> </tr> <tr> <td style="text-align: left;">trade_refunding</td> <td style="text-align: left;">退款中</td> </tr> <tr> <td style="text-align: left;">trade_finished</td> <td style="text-align: left;">交易完成</td> </tr> </tbody> </table> <p><strong>平台状态sys_status</strong></p> <table> <thead> <tr> <th style="text-align: left;">需要传入值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">refund_closed</td> <td style="text-align: left;">退款关闭</td> </tr> <tr> <td style="text-align: left;">refund_no</td> <td style="text-align: left;">未申请退款</td> </tr> <tr> <td style="text-align: left;">refund_refuse</td> <td style="text-align: left;">卖家拒绝退款</td> </tr> <tr> <td style="text-align: left;">refund_success</td> <td style="text-align: left;">退款成功</td> </tr> <tr> <td style="text-align: left;">refund_wait_agree</td> <td style="text-align: left;">等待卖家同意退款</td> </tr> <tr> <td style="text-align: left;">refund_wait_buyer_returnGoods</td> <td style="text-align: left;">等待买家退货</td> </tr> <tr> <td style="text-align: left;">refund_wait_seller_confirmGoods</td> <td style="text-align: left;">等待卖家确认收货</td> </tr> <tr> <td style="text-align: left;">waiting_buyer_to_pay</td> <td style="text-align: left;">待付款</td> </tr> </tbody> </table> <p><strong>退款类型</strong></p> <table> <thead> <tr> <th style="text-align: left;">需要传入值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">退款</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">退货</td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">拒收</td> </tr> </tbody> </table> <p><strong>退款阶段</strong></p> <table> <thead> <tr> <th style="text-align: left;">需要传入值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">aftersale</td> <td style="text-align: left;">售后</td> </tr> <tr> <td style="text-align: left;">onsale</td> <td style="text-align: left;">售中</td> </tr> <tr> <td style="text-align: left;">sale</td> <td style="text-align: left;">售后/售中</td> </tr> </tbody> </table> <p><strong>入库状态</strong></p> <table> <thead> <tr> <th style="text-align: left;">需要传入值</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">0</td> <td style="text-align: left;">未入库</td> </tr> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">已入库</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">无需入库</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code>{ "partParam": { "headselectfields":"tid", "headdefineselectfields":"define10", "bodydefineselectfields":"define10", "bodyselectfields":"id", "pageIndex": "1", "pageSize": "10", "tid": "201905239991", "shopcode": "002" }, "billnum": "ec_refundorder", "action": "searchInfos" }</code></pre> <p><strong>返回示例</strong></p> <pre><code>{ "code": 200, "message": "操作成功", "data": { "pageIndex": 1, "pageSize": 10, "totalCount": 1, "info": [ { "tradeOrderCustomItem": { "id": 1242107325075712, "define10": "" }, "tradeOrderDetail": [ { "tradeOrderDetailCustomItem": { "id": 1242107325075713, "define10": "" }, "realNum": 0, "id": 1242107325075713, "parentid": 1242107325075712 }, { "realNum": 0, "id": 1242107325075714, "parentid": 1242107325075712 } ], "id": 1242107325075712, "tid": "201905239991" } ] } }</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML