轻易云
注册体验

领星ERP查询FBC平台仓信息接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 20 个(必填 2) · 响应参数 55 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询FBC平台仓信息

POST/basicOpen/openapi/fbc/stockSearch
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/openapi/fbc/stockSearch"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/openapi/fbc/stockSearch?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"current\": 1,\n    \"length\": 20,\n    \"offset\": 0,\n    \"storeIds\": [123456],\n    \"warehouseIds\": [\"1001\"],\n    \"orderColumnType\": \"gmtCreate\",\n    \"orderWay\": 0,\n    \"hideZeroStorage\": 0,\n    \"qtySearchType\": 0\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-08-21 12:00:00",
    "data": {
      "page": {
        "countId": "",
        "current": 1,
        "hitCount": false,
        "maxLimit": null,
        "optimizeCountSql": false,
        "orders": [],
        "pages": 5,
        "records": [
          {
            "allocatedQuantity": "0",
            "availableQuantity": "100",
            "blockedQuantity": "0",
            "companyId": 12345,
            "gmtCreate": "2026-08-21 10:00:00",
            "gmtModified": "2026-08-21 12:00:00",
            "itemId": "B0CXXXXXX",
            "litigationQuantity": "0",
            "locationId": "",
            "msku": "MSKU001",
            "picUrl": "https://example.com/pic.jpg",
            "pid": 123456,
            "platformProductStatus": "1",
            "productName": "产品名称",
            "productUniqueId": "1234567890",
            "purchasePrice": "10.50",
            "quantity": "100",
            "quantityCost": "",
            "removalQuantity": "0",
            "returnQuantity": "0",
            "sku": "SKU001",
            "storeId": 123456,
            "title": "产品标题",
            "warehouseId": "1001",
            "warehouseName": "深圳仓",
            "warehouseUniqueId": "WH001"
          }
        ],
        "searchCount": true,
        "size": 20,
        "total": 100
      },
      "stockTotal": {
        "allocatedQuantity": "0",
        "availableQuantity": "500",
        "blockedQuantity": "0",
        "litigationQuantity": "0",
        "quantity": "500",
        "removalQuantity": "0",
        "returnQuantity": "0"
      },
      "syncTime": "2026-08-21 12:00:00"
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1current当前页integer—可选当前页
2custom自定义搜索条件object—可选自定义搜索条件
2.1type搜索类型integer—可选搜索类型:1-MSKU,2-GTIN码,3-商品ID,4-品名,5-sku,6-skc,7-spu
2.2likeContent模糊查询内容string—可选模糊查询内容
2.3likeContents模糊查询内容列表array<any>—可选模糊查询内容列表
2.4inContentList数组精确查询array<any>—可选数组精确查询
2.5codefbs暂时没有用到string—可选fbs暂时没有用到
3hideZeroStorage是否隐藏0库存integer—可选是否隐藏0库存,0-不隐藏,1-隐藏
4length每页条数integer—必填每页条数,默认20,上限200
5offset偏移量integer—必填偏移量,默认0
6orderColumnType排序字段类型string—可选排序字段类型,默认gmtCreate-创建时间
7orderWay排序方式integer—可选排序方式,0-倒序,1-正序
8qtyRange数量范围查询列表array<object>—可选数量范围查询列表
8.1type字段类型string—可选字段类型,支持:onHandQty, allocatedQty, unreconciledQty, inStockQty, fulfillableQty, unfulfillableQty, expiredQty, heldQty, unpickableQty, onTransferQty
8.2max最大值string—可选最大值
8.3min最小值string—可选最小值
9qtySearchType数量查询类型integer—可选数量查询类型:0-搜索子行,1-搜索父行
10storeIds店铺ID列表array<any>—可选店铺ID列表
11total总数integer—可选总数
12warehouseIds仓库ID列表array<any>—可选仓库ID列表

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-08-21 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1page分页信息object—必填分页信息
6.1.1countIdcountIdstring—必填countId
6.1.2current当前页integer1必填当前页
6.1.3hitCounthitCountbooleanfalse必填hitCount
6.1.4maxLimitmaxLimitinteger—必填maxLimit
6.1.5optimizeCountSqloptimizeCountSqlbooleanfalse必填optimizeCountSql
6.1.6orders排序列表array<object>—必填排序列表
6.1.6.1asc是否升序booleanfalse必填是否升序
6.1.6.2column排序字段stringgmtCreate必填排序字段
6.1.7pages总页数integer5必填总页数
6.1.8records数据列表array<object>—必填数据列表
6.1.8.1allocatedQuantity调仓中库存string0必填调仓中库存
6.1.8.2availableQuantityFBC可售库存string100必填FBC可售库存
6.1.8.3blockedQuantity已冻结库存string0必填已冻结库存
6.1.8.4companyId企业IDinteger12345必填企业ID
6.1.8.5gmtCreate数据创建时间string2026-08-21 10:00:00必填数据创建时间
6.1.8.6gmtModified数据更新时间string2026-08-21 12:00:00必填数据更新时间
6.1.8.7itemId平台商品IDstringB0CXXXXXX必填平台商品ID
6.1.8.8litigationQuantity争议库存string0必填争议库存
6.1.8.9locationId地址Idstring—必填地址Id
6.1.8.10mskumskustringMSKU001必填msku
6.1.8.11picUrl商品图片stringhttps://example.com/pic.jpg必填商品图片
6.1.8.12pidpidinteger123456必填pid
6.1.8.13platformProductStatus商品状态string1必填商品状态:0-否,1-是
6.1.8.14productName品名string产品名称必填品名
6.1.8.15productUniqueId商品唯一IDstring1234567890必填商品唯一ID
6.1.8.16purchasePrice采购成本string10.50必填采购成本
6.1.8.17quantity总库存string100必填总库存
6.1.8.18quantityCostquantityCoststring—必填quantityCost
6.1.8.19removalQuantity移除库存string0必填移除库存
6.1.8.20returnQuantity退货库存string0必填退货库存
6.1.8.21skuskustringSKU001必填sku
6.1.8.22storeId店铺IDinteger123456必填店铺ID
6.1.8.23title标题string产品标题必填标题
6.1.8.24warehouseId仓库唯一IDstring1001必填仓库唯一ID
6.1.8.25warehouseName仓库名称string深圳仓必填仓库名称
6.1.8.26warehouseUniqueId仓库唯一IDstringWH001必填仓库唯一ID
6.1.9searchCountsearchCountbooleantrue必填searchCount
6.1.10size每页条数integer20必填每页条数
6.1.11total总数integer100必填总数
6.2stockTotal总计信息object—必填总计信息
6.2.1allocatedQuantity调仓中库存string0必填调仓中库存
6.2.2availableQuantityFBC可售库存string500必填FBC可售库存
6.2.3blockedQuantity已冻结库存string0必填已冻结库存
6.2.4litigationQuantity争议库存string0必填争议库存
6.2.5quantity总库存string500必填总库存
6.2.6removalQuantity移除库存string0必填移除库存
6.2.7returnQuantity退货库存string0必填退货库存
6.3syncTime最新同步时间string2026-08-21 12:00:00必填最新同步时间

领星ERP的接口:查询FBC平台仓信息(/basicOpen/openapi/fbc/stockSearch),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。