tinywms.inventory.items
搜索库存，支持关键字、库位与批次过滤
- 请求路由:
tinywms.inventory.items- 交互模型:
Request Stream- 访问限制: 无
请求
RSocket.rs({
"route" : "tinywms.inventory.items",
"args" : {
"search" : {
"keyword" : "Panda",
"location" : "A区"
},
"pg" : {
"page" : 0,
"size" : 20
}
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
search | Object | 否 | 搜索条件 |
search.skuNo | String | 否 | 需要匹配的 SKU 编号 |
search.location | String | 否 | 库位名称或编号 |
search.batchNumber | String | 否 | 批次号 |
search.unitIds | String[] | 否 | 往来单位id集合 |
search.tenantId | String | 否 | 租户id |
search.legalEntityId | String | 否 | 法人主体id |
search.customerId | String | 否 | 客户id |
search.keyword | String | 否 | 模糊匹配关键字 |
search.from | String | 否 | 查询起始时间，时间样式为RFC3339格式，如：2019-04-18T00:13:39.649Z |
search.to | String | 否 | 查询终止时间，时间样式为RFC3339格式，如：2019-04-19T00:13:39.649Z |
pg | Object | 否 | 分页配置 |
pg.page | Number | 否 | 页码，首页从0开始 |
pg.size | Number | 否 | 每页记录，默认为10 |
pg.sort | String[] | 否 | 排序字段清单，默认为升序，需要指定降序时在字段名后面添加desc并用分号隔开。 例如：["id", "crDate;desc"] |
返回
库存分页结果
[
{
"skuNo" : "BHGX-10-000001",
"productName" : "茵自然Panda,&lie, TH-0768-8",
"location" : "A区-货架3-层2-位5",
"quantityAvailable" : 5000
}
]
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
inventoryId | String | id |
skuNo | String | SKU 编号 |
productName | String | 货品中文名称 |
productNameEn | String | 货品英文名称 |
importPriceRmb | Number | 进口单价(人民币) |
exportPriceRmb | Number | 出口单价（人民币） |
spec | String | 规格型号信息，例如“1*96HC” |
unit | String | 计量单位，如“件” |
quantityAvailable | Number | 可用库存数量，可分配给新的出库单 |
quantityReserved | Number | 已锁定或预留的数量，不可再次分配 |
quantityPending | Number | 在途待入库的数量 |
quantityTaxPaidAvailable | Number | 已缴税可用数量，表示已完成缴税手续的库存数量 |
location | String | 库位信息，包含库区、货架、层位等描述 |
batchNumber | String | 批次号，用于追溯生产或入库批次 |
expirationDate | Object | 过期日期，ISO 8601（yyyy-MM-dd）格式 |
lastUpdated | String | 最后一次库存变更时间戳，使用 ISO 8601 格式 |
warehouse | Object | 仓库 |
warehouse.unitId | String | 往来单位id |
warehouse.country | String | 国家 |
warehouse.unitName | String | 往来单位名称（中文） |
warehouse.unitNameEn | String | 往来单位名称（英文） |
warehouse.unitAbbreviation | String | 往来单位缩写 |
warehouse.unitAddress | String | 往来单位地址（中文） |
warehouse.unitAddressEn | String | 往来单位地址（英文） |
warehouse.contactPerson | Object | 联系人信息 |
warehouse.contactPerson.username | String | 用户标识 |
warehouse.contactPerson.name | String | 用户名称 |
warehouse.contactPerson.mobile | String | 用户手机号 |
warehouse.extraProps | Object | 扩展信息 |
legalEntityId | String | 法人主体id |
customerId | String | 客户id |
extraProps | Object | 扩展属性 |
crBy | String | 创建者 |
upBy | String | 最后修改者 |
crDate | String | 创建时间 |
upDate | String | 最后修改时间 |
tenantId | String | 租户ID |
id | Varies | |
quantityTotal | Number | 库存总量。 |