接口说明

此接口适用于查询组织库存【平台\渠道\团队\子库库存】,需开通组织库存管理且分配对应组织库存后才支持查询，功能开通操作说明：组织库存功能操作说明（平台库存＼子库库存）

使用场景

用户可以指定仓库/国家内商品查询目前库存在不同组织的分配情况
用户可以指定仓库/国家内组织查询目前此组织内SKU的库存情况（注意，此查询方式仅返回组织内前1000SKU的库存情况）

接口名称

winit.inventory.sales.list

请求说明

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

请求入参

字段名	类型	是否必填	说明	示例
countryCode	String	N	国家简称编码 US：美国 UK：英国 CA：加拿大 DE：德国 AU：澳大利亚 ….	US
warehouseCodes	List	N	仓库编码	US001
salesChannels	List	N	用户自定义组织对应的编码比如亚马逊平台设置组织编码为：Amazon001 特殊场景：库存初始组织公共库存组织编码为：PUBLIC	PUBLIC
returnShop	String	N	是否返回平台信息 Y：返回
salesShop	Object	N	平台店铺信息List 组织必须配置国家编码一起查询,条件优先于组织编码，与salesChannels互斥
– salesPlatform	String	N	销售平台
– salesShop	String	N	销售店铺
items	List	N	商品信息List
– skuCode	String	N	商品编码注：最大200，不传时最大查询返回1000条库存数据	SKU001
– specification	String	N	规格白名单权限，SKU无规则则忽略此入参

请求示例

按库存管理分类条件查询

{
    "action": "winit.inventory.sales.list",
    "app_key": "rebecca",
    "data": {
        "countryCode": "US",
        "warehouseCode": "US0003",
        "salesChannel":"PUBLIC",
        "items":[{
           "skuCode":"",
           "specification":""
}]
    },
    "format": "json",
    "platform": "sw",
    "sign_method": "md5",
    "timestamp": "2024-08-02 10:30:28",
    "version": "1.0",
    "sign": "00000000000000000000000000000000",
    "language": "zh_CN"
}

返回出参

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

字段名	类型	是否必填	说明
warehouseCode	String	Y	仓库编码
countryCode	String	Y	国家编码
salsChannel	String	Y	组织编码
salesChannelName	String	Y	组织名称
skuCode	String	Y	商品编码
specification	String	N	规格
name	String	Y	商品名称
cnName	String	Y	商品中文名称
inStockQty	Int	Y	在库库存
usableQty	Int	Y	可用库存
frozenQty	Int	Y	冻结库存
onOrderQty	Int	Y	在途库存

返回示例

{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "ctx": null,
        "warehouseCode": "US0003",
        "countryCode": "US",
        "customerCode": "1000019",
        "salesChannel": "PUBLIC",
        "sku": "M010000000000905687",
        "name": "auto_sku_002",
        "cnName": "自动测试商品2 业务测试勿动",
        "skuCode": "auto_sku_002",
        "specification": "",
        "usableQty": 10
    }
}

关键词