/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | offset | 偏移量 | integer | — | 必填 | 偏移量,默认0 |
| 2 | length | 每页条数 | integer | — | 必填 | 每页条数,默认20,取值范围[1,200] |
| 3 | cargoLocalStatusList | 货件本地状态集合 | array<any> | — | 可选 | 货件本地状态集合 |
| 4 | cargoStatusList | 货件平台状态集合 | array<any> | — | 可选 | 货件平台状态集合 |
| 5 | creator | 创建人 | integer | — | 可选 | 创建人 |
| 6 | diffOfDeclareAndShip | 申发差异 | integer | — | 可选 | 申发差异: 0 申报量=发货量 1 申报量>发货量 2 申报量<发货量 |
| 7 | diffOfDeclareAndSign | 申收差异 | integer | — | 可选 | 申收差异: 0 申报量=签收量 1 申报量>签收量 2 申报量<签收量 |
| 8 | diffOfSignAndDeclare | 收发差异 | integer | — | 可选 | 收发差异: 0 签收量=发货量 1 签收量>发货量 2 签收量<发货量 |
| 9 | endTime | 结束时间 | string | — | 可选 | 结束时间 |
| 10 | queryType | 搜索类型 | integer | — | 可选 | 搜索类型: 0 cargoId 1 msku 2 sku 3 货件单号 4 发货单号 5 MSKU ID |
| 11 | queryValue | 搜索值 | array<any> | — | 可选 | 搜索值 |
| 12 | shipStatus | 发货状况 | integer | — | 可选 | 发货状况: 0 否 1 是 |
| 13 | startTime | 开始时间 | string | — | 可选 | 开始时间 |
| 14 | storeIdList | 店铺ID集合 | array<any> | — | 可选 | 店铺ID集合 |
| 15 | timeType | 时间类型 | integer | — | 可选 | 时间类型: 0 创建时间 1 完成时间 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 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-04-23 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | list | 数据列表 | array<object> | — | 必填 | 数据列表 |
| 6.1.1 | actualDeliveryTime | 实际到货时间 | string | 2026-04-01 12:00:00 | 必填 | 实际到货时间 |
| 6.1.2 | cargoCode | 货件单号 | string | CARGO001 | 必填 | 货件单号 |
| 6.1.3 | shippingWarehouse | 收货仓 | string | 仓库A | 必填 | 收货仓 |
| 6.1.4 | createTime | 创建时间 | string | 2026-04-01 12:00:00 | 必填 | 创建时间 |
| 6.1.5 | deliveryTime | 发货时间 | string | 2026-04-01 12:00:00 | 必填 | 发货时间 |
| 6.1.6 | expectedDeliveryTime | 预计到货时间 | string | 2026-04-01 12:00:00 | 必填 | 预计到货时间 |
| 6.1.7 | id | 主表ID | integer | 1234567890 | 必填 | 主表ID |
| 6.1.8 | orderGoodList | 商品详情列表 | array<object> | — | 必填 | 商品详情列表 |
| 6.1.8.1 | declarationQuantity | 申报数量 | integer | 100 | 必填 | 申报数量 |
| 6.1.8.2 | defectiveQuantity | 次品数量 | integer | 0 | 必填 | 次品数量 |
| 6.1.8.3 | diffOfDeclareAndShip | 申发差异 | integer | 0 | 必填 | 申发差异 |
| 6.1.8.4 | diffOfDeclareAndSign | 申收差异 | integer | 0 | 必填 | 申收差异 |
| 6.1.8.5 | diffOfShipAndSign | 收发差异 | integer | 0 | 必填 | 收发差异 |
| 6.1.8.6 | goodId | 商品ID | string | GOOD001 | 必填 | 商品ID |
| 6.1.8.7 | id | 商品表ID | integer | 1234567890 | 必填 | 商品表ID |
| 6.1.8.8 | imageUrl | 商品图片URL | string | https://example.com/image.jpg | 必填 | 商品图片URL |
| 6.1.8.9 | msku | MSKU编码 | string | MSKU001 | 必填 | MSKU编码 |
| 6.1.8.10 | normalQuantity | 合格数量 | integer | 100 | 必填 | 合格数量 |
| 6.1.8.11 | productId | 产品ID | string | PROD001 | 必填 | 产品ID |
| 6.1.8.12 | productName | 品名 | string | 示例商品 | 必填 | 品名 |
| 6.1.8.13 | shipmentQuantity | 发货数量 | integer | 100 | 必填 | 发货数量 |
| 6.1.8.14 | signedQuantity | 签收数量 | integer | 100 | 必填 | 签收数量 |
| 6.1.8.15 | sku | sku | string | SKU001 | 必填 | SKU |
| 6.1.8.16 | skuId | SKU ID | string | SKUID001 | 必填 | SKU ID |
| 6.1.9 | orderStatus | 订单状态 | integer | 1 | 必填 | 订单状态 |
| 6.1.10 | orderStatusName | 订单状态名称 | string | 已完成 | 必填 | 订单状态名称 |
| 6.1.11 | shipStatus | 发货状态 | string | 已发货 | 必填 | 发货状态 |
| 6.1.12 | shippingInfo | 发货单信息列表 | array<object> | — | 必填 | 发货单信息列表 |
| 6.1.12.1 | actualDeliveryTime | 实际发货时间 | string | 2026-04-01 12:00:00 | 必填 | 实际发货时间 |
| 6.1.12.2 | arrivalTime | 到货时间 | string | 2026-04-01 12:00:00 | 必填 | 到货时间 |
| 6.1.12.3 | shippingListCode | 发货单号 | string | SHP001 | 必填 | 发货单号 |
| 6.1.12.4 | shippingNum | 发货数量 | string | 100 | 必填 | 发货数量 |
| 6.1.12.5 | shippingStatus | 发货状态 | integer | 1 | 必填 | 发货状态 |
| 6.1.12.6 | shippingStatusName | 发货状态名称 | string | 已发货 | 必填 | 发货状态名称 |
| 6.1.13 | storeId | 店铺ID(兼容字段 | integer | 134225003201380860 | 必填 | 店铺ID(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeIds;单店铺货件仍可使用该字段) |
| 6.1.14 | storeName | 店铺名称(兼容字段 | string | 示例店铺A | 必填 | 店铺名称(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeNames;单店铺货件仍可使用该字段) |
| 6.1.15 | storeIds | 店铺ID列表(跨店铺货件以该字段为准) | array<any> | [134225003201380860,134225003201380860] | 必填 | 店铺ID列表(跨店铺货件以该字段为准) |
| 6.1.16 | storeNames | 店铺名称列表(跨店铺货件以该字段为准) | array<any> | ["示例店铺A","示例店铺B"] | 必填 | 店铺名称列表(跨店铺货件以该字段为准) |
| 6.2 | offset | 当前偏移量 | integer | 0 | 必填 | 当前偏移量 |
| 6.3 | length | 每页条数 | integer | 20 | 必填 | 每页条数 |
| 6.4 | pages | 总页数 | integer | 5 | 必填 | 总页数 |
| 7 | total | 总数 | integer | 100 | 必填 | 总数 |
领星ERP的接口:查询FBT货件列表(/basicOpen/fbtShipment/cargo/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。