/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×tamp=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"
}
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | current | 当前页 | integer | — | Optional | 当前页 |
| 2 | custom | 自定义搜索条件 | object | — | Optional | 自定义搜索条件 |
| 2.1 | type | 搜索类型 | integer | — | Optional | 搜索类型:1-MSKU,2-GTIN码,3-商品ID,4-品名,5-sku,6-skc,7-spu |
| 2.2 | likeContent | 模糊查询内容 | string | — | Optional | 模糊查询内容 |
| 2.3 | likeContents | 模糊查询内容列表 | array<any> | — | Optional | 模糊查询内容列表 |
| 2.4 | inContentList | 数组精确查询 | array<any> | — | Optional | 数组精确查询 |
| 2.5 | code | fbs暂时没有用到 | string | — | Optional | fbs暂时没有用到 |
| 3 | hideZeroStorage | 是否隐藏0库存 | integer | — | Optional | 是否隐藏0库存,0-不隐藏,1-隐藏 |
| 4 | length | 每页条数 | integer | — | Required | 每页条数,默认20,上限200 |
| 5 | offset | 偏移量 | integer | — | Required | 偏移量,默认0 |
| 6 | orderColumnType | 排序字段类型 | string | — | Optional | 排序字段类型,默认gmtCreate-创建时间 |
| 7 | orderWay | 排序方式 | integer | — | Optional | 排序方式,0-倒序,1-正序 |
| 8 | qtyRange | 数量范围查询列表 | array<object> | — | Optional | 数量范围查询列表 |
| 8.1 | type | 字段类型 | string | — | Optional | 字段类型,支持:onHandQty, allocatedQty, unreconciledQty, inStockQty, fulfillableQty, unfulfillableQty, expiredQty, heldQty, unpickableQty, onTransferQty |
| 8.2 | max | 最大值 | string | — | Optional | 最大值 |
| 8.3 | min | 最小值 | string | — | Optional | 最小值 |
| 9 | qtySearchType | 数量查询类型 | integer | — | Optional | 数量查询类型:0-搜索子行,1-搜索父行 |
| 10 | storeIds | 店铺ID列表 | array<any> | — | Optional | 店铺ID列表 |
| 11 | total | 总数 | integer | — | Optional | 总数 |
| 12 | warehouseIds | 仓库ID列表 | array<any> | — | Optional | 仓库ID列表 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-08-21 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | page | 分页信息 | object | — | Required | 分页信息 |
| 6.1.1 | countId | countId | string | — | Required | countId |
| 6.1.2 | current | 当前页 | integer | 1 | Required | 当前页 |
| 6.1.3 | hitCount | hitCount | boolean | false | Required | hitCount |
| 6.1.4 | maxLimit | maxLimit | integer | — | Required | maxLimit |
| 6.1.5 | optimizeCountSql | optimizeCountSql | boolean | false | Required | optimizeCountSql |
| 6.1.6 | orders | 排序列表 | array<object> | — | Required | 排序列表 |
| 6.1.6.1 | asc | 是否升序 | boolean | false | Required | 是否升序 |
| 6.1.6.2 | column | 排序字段 | string | gmtCreate | Required | 排序字段 |
| 6.1.7 | pages | 总页数 | integer | 5 | Required | 总页数 |
| 6.1.8 | records | 数据列表 | array<object> | — | Required | 数据列表 |
| 6.1.8.1 | allocatedQuantity | 调仓中库存 | string | 0 | Required | 调仓中库存 |
| 6.1.8.2 | availableQuantity | FBC可售库存 | string | 100 | Required | FBC可售库存 |
| 6.1.8.3 | blockedQuantity | 已冻结库存 | string | 0 | Required | 已冻结库存 |
| 6.1.8.4 | companyId | 企业ID | integer | 12345 | Required | 企业ID |
| 6.1.8.5 | gmtCreate | 数据创建时间 | string | 2026-08-21 10:00:00 | Required | 数据创建时间 |
| 6.1.8.6 | gmtModified | 数据更新时间 | string | 2026-08-21 12:00:00 | Required | 数据更新时间 |
| 6.1.8.7 | itemId | 平台商品ID | string | B0CXXXXXX | Required | 平台商品ID |
| 6.1.8.8 | litigationQuantity | 争议库存 | string | 0 | Required | 争议库存 |
| 6.1.8.9 | locationId | 地址Id | string | — | Required | 地址Id |
| 6.1.8.10 | msku | msku | string | MSKU001 | Required | msku |
| 6.1.8.11 | picUrl | 商品图片 | string | https://example.com/pic.jpg | Required | 商品图片 |
| 6.1.8.12 | pid | pid | integer | 123456 | Required | pid |
| 6.1.8.13 | platformProductStatus | 商品状态 | string | 1 | Required | 商品状态:0-否,1-是 |
| 6.1.8.14 | productName | 品名 | string | 产品名称 | Required | 品名 |
| 6.1.8.15 | productUniqueId | 商品唯一ID | string | 1234567890 | Required | 商品唯一ID |
| 6.1.8.16 | purchasePrice | 采购成本 | string | 10.50 | Required | 采购成本 |
| 6.1.8.17 | quantity | 总库存 | string | 100 | Required | 总库存 |
| 6.1.8.18 | quantityCost | quantityCost | string | — | Required | quantityCost |
| 6.1.8.19 | removalQuantity | 移除库存 | string | 0 | Required | 移除库存 |
| 6.1.8.20 | returnQuantity | 退货库存 | string | 0 | Required | 退货库存 |
| 6.1.8.21 | sku | sku | string | SKU001 | Required | sku |
| 6.1.8.22 | storeId | 店铺ID | integer | 123456 | Required | 店铺ID |
| 6.1.8.23 | title | 标题 | string | 产品标题 | Required | 标题 |
| 6.1.8.24 | warehouseId | 仓库唯一ID | string | 1001 | Required | 仓库唯一ID |
| 6.1.8.25 | warehouseName | 仓库名称 | string | 深圳仓 | Required | 仓库名称 |
| 6.1.8.26 | warehouseUniqueId | 仓库唯一ID | string | WH001 | Required | 仓库唯一ID |
| 6.1.9 | searchCount | searchCount | boolean | true | Required | searchCount |
| 6.1.10 | size | 每页条数 | integer | 20 | Required | 每页条数 |
| 6.1.11 | total | 总数 | integer | 100 | Required | 总数 |
| 6.2 | stockTotal | 总计信息 | object | — | Required | 总计信息 |
| 6.2.1 | allocatedQuantity | 调仓中库存 | string | 0 | Required | 调仓中库存 |
| 6.2.2 | availableQuantity | FBC可售库存 | string | 500 | Required | FBC可售库存 |
| 6.2.3 | blockedQuantity | 已冻结库存 | string | 0 | Required | 已冻结库存 |
| 6.2.4 | litigationQuantity | 争议库存 | string | 0 | Required | 争议库存 |
| 6.2.5 | quantity | 总库存 | string | 500 | Required | 总库存 |
| 6.2.6 | removalQuantity | 移除库存 | string | 0 | Required | 移除库存 |
| 6.2.7 | returnQuantity | 退货库存 | string | 0 | Required | 退货库存 |
| 6.3 | syncTime | 最新同步时间 | string | 2026-08-21 12:00:00 | Required | 最新同步时间 |
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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.