快递取件码-取件码-物流取件码API接口介绍

举报
聚美智数 发表于 2026/06/26 14:10:49 2026/06/26
【摘要】 前言通过运单号和物流公司编码等信息发起订阅,当货物放入驿站/快递柜后,会将对应驿站取件码通过回调地址推送至客户。支持推送、查询两种方式获取取件码。如果没有传回调地址,也可以通过查询接口查询取件码(必须订阅成功后才可以使用查询接口,否则无效)。必须在运单进入驿站前发起订阅,否则无效。支持的驿站:下载支持的驿站清单共有发起订阅、查询取件码、推送3个功能。 应用场景需要有收货提醒功能的场景。例如...

前言

  • 通过运单号和物流公司编码等信息发起订阅,当货物放入驿站/快递柜后,会将对应驿站取件码通过回调地址推送至客户。
  • 支持推送、查询两种方式获取取件码。如果没有传回调地址,也可以通过查询接口查询取件码(必须订阅成功后才可以使用查询接口,否则无效)。
  • 必须在运单进入驿站前发起订阅,否则无效。
  • 支持的驿站:下载支持的驿站清单
  • 共有发起订阅、查询取件码、推送3个功能。

应用场景

需要有收货提醒功能的场景。例如购物APP、公众号等,用于日常收件、寄件与退换货、代取与特殊管理等。

API介绍

戳这里查看详情

发起订阅

  • 通过快递信息,发起订阅。

请求说明

名称 类型 必须
说明
shipperCode String 快递公司编码,详见:下载快递公司编码对照表
logisticCode String 运单号
callBackUrl String 回调地址
senderMobile String 发件人号码
virtualNumber String 虚拟号码(若单号做了隐私保护,可通过虚拟号查询)
senderAddress String 发件人地址
receiverMobile String 收件人电话
receiverAddress String 收件人地址

返回样例

{
  "code": 200,// 返回码,详见返回码说明
  "msg": "成功",// 返回码对应描述
  "taskNo": "043439882226367117195632",// 本次请求号
  "charge": true, // 计费标志
  "data": {
    "logisticCode": "79105030690097",//运单号
    "shipperCode": "ZTO" //快递公司编码
  }
}

查询取件码

请求说明

名称 类型 必须
说明
shipperCode String 快递公司编码
logisticCode String 运单号
senderMobile String 发件人号码
virtualNumber String 虚拟号码(若单号做了隐私保护,可通过虚拟号查询)
senderAddress String 发件人地址
receiverMobile String 收件人电话
receiverAddress String 收件人地址

返回样例

{
  "code": 200,// 返回码,详见返回码说明
  "msg": "成功",// 返回码对应描述
  "taskNo": "043439882226367117195632",// 本次请求号
  "charge": true, // 计费标志
  "data": {
    "logisticCode": "79105030690097",//运单号
    "shipperCode": "ZTO", //快递公司编码
    "pickUpCode": "xxx",//取件码
    "pickUpAddress": "xxx",//代收点地址
    "pickUpStation": "xxx" //代收点名称
  }
}

推送说明

  • 当货物放入驿站/快递柜后,会将取件码信息推送至callBackUrl接口

数据结构

{
  "pickUpCode": "13-3-5236",
  "code": "200",
  "pickUpAddress": "xxx街道xx中心1幢",
  "logisticCode": "9816475xxxxxx",
  "shipperCode": "YZPY"
}

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。