航空货运 vs. 跨境包裹追踪:您需要哪些 API 功能?
当您的应用必须跟踪航空运单、航段、货物处理里程碑和货运数量时,应选择空运货物跟踪 API。当您需要跨承运商获取包裹级更新、派送异常和末端配送状态时,应选择跨境包裹跟踪 API。如果您的货物同时包含集中空运和单个包裹配送,则需要这两个可视化层级,以及一种可靠的方式来关联它们的标识符。
对于工程团队、物流运营商和电子商务企业而言,采购决策的重点并不在于哪个 API 返回更多事件,而在于这些事件是否描述了您实际管理的货运单元。航空公司到达事件本身无法告诉购物者包裹在哪里,或何时能够送达其家门口。
从货运单元开始,而不是运输方式
空运货物和跨境包裹并不是互斥的运输类别。包裹可能通过飞机进行国际运输,而航空公司则将其作为更大规模集中货运的一部分进行处理。选择 API 时,区别在于所跟踪的运营对象。
空运货物可视化通常围绕航空运单及相关运输移动展开。根据数据来源的不同,数据可能描述收货、离港、到达、货物可提取和交接等状态。包裹可视化则围绕单个包裹及其经过揽收、国际运输、目的地处理和配送的进度展开。
主航空运单可以代表一次集中运输,其中包含多个底层货运。分运单、包裹标签和目的地承运商跟踪号码可能对应这次运输中的不同层级。不要假设跟踪服务商能够自动发现或关联所有这些关系。
| 决策领域 | 空运货物跟踪 | 跨境包裹跟踪 |
|---|---|---|
| 主要对象 | 航空运单、托运货物或运输航段 | 单个包裹及其承运商标识符 |
| 运营问题 | 货物是否已收运、装机、到达或交接? | 包裹在哪里、是什么阻碍了它,以及是否已送达? |
| 需要保留的关系 | 主单和分单参考号、航段、件数及拆分运输 | 订单与包裹的关联、承运商交接、替换标识符及退货 |
| 典型操作负责人 | 货代、运输或货运运营团队 | 电子商务运营、客户服务或配送管理团队 |
| 主要解读风险 | 将一个航段或部分到达视为整票货物完成 | 将交接或含义不明确的配送事件视为买家已收货 |
空运货物跟踪 API 需要支持什么
航空运单身份和货运关系
了解 API 接受哪些标识符,以及每次查询返回什么内容。支持主航空运单并不自动意味着支持分单级可视化。如果您的运营依赖分单货物,应要求服务商使用您自己的参考号和经过授权的数据源进行演示。
数据模型应保留货运、其运输航段以及任何单独移动部分之间的关系。对于对数量敏感的工作流,应确认件数和重量是在货运层级、事件层级,还是两个层级都可获取。货运总量不能替代了解有多少货物抵达了某一机场。
运输航段和处理可视化
要求提供足够的上下文,以区分始发地离港和中转离港,以及计划运输和实际运输。有用字段可能包括始发和目的地机场、航班参考号、事件地点,以及计划时间戳和实际时间戳。这些字段是否可用取决于数据来源,应加以验证而不是假设。
还要区分航班移动和货物移动。飞机抵达本身并不能证明每票相关货物都已装载、卸载、处理或可提取。应确认某个事件是针对具体货运的,还是由航班数据源推导得出的。
部分运输和里程碑含义
一票货物可能分批移动。系统不应仅因为其中一部分存在到达事件,就将整票货物标记为已到达。测试 API 如何表示多个航班、部分数量、路线调整和更正。
里程碑定义同样需要仔细审查。交接给货代或其他物流方不一定等同于交付给最终收货人。让服务商解释完成事件的运营含义,并在内部状态模型中保留该含义。
IATA 的 ONE Record 计划为货运数据共享和标准化数据结构提供了相关行业参考。不过,声称符合标准并不证明能够访问每家航空公司、处理方、货运或里程碑。应确认实际可用的实施方案、数据关系、权限和运营数据源。
跨境包裹跟踪 API 需要支持什么
承运商识别和交接连续性
国际包裹运输可能涉及始发地运营商、跨境物流服务商和目的地配送承运商。集成应在标识符或负责承运商发生变化时,帮助您保持跟踪连续性。
确认 API 返回的是后续跟踪号码、承运商关系,还是仅返回您提交的标识符对应的事件。如果这些关系不可用,应确定您的货运平台、仓库或物流合作伙伴能否提供这些信息。在未经测试的情况下,不要承诺自动实现端到端关联。
承运商识别还需要备用方案。相似的跟踪号码格式可能造成歧义,因此在支持的情况下,集成应允许明确选择承运商或采用其他有文档说明的消歧方法。
保留原始证据的标准化状态
通用状态模型便于跨承运商自动化通知。但标准化不应抹去原始事件描述、地点、时间戳或来源承运商。
例如,宽泛的异常状态可能表示地址问题、海关相关延误或配送尝试失败。这些情况需要采取不同措施。应保留原始消息,并且仅在数据源支持时使用具体的异常类别。
配送结果和可执行异常
包裹团队通常需要区分派送中、尝试派送、可取件、已送达和与退货相关的事件。应确认 API 暴露了哪些区别,以及这些区别在您使用的承运商之间是否一致。
将送达证明作为单独要求。已送达状态并不保证能够获取签名、照片、收件人姓名或文件。对于相关服务,应确认其可用性、访问权限、保留期限和隐私限制。
海关信息也存在局限。提及海关的跟踪事件不一定会提供申报记录、税费说明或可靠的放行预测。应根据事件实际说明的内容制定升级规则,而不是推断法律或海关结果。
两类 API 都需要的功能
可靠的事件接收和恢复
对于事件驱动的工作流,应评估 Webhook 发送、身份验证、重试、重复处理以及中断后的恢复能力。这些是需要核实的采购要求,而不是可以假定每个服务商都会提供的功能。
设计消费者以处理重复消息和乱序消息。将事件发生时间与系统接收更新的时间分开存储。如果没有稳定的事件标识符,应使用可用字段定义有文档记录的去重方案。
确认在错过通知后是否可以获取货运的事件历史。Webhook 适合触发工作;支持的查询或对账流程才有助于在触发器遗漏时进行恢复。
新鲜度、来源和时间戳处理
区分三个时间点:实际事件发生的时间、数据源发布事件的时间,以及应用接收事件的时间。并非所有数据源都会提供这三个时间点,但将可用时间戳分开保存,有助于诊断延迟。
同样要区分没有新事件和查询失败。货运历史没有变化,可能表示扫描之间存在正常间隔、数据源中断、标识符无法识别或集成问题。运营团队需要足够的诊断信息来选择正确的响应方式。
在数据源提供时保留时区信息。如果来源时间戳缺少时区,应记录这一限制,而不是将其静默转换为看似精确的全球时间。
访问、成本和运营控制
确认身份验证、账户隔离、数据保留、删除流程、速率限制和生产支持安排。跟踪数据载荷可能包含个人信息,因此只收集和暴露工作流所需的信息。
根据实际工作量比较商业条款。确认计费单位是已登记货运、请求、刷新操作还是其他单位。明确无效号码、重复登记、重新跟踪、历史查询和超额用量如何计费。没有这些定义,宣传价格就无法作为可靠的成本比较依据。
何时使用一个 API,何时组合数据源
选择以货运为重点的可视化,当您的团队需要处理航空运单里程碑、机场处理、中转失败或部分货物到达时。除非明确演示所需的货运级详细信息,否则单独的包裹跟踪不足以替代这些工作流。
选择以包裹为重点的可视化,当您的团队需要包裹级配送更新、客户通知、目的地承运商事件和配送异常管理时。仅有航空运单数据流不足以支持面向买家的配送跟踪。
组合使用两者,当您同时管理国际干线运输和单个包裹配送时。为集中货运及其包裹分别保存记录,然后通过您自己的物流流程或经过验证的合作伙伴数据流所提供的参考信息将它们关联起来。
例如,商家可能先通过航空运输一批集中货物,然后在目的地注入包裹网络。将货物到达记录在集中货运上。只有在存在与某个包裹相关的证据时,才更新该包裹;不要将整批货物的机场到达转换为每个订单的已送达事件。
17TRACK 的定位
对于这一架构中的包裹部分,17TRACK 的 Tracking API 可用于评估多承运商跟踪集成。使用官方 API 文档,根据所需标识符、响应字段、通知工作流和运营限制检查集成情况。
不要将包裹 API 评估视为空运货物功能的确认。如果您还需要主单到分单的关系、航段详情或部分货物移动,请针对这些要求要求明确确认并提供示例响应。产品的正确定位取决于它能够证实哪些工作流,而不是“跟踪”一词涵盖的范围。
在做出承诺前进行概念验证
使用来自您实际承运商、路线和服务类型的代表性货运。既要包括结果已知的已完成货运,也要包括正在运输的货运。对一个简单货运的一次成功查询不足以验证集成。
- 明确每个事件必须支持的决策。例如调查货运中转遗漏、就地址问题联系买家,或发送配送通知。
- 建立具有代表性的测试集。在相关情况下,纳入承运商交接、无更新时段、配送尝试、退货和货运拆分移动。
- 检查对象级准确性。确认每个事件适用于航班、托运货物、部分货物还是单个包裹。
- 与运营数据源进行比较。根据您有权访问的承运商或合作伙伴记录,检查缺失的里程碑、时间戳、地点、原始消息和更正处理。
- 测试故障恢复。测试重复事件、延迟事件、无效标识符、含义不明确的承运商、Webhook 中断和对账。
- 验证经济性和责任归属。根据工作量估算成本,并明确由谁负责数据源问题、集成故障和客户沟通。
在审查结果前设定验收标准。这些标准应涵盖每个工作流所需的字段、事件含义、恢复行为和可接受的更新延迟。客户通知和货运干预可能需要不同的阈值。
常见问题
一个跟踪 API 能同时覆盖空运货物和包裹吗?
有可能,但要确认两者的数据模型和数据源访问权限。共享端点并不能证明其支持货物数量、航段、分单关系或包裹交接。应分别要求对这两种工作流进行演示。
我可以使用航空运单号码跟踪单个包裹吗?
不一定。航空运单可能标识的是一票较大的托运货物,而不是单个包裹。您需要确认该托运货物与包裹标识符之间存在经过验证的关系,才能关联它们的历史记录。
“实时跟踪”是否意味着持续的实际位置?
不要这样假设。跟踪可能基于按时间间隔发布的运营事件,而不是连续的位置遥测。应询问更新由什么触发、暴露哪些时间戳,以及位置数据是否来自独立的传感器数据源。
Webhook 比轮询更好吗?
Webhook 适合在无需重复状态请求的情况下接收事件通知。轮询或其他查询机制仍可支持对账和恢复。应根据服务商记录的行为、限制以及您对遗漏或延迟更新的容忍度来选择设计。
已送达事件能证明买家已收到货物吗?
并非在所有情况下都能证明。货运完成可能描述的是向物流方交接,而包裹配送事件取决于承运商的配送流程。应核实事件定义,并在工作流需要时获取单独的配送证据。
来源
- IATA — ONE Record:标准化货运数据共享的行业参考;不保证特定 API 的覆盖范围。
- 17TRACK — Tracking API:用于评估包裹跟踪集成的官方产品参考。
- 17TRACK — API 文档:用于验证实施要求的技术参考。


