订阅电商品牌如何使用跟踪 API 跟踪定期发货
要使用跟踪 API 跟踪周期性发货,请为每个实体包裹创建一条发货记录,将其关联到该订阅周期的履行订单,并在仓库或履行合作伙伴提供跟踪号码后进行登记。使用 API 的跟踪更新向客户显示包裹所在位置,并为团队标记配送异常。请将订阅 ID 作为各周期之间的关联,不要将其作为包裹的标识符。

跟踪包裹,而不是订阅
订阅说明客户计划在一段时间内收到什么。履行订单说明某个周期需要发出什么。跟踪号码说明某个特定包裹的信息。将这些记录分开,可以避免某个周期的延迟发货出现在下一个周期的跟踪页面上。
例如,假设五月订阅盒拆分成两个包裹,而六月订阅盒已经发货时,五月的一个包裹仍在运输途中。客户应在五月订单下看到两个包裹,并在六月订单下看到一个单独的包裹。五月包裹的延迟更新只能改变五月包裹的状态。如果发送替换包裹,请创建一条新的发货记录并将其关联到原记录,以便支持团队了解两条记录为何同时存在。
- 订阅:存储订阅 ID,以便支持团队查找客户的发货历史。
- 周期和订单:记录周期标识符或计划履行日期、订单 ID,以及将包裹匹配到正确订单所需的任何履行 ID。不要根据跟踪事件到达的日期推断周期。
- 发货:为每个包裹分配一个内部发货 ID。存储其承运商和跟踪号码、相关履行引用,以及服务商返回的任何跟踪登记 ID。不要在客户当前视图中显示已取消的面单和已被替代的跟踪号码,但要保留历史记录供支持团队查看。
在订单页面上,除订单摘要外,还要显示包裹级别的进度。如果一个包裹已送达而另一个仍在运输中,请明确说明。只有当完成订单所需的所有包裹都已到达时,才能将整个订单显示为已送达,同时要考虑已取消的发货和替换包裹。
将履行流程连接到跟踪 API
- 从履行事件开始登记。当履行系统、仓库或第三方物流合作伙伴发送承运商和跟踪号码时,触发登记。续费付款发生得太早:订单可能仍在等待发货,并且可能还不存在跟踪号码。
- 调用 API 前保存发货记录。持久化内部发货记录并将登记请求加入队列。如果同一条履行消息到达两次,请复用该记录,而不是创建另一个包裹。如果 API 调用超时,而服务商提供了检查原始请求是否成功的方式,请在重试前先进行检查。
- 将更新匹配到已登记的包裹。如果更新中返回了服务商的登记标识符,请使用该标识符。否则,按照其文档指定的标识符进行匹配,并根据发货记录验证结果。如果某条更新可能属于多个记录,请将其提交审核,而不是将其应用到最新订单。
- 将面单创建与承运商运输分开。在承运商记录已接收包裹之前,跟踪号码可能已经存在。当你只有面单信息时,请使用“正在准备交给承运商”等消息。只有承运商信息能够支持时,才使用“运输中”。
17TRACK Tracking API 是此类设置的一种选择。其开发者文档是登记跟踪号码和接收跟踪更新的参考依据。使用这些更新维护系统中的包裹记录;将周期分配、订单完成和客户通知规则保留在你的电商应用中。上线前,请使用来自实际承运商路线和履行合作伙伴的包裹进行测试,而不要仅依赖承运商列表。
确保更新可以安全地处理两次
如果服务商提供 Webhook,请使用它们接收更新,而不是持续轮询每个包裹。Webhook 是服务商发送到应用的 HTTP 请求。遵循服务商的验证要求,持久化存储已接受的有效载荷,并按照其文档规定的响应规则确认请求。将更新订单视图或发送电子邮件等较慢的工作放在请求处理程序之外执行。
构建处理流程,使重复更新不会产生额外影响。如果服务商提供稳定的事件 ID,请使用它们识别重复事件。如果服务商发送的是跟踪快照而非单独事件,请在采取操作前,将传入状态和扫描历史与现有数据进行比较。单独对客户消息进行去重:已发送过的送达通知不应仅仅因为同一发货数据被处理了两次而再次发送。
将扫描发生的时间与应用接收扫描的时间分开记录。延迟到达的运输中扫描可以保留在包裹历史中,而不应替换较新的已送达状态。不过,不要假设每个有效变化都会让包裹状态向前推进。承运商更正或退回寄件人的更新可能需要改变显示内容。如果新数据与存储状态冲突,且无法确定哪个是正确的,请将发货记录放入审核队列。
定期检查可能需要处理的未完成发货:仍待登记的记录、在预期交接后没有首次扫描的包裹,以及跟踪信息已经停止更新的发货。若 API 支持查询或刷新,请在服务商限制范围内有选择地使用。升级处理前,先检查各承运商和仓库之间的模式。如果许多无关发货同时停止更新,请先调查集成问题,再逐个开启配送案例。
将跟踪数据转化为有用的客户消息
客户很少需要每次扫描都收到电子邮件。首先发送与客户需要了解或采取行动的事项相关的消息:包裹已进入承运商网络、配送尝试需要采取行动,或承运商报告包裹已送达。显示订单参考信息以及相关的包裹或周期,以便订阅用户了解消息对应的是哪次发货。对于拆分订单,请标识包裹,并明确订单的其余部分是否仍在运输途中。
- 已创建面单但没有扫描:将预期交接时间与仓库记录进行核对。如果交接时间窗口已过,请让履行团队确认包裹是否已离开设施,然后再告知客户包裹在运输中延迟。
- 跟踪信息停止更新:使用能够反映路线和服务类型的阈值,而不是为所有包裹使用同一个计时器。对于跨境发货,请在决定是否联系客户或升级处理前,检查承运商的最后一条事件记录。
- 配送尝试失败或需要取件:如果承运商提供了明确指示,请告知客户需要采取什么行动。如果事件信息含糊,请将案例转交支持团队,而不是猜测重新配送日期或取件地点。
- 显示已送达但客户未收到:保留承运商报告的状态,并单独创建支持案例。支持流程应区分客户报告与承运商更正。
为支持人员提供周期、订单、包裹历史和已发送消息的统一视图。为每个异常分配负责人和下一步行动。履行团队可以调查交接缺失,物流团队可以跟进承运商异常,支持团队可以处理客户沟通。跟踪状态描述的是包裹情况;它不会决定是否应当补发或退款。
上线前测试周期重叠情况
从一个履行合作伙伴和一组能够反映其实际订单发货方式的包裹开始。包括一个包含多个包裹的周期、一个作废的面单、一个替换包裹,以及一个在下一周期发货时仍处于未完成状态的旧发货。然后有意重放一个重复的 Webhook,并在较新的事件之后发送一个较旧的事件。检查包裹记录、客户订单页面、支持视图和通知日志。只验证 API 成功响应的测试,可能会遗漏代价最高的错误:更新了错误的订单或向错误的客户发送了消息。
监控登记失败、符合条件且成功登记的包裹比例、晚于预期的首次扫描,以及未匹配的更新。如果跟踪更新延迟,请区分承运商事件发生到系统接收之间的时间,以及你自己的系统处理该事件所需的时间。这有助于判断应调查承运商数据源、Webhook 端点,还是应用内部的队列。
当你能够针对任意包裹回答三个问题后,再扩展到更多路线:它属于哪个周期?承运商最后报告了什么?如果更新缺失或错误,由谁采取行动?如果任何答案都不明确,请在添加更多通知规则前修复记录映射或异常处理流程。
常见问题
跟踪 API 能告诉客户他们的下一个订阅盒何时发货吗?
请使用订阅计划和履行系统确定下一次计划发货日期。跟踪 API 用于特定包裹,且仅在跟踪信息存在后使用。计划发货日期、承运商配送预计时间和已确认的送达是不同的事实,应分别标注。
如果仓库在电子邮件发出后替换了跟踪号码怎么办?
将旧面单标记为已替代,并将新的跟踪号码关联到同一订单。如果你的电子邮件指向订单级别的跟踪页面,请更新该页面,以便客户无需原始承运商链接即可找到当前包裹。当变更影响客户需要据此采取行动的信息时,请发送更正通知。
如果履行合作伙伴发送跟踪号码时没有提供承运商代码怎么办?
请要求合作伙伴提供统一的承运商字段,或提供其运输服务代码的映射。如果你的 API 提供承运商识别功能,请先验证其对该合作伙伴面单的识别效果,再依赖该功能。对于不明确的匹配,应提交审核,而不是仅根据跟踪号码选择承运商。
暂停或跳过的订阅需要跟踪记录吗?
对于从未发货的周期,不需要创建包裹记录。如果之前的发货仍处于未完成状态,即使订阅已暂停、跳过或取消,也要继续跟踪。订阅状态控制未来的履行;它不能说明已经离开仓库的包裹发生了什么。
来源
- 17TRACK Tracking API — 将包裹跟踪集成到业务系统的产品概览。
- 17TRACK Tracking API documentation — 登记跟踪号码和接收跟踪数据的实施参考。
- Stripe webhook documentation — 关于处理重复事件和避免对交付顺序作出假设等通用 Webhook 实践的参考。请遵循跟踪服务商自身的验证和确认规则。


