OMS 对外开放接口说明

OMS 对外开放接口说明


查询入库单列表

<h5>简要描述</h5> <ul> <li>查询入库单列表</li> </ul> <h5>请求URL</h5> <ul> <li><code>/v1/warehousingEntry/list</code> </li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>请求参数示例</h5> <pre><code>{ "createTimeEndDate": "2022-05-26", "createTimeStartDate": "2022-05-19", "deliverEndDate": "2022-05-19", "deliverStartDate": "2022-05-19", "pageNum": 0, "pageSize": 0, "productCode": [ "string" ], "shelfEndDate": "2022-05-19", "shelfStartDate": "2022-05-19", "sku": [ "string" ], "status": [ "string" ], "updateTimeEndDate": "2022-05-26", "updateTimeStartDate": "2022-05-19", "warehouse": [ "string" ], "weNo": [ "string" ] } </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;">createTimeEndDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>创建结束时间</td> </tr> <tr> <td style="text-align: left;">createTimeStartDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>创建开始时间</td> </tr> <tr> <td style="text-align: left;">deliverEndDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>发货时间结束</td> </tr> <tr> <td style="text-align: left;">deliverStartDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>发货时间开始</td> </tr> <tr> <td style="text-align: left;">pageNum</td> <td style="text-align: left;">是</td> <td>string</td> <td>当前页码</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">是</td> <td>string</td> <td>每页行数</td> </tr> <tr> <td style="text-align: left;">productCode</td> <td style="text-align: left;">否</td> <td>array</td> <td>产品条码</td> </tr> <tr> <td style="text-align: left;">shelfEndDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>上架结束时间</td> </tr> <tr> <td style="text-align: left;">shelfStartDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>上架开始时间</td> </tr> <tr> <td style="text-align: left;">sku</td> <td style="text-align: left;">否</td> <td>array</td> <td>sku</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">否</td> <td>array</td> <td>状态10草稿20待审核25审核不通过30待收货40收货中50入库中60已入库100已作废</td> </tr> <tr> <td style="text-align: left;">updateTimeEndDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>更新结束时间</td> </tr> <tr> <td style="text-align: left;">updateTimeStartDate</td> <td style="text-align: left;">否</td> <td>string</td> <td>更新开始时间</td> </tr> <tr> <td style="text-align: left;">warehouse</td> <td style="text-align: left;">是</td> <td>array</td> <td>入库目的仓库,不传为当前用户的所有仓库</td> </tr> <tr> <td style="text-align: left;">weNo</td> <td style="text-align: left;">否</td> <td>array</td> <td>入库单号</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>{ "total": 20, "rows": [ { "weNo": "WE202205190002-YTD", "destinationWarehouseCode": "SZTEST", "deliverDate": "2022-05-19 00:00:00", "estimatedArrivalDate": "2022-05-19 00:00:00", "logisticTrackNo": "T8795466", "referenceNo": "WE202205190002-YTD", "logisticCompanyName": null, "transportModeCode": "2", "cabinetSpecifications": null, "invoiceAmount": null, "insuredAmount": null, "declareType": null, "isPickup": null, "status": null, "notes": null, "warehouseNotes": null, "filesUrl": null, "imageUrl": null, "arrivalDate": null, "inStockTime": null, "boxSum": "1", "warehouseName": "SZTEST[深圳测试仓]", "snFlag":"true", "warehousingEntryBoxList": [ { "boxNo": 1, "length": 12.54, "width": 11.21, "height": 13.1, "weight": 15700, "notes": "", "checkedLength": 13.1, "checkedWidth": 11.21, "checkedHeight": 13.1, "checkedWeight": 15700, "checkedNotes": null, "warehousingEntryDetailList": [ { "boxNo": 1, "sku": "AX99001101", "productCode": "XOD6000020", "productName": "洗衣机AX99001101", "checkedLength": 12.54, "checkedWidth": 11.21, "checkedHeight": 13.1, "checkedWeight": 15700, "declareValue": 100, "qty": 1, "inStockQty": null, "checkedQty": null } ] } ], "createUser": "admin", "createTime": "2022-05-19 15:22:17.697", "updateUser": "admin", "updateTime": "2022-05-19 15:48:02.612" }, { "weNo": "WE202205190001-YTD", "destinationWarehouseCode": "SZTEST", "deliverDate": "2022-03-16 08:00:00", "estimatedArrivalDate": "2022-03-16 08:00:00", "logisticTrackNo": "T00001API", "referenceNo": "R0001API", "logisticCompanyName": null, "transportModeCode": "2", "cabinetSpecifications": null, "invoiceAmount": null, "insuredAmount": null, "declareType": null, "isPickup": null, "status": null, "notes": "test", "warehouseNotes": null, "filesUrl": "", "imageUrl": "", "arrivalDate": null, "inStockTime": null, "boxSum": "1", "warehouseName": "SZTEST[深圳测试仓]", "warehousingEntryBoxList": [ { "boxNo": 0, "length": 20, "width": 20, "height": 20, "weight": 20000, "notes": "", "checkedLength": 20, "checkedWidth": 20, "checkedHeight": 20, "checkedWeight": 20000, "checkedNotes": null, "warehousingEntryDetailList": [ { "boxNo": 0, "sku": "SKU-YTD-RED-API-0001", "productCode": "XOD6000693", "productName": "SKU-YTD-RED-API-0001-NAME", "checkedLength": 10, "checkedWidth": 10, "checkedHeight": 10, "checkedWeight": 10, "declareValue": 0, "qty": 2, "inStockQty": null, "checkedQty": null, "manufactureBatch":null; } ] } ], "createUser": "apisys", "createTime": "2022-05-19 14:44:24.209", "updateUser": "apisys", "updateTime": "2022-05-20 10:10:12.419" } ], "code": 200, "msg": "查询成功" } </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;">total</td> <td style="text-align: left;">string</td> <td>无</td> </tr> <tr> <td style="text-align: left;">rows</td> <td style="text-align: left;">array</td> <td>无</td> </tr> <tr> <td style="text-align: left;">weNo</td> <td style="text-align: left;">string</td> <td>入库单号</td> </tr> <tr> <td style="text-align: left;">destinationWarehouseCode</td> <td style="text-align: left;">string</td> <td>目的仓代码</td> </tr> <tr> <td style="text-align: left;">deliverDate</td> <td style="text-align: left;">string</td> <td>发货日期 yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">estimatedArrivalDate</td> <td style="text-align: left;">string</td> <td>预计到达日期 yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">logisticTrackNo</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;">logisticCompanyName</td> <td style="text-align: left;">object</td> <td>物流公司名称</td> </tr> <tr> <td style="text-align: left;">transportModeCode</td> <td style="text-align: left;">string</td> <td>运输方式</td> </tr> <tr> <td style="text-align: left;">cabinetSpecifications</td> <td style="text-align: left;">object</td> <td>装柜规格</td> </tr> <tr> <td style="text-align: left;">invoiceAmount</td> <td style="text-align: left;">number</td> <td>发票总额(人民币)</td> </tr> <tr> <td style="text-align: left;">insuredAmount</td> <td style="text-align: left;">number</td> <td>保价金额(人民币)</td> </tr> <tr> <td style="text-align: left;">declareType</td> <td style="text-align: left;">string</td> <td>报关类型</td> </tr> <tr> <td style="text-align: left;">isPickup</td> <td style="text-align: left;">int</td> <td>是否取货</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td>10草稿20待审核25审核不通过30待收货40已签收50入库中50已入库100已作废</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;">warehouseNotes</td> <td style="text-align: left;">string</td> <td>仓库备注</td> </tr> <tr> <td style="text-align: left;">filesUrl</td> <td style="text-align: left;">string</td> <td>上传的文件路径</td> </tr> <tr> <td style="text-align: left;">imageUrl</td> <td style="text-align: left;">string</td> <td>上传图片Url仅一张</td> </tr> <tr> <td style="text-align: left;">arrivalDate</td> <td style="text-align: left;">string</td> <td>到达仓库日期yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">inStockTime</td> <td style="text-align: left;">string</td> <td>入库时间yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">boxSum</td> <td style="text-align: left;">int</td> <td>总箱数</td> </tr> <tr> <td style="text-align: left;">warehouseName</td> <td style="text-align: left;">string</td> <td>目的仓名字</td> </tr> <tr> <td style="text-align: left;">snFlag</td> <td style="text-align: left;">boolean</td> <td>是否支持一物一码</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList</td> <td style="text-align: left;">array</td> <td>无</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.boxNo</td> <td style="text-align: left;">string</td> <td>箱号</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.length</td> <td style="text-align: left;">number</td> <td>长cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.width</td> <td style="text-align: left;">number</td> <td>宽cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.height</td> <td style="text-align: left;">number</td> <td>高cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.weight</td> <td style="text-align: left;">number</td> <td>重量g</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.notes</td> <td style="text-align: left;">string</td> <td>备注</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.checkedLength</td> <td style="text-align: left;">number</td> <td>仓库核验长cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.checkedWidth</td> <td style="text-align: left;">number</td> <td>仓库核验宽cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.checkedHeight</td> <td style="text-align: left;">number</td> <td>仓库核验高cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.checkedWeight</td> <td style="text-align: left;">number</td> <td>仓库核验重量cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.checkedNotes</td> <td style="text-align: left;">string</td> <td>仓库核验备注</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList</td> <td style="text-align: left;">array</td> <td>箱明细</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.boxNo</td> <td style="text-align: left;">int</td> <td>箱号</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.sku</td> <td style="text-align: left;">string</td> <td>sku</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.productCode</td> <td style="text-align: left;">string</td> <td>sku条码</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.productName</td> <td style="text-align: left;">string</td> <td>产品名称</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.checkedLength</td> <td style="text-align: left;">number</td> <td>仓库核验长来自产品表单位cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.checkedWidth</td> <td style="text-align: left;">number</td> <td>仓库核验宽来自产品表单位cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.checkedHeight</td> <td style="text-align: left;">number</td> <td>仓库核验高来自产品表单位cm</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.checkedWeight</td> <td style="text-align: left;">number</td> <td>仓库核验重量来自产品表单位g</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.declareValue</td> <td style="text-align: left;">number</td> <td>申报价值单位$</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.qty</td> <td style="text-align: left;">int</td> <td>装箱数量</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.inStockQty</td> <td style="text-align: left;">int</td> <td>入库数</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.checkedQty</td> <td style="text-align: left;">int</td> <td>收货数</td> </tr> <tr> <td style="text-align: left;">warehousingEntryBoxList.warehousingEntryDetailList.manufactureBatch</td> <td style="text-align: left;">string</td> <td>生产批次号</td> </tr> <tr> <td style="text-align: left;">createUser</td> <td style="text-align: left;">string</td> <td>创建者</td> </tr> <tr> <td style="text-align: left;">createTime</td> <td style="text-align: left;">string</td> <td>创建时间yyyy-MM-dd HH:mm:ss.SSS</td> </tr> <tr> <td style="text-align: left;">updateUser</td> <td style="text-align: left;">string</td> <td>更新者</td> </tr> <tr> <td style="text-align: left;">updateTime</td> <td style="text-align: left;">string</td> <td>更新时间yyyy-MM-dd HH:mm:ss.SSS</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">int</td> <td>无</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>无</td> </tr> </tbody> </table> <h5>失败返回示例</h5> <pre><code>{ "errcode": "20006", "msg": "查询不到该单号的入库数据", "code": 500 } </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;">errcode</td> <td style="text-align: left;">string</td> <td>无</td> </tr> <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;">int</td> <td>无</td> </tr> </tbody> </table>

页面列表

ITEM_HTML