接口说明

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

使用场景

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

接口名称

winit.inventory.type.pageInv

请求说明

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

请求入参

名称	类型	必填	说明	示例
warehouseCodes	String(20)	Y	仓库编码, 示例：美西仓：US0001 开通仓群时，请传主仓	US0001
serviceType	String(30)	N	业务用途类型：2B、2C 为空默认2C	2C
merchandiseCode	String(40)	N	商品编码，后模糊查询
merchandiseSerno	String(20)	N	商品条码
merchandiseVos	List	N	商品集合	与merchandiseCode不要同时用
– merchandiseCode	String(40)	N	商品编码
– specification	String(100)	N	规格【白名单客户支持】
skuType	String	N	SKU类型 SINGLE：单一产品 BOX：箱产品 SUITE：套装产品	BOX
merchandiseGrade	String(30)	N	商品等级，为空默认良品良品：GOOD 不良品：DEFECTIVE	GOOD
inventoryChangeTimeType	String(3)	N	库存变更时间(startTime&endTime)类型: NEW:SKU库存产生的变动的最新时间(不填默认为A) ALL:SKU库存产生过变动的时间	ALL
startTime	String(20)	Y	库存变更开始时间,用做(SKU库存产生的最新变动或 SKU库存产生过的变动)时间获取属于此时间区间的SKU的库存数据。格式2020-01-01 00:00:00,必须和结束时间配合使用,建议每次查询范围一天注意：库存变更时间类型=ALL，时间范围不允许超过三天
endTime	String(20)	Y	库存变更结束时间,用做(SKU库存产生的最新变动或 SKU库存产生过的变动)时间获取属于此时间区间的SKU库存数据。格式2020-01-01 00:00:00,必须和开始时间配合使用,若需要获取最新变动,建议按当前时间查询入参
isFilterZeroInventory	String(1)	N	是否过滤在库库存为0的数据不填则不过滤	Y/N
pageVo	Array	Y	分页参数，默认第一页，查询10行
– pageNo	int	Y	页码
– pageSize	int	Y	每页条数

请求示例

{
  "action": "winit.inventory.type.pageInv",
  "app_key": "rebecca",
  "data": {
    "warehouseCodes": "US0001",
    "serviceType": "2C",
    "isFilterZeroInventory":"Y",
    "merchandiseVos":[
       {
       "merchandiseCode": "xxxxx",
       "specification":""
       }
    ]
    "merchandiseSerno": null,
    "skuType": "BOX",
    "provideChannel": "xxxxx",
    "merchandiseGrade": "GOOD",
    "salesChannel": null,
    "unit": null,
    "location": null,
    "organization": "xxxxx",
    "startTime": "2021-05-10 00:00:00",
    "endTime": "2021-05-11 00:00:00",
    "pageVo": {
      "pageNo": 1,
      "pageSize": "10"
    }
  },
  "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位数字
warehouseCode	String(20)	Y	仓库编码	USWC
merchandiseSerno	String(30)	Y	商品条码	M码
merchandiseCode	String(100)	Y	商品编码
specification	String(100)	N	商品规格
isActive	String(1)	Y	是否有效
merchandiseGrade	String	N	商品等级
skuType	String	N	SKU类型 SINGLE：单一产品 BOX：箱产品 SUITE：套装产品	BOX
standardQty	Integer	N	库存单元标准件数	5
isShareInventory	String	N	是否共享库存	Y
unit	String	N	库存单位
provideChannel	String	N	供应渠道
salesChannel	String	N	销售渠道
serviceType	String	N	业务用途类型，2B或2C
inStockQty	Integer	Y	在库总库存在库总库存=可用+待发+丢失确认中+冻结+待销毁+失效VAT冻结+禁止出库
usableQty	Integer	Y	可用库存
frozenQty	Integer	Y	总冻结库存，总冻结=待出库数量+待销毁数量+冻结库存+丢失确认中库存+VAT冻结数量
onOrderQty	Integer	N	在途待入库
isProhibitOutbound	String(1)	Y	是否禁止出库, Y 为禁止，N为不禁止，PART为部分禁止
prohibitUsableQty	Integer	Y	禁止出库的可用库存数
PageSize	Numeric(10)	Y	每页的数据量
PageNum	Numeric()	Y	总数据页数
totalCount	Numeric()	Y	总数据量

返回示例

{
  "code": "0",
  "msg": "操作成功",
  "data":    {
      "pageParams": {
      "pageNo": 1,
      "pageSize": 1,
      "totalCount": 1
    },
    "list": [{
      "warehouseCode": "US0001",
      "usableQty": "0",
      "merchandiseSerno": "0",
      "specification": null,
      "merchandiseCode": "",
      "skuType":"BOX",
      "standardQty":5,
      "isShareInventory":"Y",
      "frozenQty": 22,
      "inStockQty": "0",
      "isActive": "Y",
      "version": "202207261740048100002"
    }]
  }
}

关键词