Lingxing
切换旧版

查询WFS库存列表 - v2

POST/basicOpen/multiplatform/wfs/stockSearch/v2

该接口对应系统界面新版WFS库存。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/wfs/stockSearch/v2HTTPSPOST10

请求参数

store_idarray<any>必填
店铺id
offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认15,上限200

请求示例

{
    "store_id": [
        "110418202566107648"
    ],
    "offset": 0,
    "length": 15
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 1979122130ba45e984cbc9b2e571d86f.1690513512438
response_timestring必填
响应时间
示例 2023-07-28 11:05:12
dataobject必填
响应数据
隐藏子属性
recordsarray<object>必填
列表数据
隐藏子属性
ats03_monthsstring必填
3个月内库龄
示例 2
ats1_yearsstring必填
12个月以上库龄
示例 2
ats36_monthsstring必填
3-6个月库龄
示例 2
ats69_monthsstring必填
6-9个月库龄
示例 3
ats912_monthsstring必填
9-12个月库龄
示例 2
available_quantitystring必填
WFS可售
示例 4
gtinstring必填
GTIN码
示例 00462301613707
inbound_quantitystring必填
标发在途
示例 13
item_idstring必填
平台商品id
示例 2301613700
platform_product_statusstring必填
商品状态:停售、在售
示例 在售
mskustring必填
msku
示例 ast6-purple-xl-du00
pidstring必填
本地商品id
示例 5764
product_namestring必填
品名
示例 pm
skustring必填
sku
示例 sku
quantitystring必填
总库存
示例 15
store_idstring必填
店铺id
示例 110000000018008005
store_namestring必填
店铺名称
示例 walmart测试店铺
warehouse_namestring必填
仓库名称
示例 walmart测试店铺05号加拿大仓
warehouse_unique_idstring必填
仓库id【雪花id】
示例 901337792229298176
pic_urlstring必填
图片url
示例 https://imagxxx/xxxx/5dc111.jpeg
totalstring必填
总数
示例 21

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "1979122130ba45e984cbc9b2e571d86f.1690513512438",
    "response_time": "2023-07-28 11:05:12",
    "data": {
        "total": "21",
        "records": [
            {
                "msku": "ast6-purple-xl-du00",
                "gtin": "00462301111",
                "pid": "5764",
                "sku": "wjc14_sku",
                "quantity": "15",
                "store_id": "110000000018008005",
                "store_name": "walmart测试店铺",
                "warehouse_unique_id": "90133779222911",
                "warehouse_name": "walmart测试店铺05号加拿大仓",
                "item_id": "230161371",
                "product_name": "wjc14_pm",
                "platform_product_status": "在售",
                "available_quantity": "13",
                "inbound_quantity": "2",
                "ats03_months": "3",
                "ats36_months": "4",
                "ats69_months": "5",
                "ats912_months": "6",
                "ats1_years": "7",
                "pic_url": "https://imagxxx/xxxx/5dc111.jpeg"
            }
        ]
    }
}

返回失败示例

{
    "code": 1,
    "message": "参数检验不通过",
    "error_details": ["length: length 最大值200"],
    "request_id": "f4044649b1be46398c7eb4e6eb6ab6d5.1684735739946",
    "response_time": "2023-05-22 14:08:59",
    "data": null
}