快递状态 webhook:运作方式
快递公司可以在包裹每次状态变化的那一刻就推送到您的工作区,而不必等待每半小时一次的同步。每次推送都会用密钥校验,只应用一次,而且永远不会让包裹状态倒退。
第 8 课,共 12 课 · 运作方式
运作方式
在 Deliveries → Couriers 中,打开某个 API 快递公司下的 Status webhook,选择 Create webhook secret。把 webhook 地址(以及密钥)复制到快递公司的商户后台。
每次推送都必须证明来自该快递公司:根据快递公司的不同,可以是用密钥生成的签名、请求头中的密钥,或者一个保密地址。其他任何推送都会被拒绝。
系统按运单号或寄件单号找到包裹;随后送货单会推进到派送中、已送达或已退回,并记录已代收的款项。
同一条推送发送两次只会应用一次。迟到的旧报告或倒退的状态只会记入包裹的时间线。
Rotate secret 会立即生成新密钥;请马上把它填到快递公司那边,旧密钥随即失效。
在哪里找到
- Deliveries & packing → Couriers → Status webhook
/admin/deliveries/couriers
影响它的设置
- Courier account → Webhook check and signature header
/admin/deliveries/couriers
检查清单
继续之前,请确认您能够:
- 打开 Deliveries & packing → Couriers → Status webhook
- 在 Deliveries → Couriers 中,打开某个 API 快递公司下的 Status webhook,选择 Create webhook secret。把 webhook…
- 每次推送都必须证明来自该快递公司:根据快递公司的不同,可以是用密钥生成的签名、请求头中的密钥,或者一个保密地址。其他任何推送都会被拒绝。
- 系统按运单号或寄件单号找到包裹;随后送货单会推进到派送中、已送达或已退回,并记录已代收的款项。
- 同一条推送发送两次只会应用一次。迟到的旧报告或倒退的状态只会记入包裹的时间线。
提示和常见错误
- 该区域会显示最后一次推送到达的时间以及处理结果,例如没有找到该单号的包裹。
- 每半小时一次的同步会继续运行,所以漏掉的推送之后也会补上。
- 请保管好密钥:使用保密地址校验时,地址本身就是密钥。