API
批量查询分类库存
更新时间: 2023-09-14 20:38:13 访问次数:599

接口说明

此接口支持查询分类库存,包括良品、不良品;2B、2C;组织等分类,支持组合不同分类进行查询

使用场景

用户可以查询指定万邑通海外仓的分类库存状态,并更新已变化的库存

接口名称

winit.inventory.type.batch.query

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
warehouseCode String(20) Y 仓库编码
开通仓群时,请传主仓
US0001
merchandises Array Y 商品,最少一个,最大500
–|merchandiseCode String(100) Y 商品编码 SKU001
–|specification String(40) N 规格,没有时为空,与商品编码组合代表一个商品
inventoryAttribute Object N 库存属性
–|merchandiseGrade String(30) N 商品等级(库存管理分类),
良品:GOOD
不良品:DEFECTIVE
GOOD
–|skuCodeThird String(30) N 库存条码值(库存管理分类)
第三方商品条码,如barcode
AS001
–|batchManagerType String N 批次属性, 按批次查询时需要和批次日期和产品批次号一起查询,仅传一个无效 PD
–|batchDate String(20) N 批次日期(库存管理分类),
与批次属性一起使用,仅传一个无效
20230101
–|packingBatchNo String(50) N 产品批次号,与批次属性一起使用
实物批次号
LOT001
aggregateInvManagerTypes Array N 聚合的库存管理分类,当传入了聚合分类时,具体分类的值请不要输入
支持分类:
条码值管理:SKU_CODE_THIRD
批次: BATCH
商品等级:MERCHANDISE_GRADE

请求示例

按库存管理分类条件查询

  1. {
  2. "action": "winit.inventory.type.pageInv",
  3. "app_key": "rebecca",
  4. "data": {
  5. "warehouseCodes": "US0001",
  6. "serviceType": "2C",
  7. "merchandiseCode": "xxxxx",
  8. "specification": null,
  9. "inventoryAttribute":{
  10. "skuCodeThird": "xxxxx",
  11. "merchandiseGrade": "GOOD",
  12. "organization": "xxxxx"
  13. }
  14. },
  15. "format": "json",
  16. "language": "zh_CN",
  17. "platform": "sw",
  18. "sign": "00000000000000000000000000000000",
  19. "sign_method": "md5",
  20. "timestamp": "2021-10-25 09:58:35",
  21. "version": "1.0"
  22. }

聚合库存管理分类查询

  1. {
  2. "action": "winit.inventory.type.pageInv",
  3. "app_key": "rebecca",
  4. "data": {
  5. "warehouseCodes": "US0001",
  6. "serviceType": "2C",
  7. "merchandiseCode": "xxxxx",
  8. "specification": null,
  9. "aggregateInvManagerTypes": ["MERCHANDISE_GRADE","SKU_CODE_THIRD"]
  10. },
  11. "format": "json",
  12. "language": "zh_CN",
  13. "platform": "sw",
  14. "sign": "00000000000000000000000000000000",
  15. "sign_method": "md5",
  16. "timestamp": "2021-10-25 09:58:35",
  17. "version": "1.0"
  18. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

名称 类型 必传 说明 示例
version String(25) Y 版本号,唯一,日期格式+唯一序列
yyyyMMddHHmmssSSS + 4位数字

merchandiseSerno String(30) Y 商品条码 M码
merchandiseCode String(100) Y 商品编码
specification String(100) N 商品规格
warehouseCode String(20) Y 仓库编码
isActive String(1) Y 是否有效
merchandiseGrade String N 商品等级
organization string N 组织
skuCodeThird String(30) N 库存条码值
inStockQty Integer Y 在库总库存
在库总库存=可用+待发+丢失确认中+冻结+待销毁+失效VAT冻结+禁止出库

usableQty Integer Y 可用库存
frozenQty Integer Y 总冻结库存,
总冻结=待出库数量+待销毁数量+冻结库存+丢失确认中库存+VAT冻结数量

onOrderQty Integer N 在途待入库
isProhibitOutbound String(1) Y 是否禁止出库,
Y 为禁止,N为不禁止,PART为部分禁止
prohibitUsableQty Integer Y 禁止出库的可用库存数
unit String(255) Y 库存单位
provideChannel String(255) Y 供应渠道
salesChannel String(255) Y 销售渠道

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "pageParams": {
  6. "pageNo": 1,
  7. "pageSize": 1,
  8. "totalCount": 1
  9. },
  10. "list": [{
  11. "warehouseCode": "US0001",
  12. "usableQty": "0",
  13. "merchandiseSerno": "0",
  14. "specification": null,
  15. "merchandiseCode": "",
  16. "frozenQty": 22,
  17. "inStockQty": "0",
  18. "isActive": "Y",
  19. "skuCodeThird": "xxxxx",
  20. "merchandiseGrade": "GOOD",
  21. "organization": "xxxxx"
  22. }]
  23. }
  24. }
  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "pageParams": {
  6. "pageNo": 1,
  7. "pageSize": 1,
  8. "totalCount": 1
  9. },
  10. "list": [{
  11. "warehouseCode": "US0001",
  12. "usableQty": "0",
  13. "merchandiseSerno": "0",
  14. "specification": null,
  15. "merchandiseCode": "",
  16. "frozenQty": 22,
  17. "inStockQty": "0",
  18. "isActive": "Y",
  19. "skuCodeThird": "xxxxx",
  20. "organization": "xxxxx"
  21. }]
  22. }
  23. }
关键词