轻易云
注册体验

领星ERP查询物流 - 头程物流商接口

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

查询物流 - 头程物流商

POST/basicOpen/logistics/headLogisticsProvider/query/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/logistics/headLogisticsProvider/query/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/logistics/headLogisticsProvider/query/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"search\": {\n        \"page\": 1,\n        \"length\": 20\n    }\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
    "response_time": "2024-11-12 16:00:00",
    "data": {
      "total": 3,
      "providers": [
        {
          "providerId": "PROV001",
          "name": "顺丰速运",
          "code": "SFEXPRESS",
          "enabled": 1,
          "logisticsType": 1,
          "isAuth": 1,
          "supplierCode": 1001,
          "supplierName": "顺丰集团",
          "status": 1,
          "remark": "国内主要快递服务商",
          "payMethod": 1,
          "contactName": "王经理",
          "contactPhone": "13812345678",
          "creatorId": 10001,
          "creatorName": "管理员A",
          "createdAt": 1704067200
        },
        {
          "providerId": "PROV002",
          "name": "DHL国际快递",
          "code": "DHLINTL",
          "enabled": 1,
          "logisticsType": 3,
          "isAuth": 1,
          "supplierCode": 2001,
          "supplierName": "DHL集团",
          "status": 1,
          "remark": "全球领先的国际快递服务商",
          "payMethod": 2,
          "contactName": "李女士",
          "contactPhone": "13987654321",
          "creatorId": 10002,
          "creatorName": "管理员B",
          "createdAt": 1704067300
        },
        {
          "providerId": "PROV003",
          "name": "菜鸟裹裹",
          "code": "CAINIAO",
          "enabled": 1,
          "logisticsType": 4,
          "isAuth": 1,
          "supplierCode": 3001,
          "supplierName": "阿里巴巴",
          "status": 1,
          "remark": "平台聚合物流服务",
          "payMethod": 1,
          "contactName": "赵先生",
          "contactPhone": "13700112233",
          "creatorId": 10001,
          "creatorName": "管理员A",
          "createdAt": 1704067400
        }
      ]
    },
    "total": 3
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1search搜索参数对象object—可选搜索参数对象
1.1length分页长度integer—可选分页长度,每页显示的记录数
1.2page页码integer—可选页码,从1开始
1.3enabled启用状态integer—可选启用状态,枚举值:0-禁用, 1-启用,默认启用
1.4isAuth是否api对接integer—可选是否api对接,枚举值:0-否, 1-是,默认是
1.5payMethod结算方式integer—可选结算方式,枚举值:1-现结, 2-月结,默认现结
1.6searchField搜索字段string—可选搜索字段,指定搜索的目标字段名称,code 代码 ,name 物流商,默认物流商
1.7searchValue搜索值string—可选搜索值,用于模糊搜索物流商名称、编码等

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1total总记录数integer100必填总记录数
2.2providers物流商列表array<object>—必填物流商列表
2.2.1providerId物流商idstring—可选物流商id
2.2.2name物流商名string—可选物流商名
2.2.3code物流商代码string—可选物流商代码
2.2.4enabled是否启用 0禁用 1 启用integer—可选是否启用 0禁用 1 启用
2.2.5logisticsType类型integer—可选类型 0 API物流 1 自定义物流 2 第三方仓物流 3 头程物流 4 平台物流
2.2.6isAuth是否api对接integer—可选是否api对接 0 否 1 是
2.2.7supplierCode授权方codeinteger—可选授权方code
2.2.8supplierName授权方string—可选授权方
2.2.9status授权状态integer—可选授权状态 0 未授权 1 已授权
2.2.10remark备注string—可选备注
2.2.11payMethod结算方式integer—可选结算方式
2.2.12contactName联系人string—可选联系人
2.2.13contactPhone联系电话string—可选联系电话
2.2.14creatorId创建人idinteger—可选创建人id
2.2.15creatorName创建人名string—可选创建人名
2.2.16createdAt创建时间integer—可选创建时间,Unix时间戳(秒)
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

领星ERP的接口:查询物流 - 头程物流商(/basicOpen/logistics/headLogisticsProvider/query/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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