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