API
查询总库存(含DOI)
更新时间: 2021-01-29 10:38:17 访问次数:12291
接口说明

通过本接口用户可以查询指定海外仓的所有商库存及DOI数据。

使用场景

用户可以查询指定仓库的商品的库存及DOI数据。

接口英文名称

queryProductInventoryList4Page

备注

1、DOI 全英文拼写是(Days of Inventory),DOI计算方式=近30天日均库存数/近30天日均销售数量(以一国一仓为统计单位,即按照客户在同一国家使用的所有仓库库存记录统计)
DOI值越小 周转率越高
DOI值越大 周转率越差低

2、查询退货商品时,将按照退货RM码关联的SKU进行返回。比如RM1和RM2都关联SKU01,则返回SKU01,库存2。

请求说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
DOITier String() N DOI层级: 1:30以下 2:30-60 3:60-90 4:90以上 1
inventoryType String(10) Y 库存类型:Country:国家,Warehouse:仓库 Country
isActive String(1) N 商品是否有效,Y/NY
pageNum Integer(10) Y 页码 1
pageSize Integer(10) Y 每页显示数量 100
productCode String(510) N 商品编码 SKU1
name String(255) N 商品名称 MM
warehouseId String() Y 仓库ID,点击查询仓库ID 1000008
warehouseCode String() N 仓库Code,点击查询仓库Code DE0001
startTime String(20) N 库存变更开始时间
开始和结束时间跨度不能超过24小时
2020-01-01 00:00:0
endTime String(20) N 库存变更结束时间
开始和结束时间跨度不能超过24小时
2020-01-01 00:00:0
请求示例
{
"action": "queryProductInventoryList4Page",
"app_key": "rebecca",
"client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign":"CC3F32A4D985B8176E22525F6ABD7FA1",
"data": {
"categoryID": "",
"DOITier": "",
"inventoryType": "Country",
"isActive":"Y",
"pageNum": "1",
"pageSize": "100",
"productCode": "",
"name": "",
"specification": "",
"warehouseId": "",
"warehouseCode": "DE0001"
},
"format": "json",
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "8AB9BE71E5C0C9DBC5471327250B8A2C",
"sign_method": "md5",
"timestamp": "2015-06-16 00:19:26",
"version": "1.0"
}

                
返回出参
名称 类型 必填 说明 示例
averageSalesQty String() Y 近30天平均销量
averageSalesQty7 String() Y 近7天平均销量
averageSalesQty15 String() Y 近15天平均销量
averageStockQty String() Y 近30天平均库存
averageStockQty7 String() Y 近7天平均库存
averageStockQty15 String() Y 近15天平均库存
productCode String() Y 商品编码
specification String() Y 商品规格
qtyHisOut String() Y 历史出库
qtyAvailable String() Y 可用库存
DOI String() Y DOI
DOIAll String() Y 全部的DOI
avgSales String() Y 平均销量
eName String() Y 商品英文名字
isprohibitoutbound String() Y 是否禁止出库
prohibitUsableQty String() Y 禁止库存数量
isReturnInventoryString()Y是否退货库存
qtyOrdered String() Y 在途库存
qtyReserved String() Y 待出库
待出库=出库订单占用+冻结库存+丢失确认中
description String() Y 商品描述
name String() Y 商品中文名字
qtyHisIn String() Y 历史入库
specification String() N 规格
warehouseName String() Y 仓库名称
warehouseCode String() Y 仓库code
返回示例
{
"code": "0",
"msg": "操作成功",
"data":    {
"page":       {
"TotalRows": 1,
"NumRows": 100,
"StartRow": 1
},
"list": [      {
"qtyAvailable": "0",
"description": null,
"warehouseName": "DE Warehouse",
"warehouseCode": "DE0001",
"averageStockQty7": "",
"qtySellHisOut": 0,
"qtySw": "0",
"averageSalesQty7": "",
"qtyHisIn": "0",
"qtyHisOut": "0",
"DOI": "",
"productId": "",
"eName": "BB",
"averageStockQty15": "",
"qtyShareStorage": 0,
"DOIAll": "",
"specification": null,
"averageSalesQty15": "",
"avgSales": 0,
"averageSalesQty": "",
"prohibitUsableQty": 0,
"isReturnInventory": "Y",
"productCode": "SKU1",
"qtyReserved": "0",
"warehouseId": "1000089",
"qtyOrdered": "0",
"name": "MM",
"isprohibitoutbound": "N",
"averageStockQty": ""
}]
}
}