Lingxing
切换旧版

查询FBT货件列表

POST/basicOpen/fbtShipment/cargo/list

支持查询FBT货件列表,对应系统【多平台】>【平台仓】数据

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/fbtShipment/cargo/listHTTPSPOST1

请求参数

offsetinteger必填
偏移量,默认0
lengthinteger必填
每页条数,默认20,取值范围[1,200]
cargoLocalStatusListarray<any>
货件本地状态集合
cargoStatusListarray<any>
货件平台状态集合
creatorinteger
创建人
diffOfDeclareAndShipinteger
申发差异:
0 申报量=发货量
1 申报量>发货量
2 申报量<发货量
diffOfDeclareAndSigninteger
申收差异:
0 申报量=签收量
1 申报量>签收量
2 申报量<签收量
diffOfSignAndDeclareinteger
收发差异:
0 签收量=发货量
1 签收量>发货量
2 签收量<发货量
endTimestring
结束时间
queryTypeinteger
搜索类型:
0 cargoId
1 msku
2 sku
3 货件单号
4 发货单号
5 MSKU ID
queryValuearray<any>
搜索值
shipStatusinteger
发货状况:
0 否
1 是
startTimestring
开始时间
storeIdListarray<any>
店铺ID集合
timeTypeinteger
时间类型:
0 创建时间
1 完成时间

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/fbtShipment/cargo/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "offset": 0,
    "length": 20,
    "storeIdList": [134225003201380864],
    "startTime": "2026-04-01",
    "endTime": "2026-04-24",
    "timeType": 0
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-04-23 12:00:00
dataobject必填
响应数据
隐藏子属性
listarray<object>必填
数据列表
隐藏子属性
actualDeliveryTimestring必填
实际到货时间
示例 2026-04-01 12:00:00
cargoCodestring必填
货件单号
示例 CARGO001
shippingWarehousestring必填
收货仓
示例 仓库A
createTimestring必填
创建时间
示例 2026-04-01 12:00:00
deliveryTimestring必填
发货时间
示例 2026-04-01 12:00:00
expectedDeliveryTimestring必填
预计到货时间
示例 2026-04-01 12:00:00
idinteger必填
主表ID
示例 1234567890
orderGoodListarray<object>必填
商品详情列表
隐藏子属性
declarationQuantityinteger必填
申报数量
示例 100
defectiveQuantityinteger必填
次品数量
示例 0
diffOfDeclareAndShipinteger必填
申发差异
示例 0
diffOfDeclareAndSigninteger必填
申收差异
示例 0
diffOfShipAndSigninteger必填
收发差异
示例 0
goodIdstring必填
商品ID
示例 GOOD001
idinteger必填
商品表ID
示例 1234567890
imageUrlstring必填
商品图片URL
示例 https://example.com/image.jpg
mskustring必填
MSKU编码
示例 MSKU001
normalQuantityinteger必填
合格数量
示例 100
productIdstring必填
产品ID
示例 PROD001
productNamestring必填
品名
示例 示例商品
shipmentQuantityinteger必填
发货数量
示例 100
signedQuantityinteger必填
签收数量
示例 100
skustring必填
SKU
示例 SKU001
skuIdstring必填
SKU ID
示例 SKUID001
orderStatusinteger必填
订单状态
示例 1
orderStatusNamestring必填
订单状态名称
示例 已完成
shipStatusstring必填
发货状态
示例 已发货
shippingInfoarray<object>必填
发货单信息列表
隐藏子属性
actualDeliveryTimestring必填
实际发货时间
示例 2026-04-01 12:00:00
arrivalTimestring必填
到货时间
示例 2026-04-01 12:00:00
shippingListCodestring必填
发货单号
示例 SHP001
shippingNumstring必填
发货数量
示例 100
shippingStatusinteger必填
发货状态
示例 1
shippingStatusNamestring必填
发货状态名称
示例 已发货
storeIdinteger必填
店铺ID(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeIds;单店铺货件仍可使用该字段)
示例 134225003201380860
storeNamestring必填
店铺名称(兼容字段。平台支持跨店铺创建货件,跨店铺货件建议使用storeNames;单店铺货件仍可使用该字段)
示例 示例店铺A
storeIdsarray<any>必填
店铺ID列表(跨店铺货件以该字段为准)
示例 [134225003201380860,134225003201380860]
storeNamesarray<any>必填
店铺名称列表(跨店铺货件以该字段为准)
示例 ["示例店铺A","示例店铺B"]
offsetinteger必填
当前偏移量
示例 0
lengthinteger必填
每页条数
示例 20
pagesinteger必填
总页数
示例 5
totalinteger必填
总数
示例 100

返回成功示例

{
    "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": 134225003201380864,
                "storeName": "示例店铺A",
                "storeIds": [134225003201380864, 134225003201380865],
                "storeNames": ["示例店铺A", "示例店铺B"]
            }
        ],
        "offset": 0,
        "length": 20,
        "pages": 5
    },
    "total": 100
}