Lingxing
切换旧版

多平台 - 查询FBS库存

POST/basicOpen/multiplatform/fbs/stockSearch

支持多平台-查询FBS库存

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/fbs/stockSearchHTTPSPOST1

请求参数

lengthinteger
每页条数,必填,最大200
offsetinteger
偏移量,必填
storeIdsarray<any>
店铺ID列表,必填,对应查询多平台店铺信息接口对应字段【store_id】
hideZeroStorageinteger
是否隐藏0库存,默认0,枚举值:0-不隐藏,1-隐藏
whsIdListarray<any>
仓库ID列表

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/fbs/stockSearch?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "length": 20,
    "offset": 0,
    "storeIds": [110418202566107648],
    "hideZeroStorage": 1,
    "whsIdList": ["whs123456"]
}'

返回结果

Json Object

codeinteger必填
响应码
dataobject必填
返回数据
隐藏子属性
recordsarray<object>必填
列表数据
隐藏子属性
coverageDaysstring必填
周转天数
示例 30.5
excessStockinteger必填
超量数量
示例 10
fulfillMappingModestring必填
Fulfill Mapping Mode,枚举值:0-空,1-Bundle SKU,2-Parent SKU
示例 1
gmtCreateinteger必填
数据创建时间
示例 1706860800000
gmtModifiedinteger必填
数据更新时间
示例 1706860800000
idinteger必填
id
示例 123456789012345
inTransitPendingPutawayQtyinteger必填
待ASN入库
示例 30
inWhsCoverageDaysstring必填
在库周转天数
示例 15.5
irApprovalQtyinteger必填
已审批入库申请
示例 20
itemImagestring必填
图片
示例 https://example.com/image.jpg
itemNamestring必填
标题
示例 商品名称示例
last15Soldinteger必填
最近15天销量
示例 25
last30Soldinteger必填
最近30天销量
示例 50
last60Soldinteger必填
最近60天销量
示例 120
last7Soldinteger必填
最近7天销量
示例 15
last90Soldinteger必填
最近90天销量
示例 200
modelNamestring必填
规格
示例 XL/红色
mtskuIdstring必填
仓库SKU ID
示例 MTSKU001
notMovingTaginteger必填
Not Moving标签,枚举值:1-存在标签
示例 1
recommendReplenishmentQtyinteger必填
建议补货量
示例 50
reservedQtyinteger必填
已预留
示例 10
sellableQtyinteger必填
可销售
示例 100
sellingSpeedstring必填
销售速度
示例 2.5
shopSkuIdstring必填
店铺SKU ID
示例 SHOPSKU001
stockLevelstring必填
库存级别,枚举值:-1-正常,0-空,1-库存不足和无可售库存,2-低库存(待补货),3-已补货,4-超量
示例 -1
storeIdinteger必填
店铺ID
示例 1234567890
storeNamestring必填
店铺名称
示例 示例名称
unsellableQtyinteger必填
不可销售
示例 5
whsIdstring必填
仓库
示例 WHS001
totalinteger必填
计数
示例 21
error_detailsarray<any>必填
错误详情
messagestring必填
提示信息
request_idstring必填
请求id
response_timestring必填
响应时间
totalinteger必填
总记录数

返回成功示例

{
  "code": 0,
  "data": {
    "records": [
      {
        "coverageDays": "30.5",
        "excessStock": 10,
        "fulfillMappingMode": "1",
        "gmtCreate": 1706860800000,
        "gmtModified": 1706860800000,
        "id": 123456789012345,
        "inTransitPendingPutawayQty": 30,
        "inWhsCoverageDays": "15.5",
        "irApprovalQty": 20,
        "itemImage": "https://example.com/image.jpg",
        "itemName": "商品名称示例",
        "last15Sold": 25,
        "last30Sold": 50,
        "last60Sold": 120,
        "last7Sold": 15,
        "last90Sold": 200,
        "modelName": "XL/红色",
        "mtskuId": "MTSKU001",
        "notMovingTag": 1,
        "recommendReplenishmentQty": 50,
        "reservedQty": 10,
        "sellableQty": 100,
        "sellingSpeed": "2.5",
        "shopSkuId": "SHOPSKU001",
        "stockLevel": "-1",
        "storeId": 1234567890,
        "storeName": "示例名称",
        "unsellableQty": 5,
        "whsId": "WHS001"
      }
    ],
    "total": 21
  },
  "error_details": [],
  "message": "value",
  "request_id": "value",
  "response_time": "value",
  "total": 0
}