接口说明

此接口支持查询分类库存，包括良品、不良品；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

请求示例

按库存管理分类条件查询

{
  "action": "winit.inventory.type.pageInv",
  "app_key": "rebecca",
  "data": {
    "warehouseCodes": "US0001",
    "serviceType": "2C",
    "merchandiseCode": "xxxxx",
    "specification": null,
     "inventoryAttribute":{
    "skuCodeThird": "xxxxx",
    "merchandiseGrade": "GOOD",
    "organization": "xxxxx"
    }
  },
  "format": "json",
  "language": "zh_CN",
  "platform": "sw",
  "sign": "00000000000000000000000000000000",
  "sign_method": "md5",
  "timestamp": "2021-10-25 09:58:35",
  "version": "1.0"
}

聚合库存管理分类查询

{
  "action": "winit.inventory.type.pageInv",
  "app_key": "rebecca",
  "data": {
    "warehouseCodes": "US0001",
    "serviceType": "2C",
    "merchandiseCode": "xxxxx",
    "specification": null,
    "aggregateInvManagerTypes": ["MERCHANDISE_GRADE","SKU_CODE_THIRD"]
  },
  "format": "json",
  "language": "zh_CN",
  "platform": "sw",
  "sign": "00000000000000000000000000000000",
  "sign_method": "md5",
  "timestamp": "2021-10-25 09:58:35",
  "version": "1.0"
}

返回出参

返回参数说明：正确的返回编码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	销售渠道

返回示例

{
  "code": "0",
  "msg": "操作成功",
  "data":    {
      "pageParams": {
      "pageNo": 1,
      "pageSize": 1,
      "totalCount": 1
    },
    "list": [{
      "warehouseCode": "US0001",
      "usableQty": "0",
      "merchandiseSerno": "0",
      "specification": null,
      "merchandiseCode": "",
      "frozenQty": 22,
      "inStockQty": "0",
      "isActive": "Y",
       "skuCodeThird": "xxxxx",
       "merchandiseGrade": "GOOD",
       "organization": "xxxxx"
    }]
  }
}

{
  "code": "0",
  "msg": "操作成功",
  "data":    {
      "pageParams": {
      "pageNo": 1,
      "pageSize": 1,
      "totalCount": 1
    },
    "list": [{
      "warehouseCode": "US0001",
      "usableQty": "0",
      "merchandiseSerno": "0",
      "specification": null,
      "merchandiseCode": "",
      "frozenQty": 22,
      "inStockQty": "0",
      "isActive": "Y",
       "skuCodeThird": "xxxxx",
       "organization": "xxxxx"
    }]
  }
}

关键词