轻易云
注册体验

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

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

查询WFS货件列表

POST/cepf/warehouse/api/openApi/queryWFSCargoPage
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/cepf/warehouse/api/openApi/queryWFSCargoPage"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "store_id": [
      "110418202566107648",
      "11098710969430528"
    ],
    "cargo_status_list": [
      1,
      2,
      3,
      4
    ],
    "inbound_order_id": "lkxxxxxx555",
    "start_time": "2023-07-15",
    "end_time": "2023-07-16",
    "offset": 0,
    "length": 15
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "c4db3691436d4acbbda0f8b1dc53fe97.1689845618385",
    "response_time": "2023-07-20 17:33:39",
    "data": {
      "total": "1",
      "records": [
        {
          "id": "200498",
          "in_bound_order_id": "test0508001-inbound-1",
          "store_id": "110000000018008001",
          "store_name": "测试店铺",
          "country_name": "美国",
          "creator": "",
          "shipping_list_codes": [
            "SP202307270010196"
          ],
          "logistics_code": "LRY03",
          "cargo_create_date": "2023-03-08 03:02:30",
          "cargo_code": "test0508001-shipment-1",
          "update_date": "2023-05-08 11:20:52",
          "cargo_status": "PENDING_SHIPMENT_DETAILS",
          "cargo_sync_status": "已申报",
          "distribution_addresses": "3 Sorbello Way,Pedricktown1,NJ9,美国,US,08067",
          "return_addresses": "860 W California Ave,Sunnyvale,94086,加拿大,CA",
          "cargo_good_list": [
            {
              "msku": "test1_sku1CIlPbdpXO1",
              "sku": "ueeshop1111",
              "product_name": "ueeshop1111",
              "gtin": "006344827368521",
              "shipments_num": "0",
              "received_num": "0",
              "declare_num": "10",
              "dameged_qty": "0"
            }
          ]
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1store_id店铺idarray<any>—可选店铺id
2cargo_status_list货件平台状态array<any>—可选货件平台状态: 0 PENDING_SHIPMENT_DETAILS 1 AWAITING_DELIVERY 2 RECEIVING_IN_PROGRESS 3 CLOSED 4 CANCELLED
3inbound_order_id入库订单编号string—可选入库订单编号
4start_time开始时间【创建时间】string—可选开始时间【创建时间】,格式:Y-m-d,双闭区间
5end_time结束时间【创建时间】string—可选结束时间【创建时间】,格式:Y-m-d,双闭区间
6offset分页偏移量integer—可选分页偏移量,默认0
7length分页长度integer—可选分页长度,默认15,上限200
8update_time_ge货件更新开始时间string—可选货件更新开始时间,格式:yyyy-MM-dd HH:mm:SS
9update_time_le货件更新结束时间string—可选货件更新结束时间,格式:yyyy-MM-dd HH:mm:SS
10cargo_update_time_ge货件平台更新时间开始 格式string—可选货件平台更新时间开始 格式:yyyy-MM-dd HH:mm:ss
11cargo_update_time_le货件平台更新时间结束 格式string—可选货件平台更新时间结束 格式:yyyy-MM-dd HH:mm:ss

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstringf4044649b1be46398c7eb4e6eb6ab6d5.1684735739946必填请求链路id
5response_time响应时间string2023-05-06 23:59:59必填响应时间
6data响应数据object—必填响应数据
6.1total总数string15必填总数
6.2records列表数据array<object>—必填列表数据
6.2.1idWFS货件idstring200498必填WFS货件id
6.2.2cargo_code货件单号stringlry-shipment-31必填货件单号
6.2.3cargo_create_date货件创建时间string2023-05-06 23:59:59必填货件创建时间
6.2.4cargo_good_list商品信息array<object>—必填商品信息
6.2.4.1declare_num货件初始申报量string10必填货件初始申报量
6.2.4.2gtinGTIN码stringgtin必填GTIN码
6.2.4.3mskumskustringmskuxxx必填msku
6.2.4.4product_name品名stringueeshop222bt必填品名
6.2.4.5received_num签收数量string10必填签收数量
6.2.4.6shipments_num已发货数量string10必填已发货数量
6.2.4.7skuskustringsku必填sku
6.2.4.8dameged_qty损坏数量string—必填损坏数量
6.2.5cargo_status平台货件状态stringPENDING_SHIPMENT_DETAILS必填平台货件状态
6.2.6cargo_sync_status货件本地状态string已申报必填货件本地状态
6.2.7country_name国家string美国必填国家
6.2.8creator创建者string王xxx必填创建者
6.2.9distribution_addresses配送地址(街道stringxxxxxxx必填配送地址(街道,城市,省/区,国家,国家编码,邮编)拼接
6.2.10in_bound_order_id入库订单编号stringlry-inbound-31必填入库订单编号
6.2.11logistics_code物流编号stringLRY03必填物流编号
6.2.12return_addresses退货地址(街道stringxxxxxxx必填退货地址(街道,城市,省/区,国家,国家编码)拼接)
6.2.13store_id店铺idstring110000000020008001必填店铺id
6.2.14store_name店铺名称string测试店铺必填店铺名称
6.2.15shipping_list_codes发货单号array<any>["SP202307250010002","SP202307250010001"]必填发货单号
6.2.16update_date更新时间string2023-05-06 23:59:59必填更新时间
6.2.17status货件状态integer—必填货件状态: 0 PENDING_SHIPMENT_DETAILS (等待发货详情) , 表示系统正在等待发货的详细信息 1 AWAITING_DELIVERY (等待送达) ,表示货物已发出,正在等待送达 2 RECEIVING_IN_PROGRESS (接收中) , 表示货物正在被接收处理中 3 CLOSED (已关闭) , 表示物流过程已完成并关闭 4 CANCELLED (已取消) , 表示物流过程已被取消
6.2.18status_name货件状态说明string—必填货件状态说明
6.2.19to_pending_timeto_pending_timestring—必填更新为Pending Shipment Details状态的时间戳
6.2.20to_await_timeto_await_timestring—必填更新为Awaiting Delivery状态的时间戳
6.2.21to_receive_timeto_receive_timestring—必填更新Receiving in Progress状态的时间戳
6.2.22to_closed_time更新为CLOSED状态的时间戳string—必填更新为CLOSED状态的时间戳
6.2.23to_cancelled_time更新为Cancelled状态的时间戳string—必填更新为Cancelled状态的时间戳

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

需要对接这个接口?

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