为什么三套系统会各说各话
一个包裹在到达客户手里之前,至少要经过四套系统:接单的电商平台、拣货的仓库系统、打印面单的发货集成,以及真正搬运它的承运商。每套系统都维护着自己的状态字段,由自己的操作者、按自己的节奏更新。
Shipping API 技术总览说明状态变化进入发货流程的位置,再按发货数据模型指南将状态对应到正确的订单、运单、包裹或面单标识。
状态是局部视图,不是共享真相。仓库内部发生了什么,电商平台要等事件同步回来才知道;承运商有没有接收包裹,仓库要等扫描数据进来才知道;客户被承诺了什么,承运商一概不知。每套系统都从自己的角落渲染世界,而这些角落并不在同一时刻更新。
这些不一致不是 bug,而是通过异步事件通信的分布式系统的可预期结果。一旦接受这一点,问题就不再是「它们为什么对不上」,而是「每个决策我该信哪一层」。这正是这篇文章要回答的问题。




