跳到正文
14 天免费试用,无需银行卡9 种语言176 种业务类型 · 50 个应用
ZH· USD
试用在线演示免费试用

快递状态 webhook:运作方式

快递公司可以在包裹每次状态变化的那一刻就推送到您的工作区,而不必等待每半小时一次的同步。每次推送都会用密钥校验,只应用一次,而且永远不会让包裹状态倒退。

第 8 课,共 12 课 · 运作方式

  • 约 3 分钟
  • Deliveries & packing → Couriers → Status webhook

运作方式

  1. 在 Deliveries → Couriers 中,打开某个 API 快递公司下的 Status webhook,选择 Create webhook secret。把 webhook 地址(以及密钥)复制到快递公司的商户后台。

  2. 每次推送都必须证明来自该快递公司:根据快递公司的不同,可以是用密钥生成的签名、请求头中的密钥,或者一个保密地址。其他任何推送都会被拒绝。

  3. 系统按运单号或寄件单号找到包裹;随后送货单会推进到派送中、已送达或已退回,并记录已代收的款项。

  4. 同一条推送发送两次只会应用一次。迟到的旧报告或倒退的状态只会记入包裹的时间线。

  5. Rotate secret 会立即生成新密钥;请马上把它填到快递公司那边,旧密钥随即失效。

在哪里找到

影响它的设置

检查清单

继续之前,请确认您能够:

  • 打开 Deliveries & packing → Couriers → Status webhook
  • 在 Deliveries → Couriers 中,打开某个 API 快递公司下的 Status webhook,选择 Create webhook secret。把 webhook…
  • 每次推送都必须证明来自该快递公司:根据快递公司的不同,可以是用密钥生成的签名、请求头中的密钥,或者一个保密地址。其他任何推送都会被拒绝。
  • 系统按运单号或寄件单号找到包裹;随后送货单会推进到派送中、已送达或已退回,并记录已代收的款项。
  • 同一条推送发送两次只会应用一次。迟到的旧报告或倒退的状态只会记入包裹的时间线。

提示和常见错误

  • 该区域会显示最后一次推送到达的时间以及处理结果,例如没有找到该单号的包裹。
  • 每半小时一次的同步会继续运行,所以漏掉的推送之后也会补上。
  • 请保管好密钥:使用保密地址校验时,地址本身就是密钥。