Qeasy Cloud
Get Started

领星ERP 查询FBT货件列表 API

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

查询FBT货件列表

POST/basicOpen/fbtShipment/cargo/list
Factory
{
  "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&timestamp=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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1offset偏移量integer—Required偏移量,默认0
2length每页条数integer—Required每页条数,默认20,取值范围[1,200]
3cargoLocalStatusList货件本地状态集合array<any>—Optional货件本地状态集合
4cargoStatusList货件平台状态集合array<any>—Optional货件平台状态集合
5creator创建人integer—Optional创建人
6diffOfDeclareAndShip申发差异integer—Optional申发差异: 0 申报量=发货量 1 申报量>发货量 2 申报量<发货量
7diffOfDeclareAndSign申收差异integer—Optional申收差异: 0 申报量=签收量 1 申报量>签收量 2 申报量<签收量
8diffOfSignAndDeclare收发差异integer—Optional收发差异: 0 签收量=发货量 1 签收量>发货量 2 签收量<发货量
9endTime结束时间string—Optional结束时间
10queryType搜索类型integer—Optional搜索类型: 0 cargoId 1 msku 2 sku 3 货件单号 4 发货单号 5 MSKU ID
11queryValue搜索值array<any>—Optional搜索值
12shipStatus发货状况integer—Optional发货状况: 0 否 1 是
13startTime开始时间string—Optional开始时间
14storeIdList店铺ID集合array<any>—Optional店铺ID集合
15timeType时间类型integer—Optional时间类型: 0 创建时间 1 完成时间

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-04-23 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1list数据列表array<object>—Required数据列表
6.1.1actualDeliveryTime实际到货时间string2026-04-01 12:00:00Required实际到货时间
6.1.2cargoCode货件单号stringCARGO001Required货件单号
6.1.3shippingWarehouse收货仓string仓库ARequired收货仓
6.1.4createTime创建时间string2026-04-01 12:00:00Required创建时间
6.1.5deliveryTime发货时间string2026-04-01 12:00:00Required发货时间
6.1.6expectedDeliveryTime预计到货时间string2026-04-01 12:00:00Required预计到货时间
6.1.7id主表IDinteger1234567890Required主表ID
6.1.8orderGoodList商品详情列表array<object>—Required商品详情列表
6.1.8.1declarationQuantity申报数量integer100Required申报数量
6.1.8.2defectiveQuantity次品数量integer0Required次品数量
6.1.8.3diffOfDeclareAndShip申发差异integer0Required申发差异
6.1.8.4diffOfDeclareAndSign申收差异integer0Required申收差异
6.1.8.5diffOfShipAndSign收发差异integer0Required收发差异
6.1.8.6goodId商品IDstringGOOD001Required商品ID
6.1.8.7id商品表IDinteger1234567890Required商品表ID
6.1.8.8imageUrl商品图片URLstringhttps://example.com/image.jpgRequired商品图片URL
6.1.8.9mskuMSKU编码stringMSKU001RequiredMSKU编码
6.1.8.10normalQuantity合格数量integer100Required合格数量
6.1.8.11productId产品IDstringPROD001Required产品ID
6.1.8.12productName品名string示例商品Required品名
6.1.8.13shipmentQuantity发货数量integer100Required发货数量
6.1.8.14signedQuantity签收数量integer100Required签收数量
6.1.8.15skuskustringSKU001RequiredSKU
6.1.8.16skuIdSKU IDstringSKUID001RequiredSKU ID
6.1.9orderStatus订单状态integer1Required订单状态
6.1.10orderStatusName订单状态名称string已完成Required订单状态名称
6.1.11shipStatus发货状态string已发货Required发货状态
6.1.12shippingInfo发货单信息列表array<object>—Required发货单信息列表
6.1.12.1actualDeliveryTime实际发货时间string2026-04-01 12:00:00Required实际发货时间
6.1.12.2arrivalTime到货时间string2026-04-01 12:00:00Required到货时间
6.1.12.3shippingListCode发货单号stringSHP001Required发货单号
6.1.12.4shippingNum发货数量string100Required发货数量
6.1.12.5shippingStatus发货状态integer1Required发货状态
6.1.12.6shippingStatusName发货状态名称string已发货Required发货状态名称
6.1.13storeId店铺ID(兼容字段integer134225003201380860Required店铺ID(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeIds;单店铺货件仍可使用该字段)
6.1.14storeName店铺名称(兼容字段string示例店铺ARequired店铺名称(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeNames;单店铺货件仍可使用该字段)
6.1.15storeIds店铺ID列表(跨店铺货件以该字段为准)array<any>[134225003201380860,134225003201380860]Required店铺ID列表(跨店铺货件以该字段为准)
6.1.16storeNames店铺名称列表(跨店铺货件以该字段为准)array<any>["示例店铺A","示例店铺B"]Required店铺名称列表(跨店铺货件以该字段为准)
6.2offset当前偏移量integer0Required当前偏移量
6.3length每页条数integer20Required每页条数
6.4pages总页数integer5Required总页数
7total总数integer100Required总数

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.

Need to integrate this API?

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