全国快递查询

接口标识: express 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

全国快递查询接口输入快递单号（5~50位字母数字），即时返回承运快递公司及官网、物流状态（如已签收、运输中、派送中）、最后更新时间与完整物流轨迹时间线，轨迹最新在前，每条含所在地区、状态与描述。自动识别单号所属快递公司，也可按快递代号指定；查询顺丰、跨越速递、中通的单号需附带寄件人或收件人手机号（11位完整号或后4位）校验。适合电商订单跟踪、客服查件与物流监控。

详细介绍

![全国快递查询接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_express__1794169190_7c89fe028158.png)

输入一个快递单号，即可查到包裹的完整物流轨迹——快递公司、当前状态、最后更新时间与轨迹时间线一次返回。

## 接口概述

快递物流查询接口面向电商订单跟踪、客服查件等场景：传入快递单号 number（5~50 位字母数字，可含英文冒号与连字符），平台调用阿里云百炼接入的快递查询服务，同步返回该包裹的快递公司、物流状态与完整轨迹。顺丰、跨越速递、中通等快递公司出于隐私保护要求，查询时需同时提供寄件人或收件人手机号（11 位完整号码或后 4 位，通过 mobile 参数传入）；已知快递公司编码时可通过 type 参数辅助识别，不传则按单号自动识别。轨迹数组按时间倒序返回，最新动态排在最前。

## 核心能力

1. **单号查询**：输入单号即可获取完整物流信息，快递公司自动识别，无需预先判断承运方。
2. **状态总览**：返回物流状态描述（如运输中、派送中、已签收）与最后更新时间，一眼掌握包裹进展。
3. **完整轨迹**：轨迹数组按最新在前排序，每条轨迹为上游原样返回，节点信息完整可溯。
4. **隐私校验支持**：mobile 参数传入寄件人或收件人手机号，满足顺丰、跨越、中通等快递的隐私校验要求。
5. **指定快递公司**：type 参数可传入快递公司编码辅助识别，减少单号歧义带来的查询失败。

## 产品优势

- **接入简单**：number 是唯一必填参数，POST 请求、JSON 返回，订单系统集成成本低。
- **覆盖面广**：依托上游快递查询服务覆盖国内主流快递公司，具体覆盖范围以上游服务能力为准。
- **诚实返回**：轨迹内容由上游原样返回，平台不改写、不编造节点；查不到时返回明确的错误提示而非空数据。
- **降本增效**：替代人工逐个到快递官网查询的流程，订单跟踪、客服响应与异常监控自动化。

## 效果展示

一句话理解：它就像给订单系统装了一台「包裹追踪器」——报出单号，它告诉你包裹现在到哪了、谁签收了。

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| number | SF1390765432101 | 快递单号，必填，5~50 位字母数字 |
| mobile | 8866 | 寄件人或收件人手机号（11 位或后 4 位），查顺丰、跨越、中通等快递时必传 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 单号回显 | SF1390765432101 | `number` |
| 快递公司编码 | SF | `type` |
| 快递公司名称 | 顺丰速运 | `company` |
| 当前物流状态 | 已签收 | `logistics_status` |
| 最后更新时间 | 2026-11-05 14:32:18 | `the_last_time` |
| 物流轨迹（最新在前） | 【签收】您的快件已签收…… | `business_data`，轨迹数组，条目为上游原样返回，建议做存在性判断 |
| 快递公司官网 | https://www.sf-express.com | `cp_url` |

API请求示例：

