/basicOpen/fbtShipment/cargo/list{
"operation": {
"method": "POST",
"path": "/basicOpen/fbtShipment/cargo/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/fbtShipment/cargo/list?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"offset\": 0,\n \"length\": 20,\n \"storeIdList\": [134225003201380864],\n \"startTime\": \"2026-04-01\",\n \"endTime\": \"2026-04-24\",\n \"timeType\": 0\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-04-23 12:00:00",
"data": {
"list": [
{
"actualDeliveryTime": "2026-04-01 12:00:00",
"cargoCode": "CARGO001",
"shippingWarehouse": "仓库A",
"createTime": "2026-04-01 12:00:00",
"deliveryTime": "2026-04-01 12:00:00",
"expectedDeliveryTime": "2026-04-01 12:00:00",
"id": 1234567890,
"orderGoodList": [
{
"declarationQuantity": 100,
"defectiveQuantity": 0,
"diffOfDeclareAndShip": 0,
"diffOfDeclareAndSign": 0,
"diffOfShipAndSign": 0,
"goodId": "GOOD001",
"id": 1234567890,
"imageUrl": "https://example.com/image.jpg",
"msku": "MSKU001",
"normalQuantity": 100,
"productId": "PROD001",
"productName": "示例商品",
"shipmentQuantity": 100,
"signedQuantity": 100,
"sku": "SKU001",
"skuId": "SKUID001"
}
],
"orderStatus": 1,
"orderStatusName": "已完成",
"shipStatus": "已发货",
"shippingInfo": [
{
"actualDeliveryTime": "2026-04-01 12:00:00",
"arrivalTime": "2026-04-01 12:00:00",
"shippingListCode": "SHP001",
"shippingNum": "100",
"shippingStatus": 1,
"shippingStatusName": "已发货"
}
],
"storeId": 134225003201380860,
"storeName": "示例店铺A",
"storeIds": [
134225003201380860,
134225003201380860
],
"storeNames": [
"示例店铺A",
"示例店铺B"
]
}
],
"offset": 0,
"length": 20,
"pages": 5
},
"total": 100
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | offset | 偏移量 | integer | — | Required | 偏移量,默认0 |
| 2 | length | 每页条数 | integer | — | Required | 每页条数,默认20,取值范围[1,200] |
| 3 | cargoLocalStatusList | 货件本地状态集合 | array<any> | — | Optional | 货件本地状态集合 |
| 4 | cargoStatusList | 货件平台状态集合 | array<any> | — | Optional | 货件平台状态集合 |
| 5 | creator | 创建人 | integer | — | Optional | 创建人 |
| 6 | diffOfDeclareAndShip | 申发差异 | integer | — | Optional | 申发差异: 0 申报量=发货量 1 申报量>发货量 2 申报量<发货量 |
| 7 | diffOfDeclareAndSign | 申收差异 | integer | — | Optional | 申收差异: 0 申报量=签收量 1 申报量>签收量 2 申报量<签收量 |
| 8 | diffOfSignAndDeclare | 收发差异 | integer | — | Optional | 收发差异: 0 签收量=发货量 1 签收量>发货量 2 签收量<发货量 |
| 9 | endTime | 结束时间 | string | — | Optional | 结束时间 |
| 10 | queryType | 搜索类型 | integer | — | Optional | 搜索类型: 0 cargoId 1 msku 2 sku 3 货件单号 4 发货单号 5 MSKU ID |
| 11 | queryValue | 搜索值 | array<any> | — | Optional | 搜索值 |
| 12 | shipStatus | 发货状况 | integer | — | Optional | 发货状况: 0 否 1 是 |
| 13 | startTime | 开始时间 | string | — | Optional | 开始时间 |
| 14 | storeIdList | 店铺ID集合 | array<any> | — | Optional | 店铺ID集合 |
| 15 | timeType | 时间类型 | integer | — | Optional | 时间类型: 0 创建时间 1 完成时间 |
| 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-04-23 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | list | 数据列表 | array<object> | — | Required | 数据列表 |
| 6.1.1 | actualDeliveryTime | 实际到货时间 | string | 2026-04-01 12:00:00 | Required | 实际到货时间 |
| 6.1.2 | cargoCode | 货件单号 | string | CARGO001 | Required | 货件单号 |
| 6.1.3 | shippingWarehouse | 收货仓 | string | 仓库A | Required | 收货仓 |
| 6.1.4 | createTime | 创建时间 | string | 2026-04-01 12:00:00 | Required | 创建时间 |
| 6.1.5 | deliveryTime | 发货时间 | string | 2026-04-01 12:00:00 | Required | 发货时间 |
| 6.1.6 | expectedDeliveryTime | 预计到货时间 | string | 2026-04-01 12:00:00 | Required | 预计到货时间 |
| 6.1.7 | id | 主表ID | integer | 1234567890 | Required | 主表ID |
| 6.1.8 | orderGoodList | 商品详情列表 | array<object> | — | Required | 商品详情列表 |
| 6.1.8.1 | declarationQuantity | 申报数量 | integer | 100 | Required | 申报数量 |
| 6.1.8.2 | defectiveQuantity | 次品数量 | integer | 0 | Required | 次品数量 |
| 6.1.8.3 | diffOfDeclareAndShip | 申发差异 | integer | 0 | Required | 申发差异 |
| 6.1.8.4 | diffOfDeclareAndSign | 申收差异 | integer | 0 | Required | 申收差异 |
| 6.1.8.5 | diffOfShipAndSign | 收发差异 | integer | 0 | Required | 收发差异 |
| 6.1.8.6 | goodId | 商品ID | string | GOOD001 | Required | 商品ID |
| 6.1.8.7 | id | 商品表ID | integer | 1234567890 | Required | 商品表ID |
| 6.1.8.8 | imageUrl | 商品图片URL | string | https://example.com/image.jpg | Required | 商品图片URL |
| 6.1.8.9 | msku | MSKU编码 | string | MSKU001 | Required | MSKU编码 |
| 6.1.8.10 | normalQuantity | 合格数量 | integer | 100 | Required | 合格数量 |
| 6.1.8.11 | productId | 产品ID | string | PROD001 | Required | 产品ID |
| 6.1.8.12 | productName | 品名 | string | 示例商品 | Required | 品名 |
| 6.1.8.13 | shipmentQuantity | 发货数量 | integer | 100 | Required | 发货数量 |
| 6.1.8.14 | signedQuantity | 签收数量 | integer | 100 | Required | 签收数量 |
| 6.1.8.15 | sku | sku | string | SKU001 | Required | SKU |
| 6.1.8.16 | skuId | SKU ID | string | SKUID001 | Required | SKU ID |
| 6.1.9 | orderStatus | 订单状态 | integer | 1 | Required | 订单状态 |
| 6.1.10 | orderStatusName | 订单状态名称 | string | 已完成 | Required | 订单状态名称 |
| 6.1.11 | shipStatus | 发货状态 | string | 已发货 | Required | 发货状态 |
| 6.1.12 | shippingInfo | 发货单信息列表 | array<object> | — | Required | 发货单信息列表 |
| 6.1.12.1 | actualDeliveryTime | 实际发货时间 | string | 2026-04-01 12:00:00 | Required | 实际发货时间 |
| 6.1.12.2 | arrivalTime | 到货时间 | string | 2026-04-01 12:00:00 | Required | 到货时间 |
| 6.1.12.3 | shippingListCode | 发货单号 | string | SHP001 | Required | 发货单号 |
| 6.1.12.4 | shippingNum | 发货数量 | string | 100 | Required | 发货数量 |
| 6.1.12.5 | shippingStatus | 发货状态 | integer | 1 | Required | 发货状态 |
| 6.1.12.6 | shippingStatusName | 发货状态名称 | string | 已发货 | Required | 发货状态名称 |
| 6.1.13 | storeId | 店铺ID(兼容字段 | integer | 134225003201380860 | Required | 店铺ID(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeIds;单店铺货件仍可使用该字段) |
| 6.1.14 | storeName | 店铺名称(兼容字段 | string | 示例店铺A | Required | 店铺名称(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeNames;单店铺货件仍可使用该字段) |
| 6.1.15 | storeIds | 店铺ID列表(跨店铺货件以该字段为准) | array<any> | [134225003201380860,134225003201380860] | Required | 店铺ID列表(跨店铺货件以该字段为准) |
| 6.1.16 | storeNames | 店铺名称列表(跨店铺货件以该字段为准) | array<any> | ["示例店铺A","示例店铺B"] | Required | 店铺名称列表(跨店铺货件以该字段为准) |
| 6.2 | offset | 当前偏移量 | integer | 0 | Required | 当前偏移量 |
| 6.3 | length | 每页条数 | integer | 20 | Required | 每页条数 |
| 6.4 | pages | 总页数 | integer | 5 | Required | 总页数 |
| 7 | total | 总数 | integer | 100 | Required | 总数 |
The 查询FBT货件列表 API (/basicOpen/fbtShipment/cargo/list) 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.