Qeasy Cloud
Get Started

领星ERP 查询FBC平台仓信息 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 · POST · 请求参数 20 个(必填 2) · 响应参数 55 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询FBC平台仓信息

POST/basicOpen/openapi/fbc/stockSearch
Factory
{
  "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"
    }
  }
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-08-21 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1page分页信息object—Required分页信息
6.1.1countIdcountIdstring—RequiredcountId
6.1.2current当前页integer1Required当前页
6.1.3hitCounthitCountbooleanfalseRequiredhitCount
6.1.4maxLimitmaxLimitinteger—RequiredmaxLimit
6.1.5optimizeCountSqloptimizeCountSqlbooleanfalseRequiredoptimizeCountSql
6.1.6orders排序列表array<object>—Required排序列表
6.1.6.1asc是否升序booleanfalseRequired是否升序
6.1.6.2column排序字段stringgmtCreateRequired排序字段
6.1.7pages总页数integer5Required总页数
6.1.8records数据列表array<object>—Required数据列表
6.1.8.1allocatedQuantity调仓中库存string0Required调仓中库存
6.1.8.2availableQuantityFBC可售库存string100RequiredFBC可售库存
6.1.8.3blockedQuantity已冻结库存string0Required已冻结库存
6.1.8.4companyId企业IDinteger12345Required企业ID
6.1.8.5gmtCreate数据创建时间string2026-08-21 10:00:00Required数据创建时间
6.1.8.6gmtModified数据更新时间string2026-08-21 12:00:00Required数据更新时间
6.1.8.7itemId平台商品IDstringB0CXXXXXXRequired平台商品ID
6.1.8.8litigationQuantity争议库存string0Required争议库存
6.1.8.9locationId地址Idstring—Required地址Id
6.1.8.10mskumskustringMSKU001Requiredmsku
6.1.8.11picUrl商品图片stringhttps://example.com/pic.jpgRequired商品图片
6.1.8.12pidpidinteger123456Requiredpid
6.1.8.13platformProductStatus商品状态string1Required商品状态:0-否,1-是
6.1.8.14productName品名string产品名称Required品名
6.1.8.15productUniqueId商品唯一IDstring1234567890Required商品唯一ID
6.1.8.16purchasePrice采购成本string10.50Required采购成本
6.1.8.17quantity总库存string100Required总库存
6.1.8.18quantityCostquantityCoststring—RequiredquantityCost
6.1.8.19removalQuantity移除库存string0Required移除库存
6.1.8.20returnQuantity退货库存string0Required退货库存
6.1.8.21skuskustringSKU001Requiredsku
6.1.8.22storeId店铺IDinteger123456Required店铺ID
6.1.8.23title标题string产品标题Required标题
6.1.8.24warehouseId仓库唯一IDstring1001Required仓库唯一ID
6.1.8.25warehouseName仓库名称string深圳仓Required仓库名称
6.1.8.26warehouseUniqueId仓库唯一IDstringWH001Required仓库唯一ID
6.1.9searchCountsearchCountbooleantrueRequiredsearchCount
6.1.10size每页条数integer20Required每页条数
6.1.11total总数integer100Required总数
6.2stockTotal总计信息object—Required总计信息
6.2.1allocatedQuantity调仓中库存string0Required调仓中库存
6.2.2availableQuantityFBC可售库存string500RequiredFBC可售库存
6.2.3blockedQuantity已冻结库存string0Required已冻结库存
6.2.4litigationQuantity争议库存string0Required争议库存
6.2.5quantity总库存string500Required总库存
6.2.6removalQuantity移除库存string0Required移除库存
6.2.7returnQuantity退货库存string0Required退货库存
6.3syncTime最新同步时间string2026-08-21 12:00:00Required最新同步时间

The 查询FBC平台仓信息 API (/basicOpen/openapi/fbc/stockSearch) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.