AI-WMS PLUS 标准API平台

储位库存查询接口

一、说明

主要用于第三方系统调用此接口查询AI-WMS PLUS中的储位库存数据，即储位的库存数据。

版本：2025-12-25日的5.0版本（以上）

二、参数说明

1、请求方式

请求方式 POST
接口地址 http://服务器IP或机器名或域名/WMS/API/SYS/StorageInventoryQuery
格式 JSON
编码类型 UTF-8

2、header参数

KEY VALUE
Content-Type application/json
Authorization token值 说明：授权接口所获取的值

3、请求参数

  字段

字段名

字段类型

长度

必填

说明

oth_task_id

第三方任务单号

String

100

是

任务唯一ID

warehouse_code

 仓库代号 String   是 支持多个仓库同时查询，仓库代号之间用;隔开（不支持含下属）
storage_code 储位代号 String     支持多个储位同时查询，代号之间用；隔开

owner_code

 货主编码 String 30 是 未启用多货主时，固定传入OWNER

item_code

 货品代号 String     支持多个货品同时查询，货品代号之间用；隔开

category_code

 中类代号 String     支持多个中类同时查询，中类代号之间用；隔开（不支持含下属）
batch_code 批号 String     支持多个批号同时查询，批号之间用；隔开
limit 每页查询记录数 int     为0时，则视为1000
offset 查询第几页 int     为0时，则视为第1页

4、返回参数

字段代号 字段名称 字段类型 长度 必填  说明
code 成功标记 String 10 是 返回0则表示成功，其他则为失败
message 返回信息 String 200    
oth_task_id 第三方任务代号 String 100    
limit 每页查询记录数 int      
offset 查询第几页 int      
total 总共记录数 int      
datas<库存明细记录>
qty 数量 float      
qty1 数量(副) float      
inbound_qty 入库数量 float      
inbound_qty1 入库数量 (副) float      
outbound_qty 出库数量 float      
outbound_qty1 出库数量 (副) float      
plan_outbound_qty 计划出库量 float      
plan_outbound_qty1 计划出库量 (副) float      
picked_qty 拣货量 float      
picked_qty1 拣货量 (副) float      
inventory_inspect_qty 库存检验量 float      
inventory_inspect_qty1 库存检验量 (副) float      
owner_code 货主编码 String      
warehouse_code 仓库代号 String      
warehouse_name 仓库名称 String      
storage_code 储位代号 String      
storage_name 储位名称 String      
item_code 货品代号 String      
item_name 货品名称 String      
sku_property 特征 String      
sku_name 特征名称 String      
batch_code 批号 String      
expiry_date 有效日期 Datatime      
production_date 生产日期 Datatime      
latest_outbound_date 最近出库日期 Datatime      
latest_inbound_date 最近入库日期 Datatime      
latest_upshelf_date 最近上架日期 Datatime      
latest_downshelf_date 最近下架日期 Datatime      
insert_date 插入时间 Datatime      

三、请求JSON范例

{
"oth_task_id": "{{$guid}}", //必填，第三方任务代号，必须唯一
"warehouse_code": "YTLK1", //必填，仓库代号，支持多个仓库同时查询，仓库代号之间用;隔开（不支持含下属）
"storage_code": "", //储位代号，支持多个储位同时查询，代号之间用；隔开
"owner_code": "OWNER", //必填，货主编码，未启用多货主时，固定传入OWNER；
"item_code": "T3001", //货品代号，支持多个货品同时查询，货品代号之间用；隔开
"category_code": "", //中类代号，支持多个中类同时查询，中类代号之间用；隔开（不支持含下属）
"batch_code": "", //批号，支持多个批号同时查询，批号之间用；隔开
"limit": "2", //每页查询记录数，为空时，则视为1000
"offset": "1" //查询第几页，为空时，则视为第1页
}

四、返回JSON范例

{
"datas": [
{
"storage_code": "YTLK1-01-01-01",
"storage_name": "YTLK1-01-01-01",
"latest_upshelf_date": "2025/12/25 0:00:00",
"latest_downshelf_date": "2025/12/25 0:00:00",
"owner_code": "OWNER",
"warehouse_code": "YTLK1",
"warehouse_name": "宇彤原料仓LK1",
"item_code": "T3001",
"item_name": "托盘库批号特征货品T3001",
"sku_property": "AA",
"sku_name": "",
"batch_code": "251225002",
"qty": 8.0,
"qty1": 0.0,
"inbound_qty": 36.0,
"inbound_qty1": 0.0,
"outbound_qty": 28.0,
"outbound_qty1": 0.0,
"plan_outbound_qty": 0.0,
"plan_outbound_qty1": 0.0,
"picked_qty": 0.0,
"picked_qty1": 0.0,
"inventory_inspect_qty": 0.0,
"inventory_inspect_qty1": 0.0,
"expiry_date": "",
"production_date": "2025/12/25 0:00:00",
"latest_outbound_date": "2025/12/25 0:00:00",
"latest_inbound_date": "2025/12/25 0:00:00",
"insert_date": "2025/12/25 10:39:04"
},
{
"storage_code": "YTLK1-01-01-01",
"storage_name": "YTLK1-01-01-01",
"latest_upshelf_date": "2025/12/25 0:00:00",
"latest_downshelf_date": "",
"owner_code": "OWNER",
"warehouse_code": "YTLK1",
"warehouse_name": "宇彤原料仓LK1",
"item_code": "T3001",
"item_name": "托盘库批号特征货品T3001",
"sku_property": "AA",
"sku_name": "",
"batch_code": "251225004",
"qty": 10.0,
"qty1": 0.0,
"inbound_qty": 10.0,
"inbound_qty1": 0.0,
"outbound_qty": 0.0,
"outbound_qty1": 0.0,
"plan_outbound_qty": 0.0,
"plan_outbound_qty1": 0.0,
"picked_qty": 0.0,
"picked_qty1": 0.0,
"inventory_inspect_qty": 0.0,
"inventory_inspect_qty1": 0.0,
"expiry_date": "",
"production_date": "2025/12/25 0:00:00",
"latest_outbound_date": "",
"latest_inbound_date": "2025/12/25 0:00:00",
"insert_date": "2025/12/25 12:06:23"
}
],
"oth_task_id": "682b7491-6af7-4d98-891c-f9bc3fdf6a20",
"code": "0",
"message": null,
"limit": 2,
"offset": 1,
"total": 6
}