轻易云
注册体验

领星ERP查询FBT货件列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 15 个(必填 2) · 响应参数 49 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询FBT货件列表

POST/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&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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:查询FBT货件列表(/basicOpen/fbtShipment/cargo/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。