```
POST /api/v1/express
number=SF1390765432101&mobile=8866
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "number": "SF1390765432101",
    "type": "SF",
    "company": "顺丰速运",
    "cp_url": "https://www.sf-express.com",
    "the_last_time": "2026-11-05 14:32:18",
    "logistics_status": "已签收",
    "business_data": [
      {
        "logisticsStatus": "SIGNED",
        "desc": "【签收】您的快件已签收（签收人：前台代收），感谢使用顺丰，期待再次为您服务",
        "areaName": "杭州市"
      },
      {
        "logisticsStatus": "DELIVERING",
        "desc": "【派送】顺丰速运快递员正在为您派件，请保持电话畅通",
        "areaName": "杭州市西湖区"
      },
      {
        "logisticsStatus": "TRANSPORT",
        "desc": "【运输】快件已到达杭州西湖中转场，正发往下一站",
        "areaName": "杭州市"
      },
      {
        "logisticsStatus": "ACCEPT",
        "desc": "【揽收】顺丰速运已收取快件",
        "areaName": "上海市"
      }
    ]
  },
  "request_id": "tg0553371793880222333444"
}
```

`data` 的七个顶层字段由平台固定返回，取不到时为空字符串；`business_data` 内的轨迹条目为上游原样透传，通常包含轨迹描述、状态与地区等字段，字段集合以实际返回为准，建议逐条做存在性判断后再解析入库。

## 应用场景

- **电商订单跟踪**：订单详情页实时展示物流状态与轨迹，减少「包裹到哪了」类咨询
- **客服系统**：客服输入单号即查轨迹，及时处理催件、异常与签收争议
- **物流异常监控**：批量轮询在途包裹，及时发现滞留、退回等异常节点并介入处理
- **签收确认**：包裹签收后自动更新订单状态，驱动结算、评价与后续流程
- **售后退货管理**：跟踪用户退货包裹的物流进度，掌握退货到账节奏

## 应用案例

- **电商平台客服组**：此前大促期间客服需复制单号到快递官网逐个查询，接入接口后工单页直接展示状态与轨迹，查件类咨询的处理效率明显提升。
- **社区团购平台**：供应商发货后平台自动查询包裹状态，签收后向团长与成员推送取货提醒，漏取与滞留件明显减少。
- **ERP 系统集成商**：把物流查询嵌入订单模块，长期无更新的在途订单自动标记异常并提醒运营介入，物流类投诉明显下降。

常见问题

Q：需要指定快递公司吗？

A：不需要，默认按单号自动识别；也可通过 type 参数传入快递公司编码辅助识别。单号格式要求5~50位字母数字（可含英文冒号与连字符），格式不符会直接返回参数错误提示。

Q：为什么有的快递要求传手机号？

A：顺丰、跨越速递、中通等快递公司出于隐私保护要求，查询时需校验寄件人或收件人手机号：通过 mobile 参数传入11位完整号码或后4位即可；未传时这类快递的查询可能失败。

Q：返回的内容有哪些？

A：固定返回 number（单号）、type（编码）、company（公司名称）、cp_url（官网）、the_last_time（最后更新时间）、logistics_status（状态描述）、business_data（轨迹数组，最新在前）七个字段；轨迹条目为上游原样返回，通常含轨迹描述、状态与地区字段，建议做存在性判断。

Q：查不到物流信息怎么办？

A：未查询到该单号的物流信息时返回错误提示。刚下单未被快递揽收的单号可能暂时没有轨迹，建议揽收后再查询；顺丰等需校验手机号的快递请先补传 mobile 参数。

快递查询物流查询快递单号物流轨迹快递跟踪订单跟踪

接口地址： https://www.phpwc.cn/api/express

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`number`	string	必填	-	快递/物流单号
`mobile`	string	选填	-	查顺丰/跨越速递/中通时要输入寄件人或收件人手机号，11 位完整手机号或手机号后 4 位
`type`	string	选填	-	快递/物流代号（不填则自动识别）

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`number`	string	快递/物流单号
`type`	string	快递/物流代号（如 SF/YT/ZTO 等）
`company`	string	快递/物流公司名称
`cp_url`	string	快递/物流公司官网
`the_last_time`	string	快递/物流最后更新时间
`logistics_status`	string	快递/物流状态描述（如"已签收"、"运输中"、"派送中"等）
`business_data`	array	物流轨迹数组（原样返回上游 logisticsTraceDetailList，含 areaCode/areaName/logisticsStatus/desc 等字段，最新在前）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试