我们正在部署我们的订单API的更新在2026年5月12日,以解决关于多物品发货的配送跟踪信息显示的问题。
这次更新主要关注的是处理包含在完全相同的包裹中发货的多个物品的商家。 如果您的自定义集成依赖于解析每个单独物品的单独跟踪块,请查看下面的更改以确保您的系统继续顺利运行。
正在改变什么
我们正在部署一个错误修复,以解决配送跟踪信息在API响应中偶尔被分割或重复的问题。
当前问题(更新前):
目前,包裹中的物品有时会被分割成多个,单独的跟踪块,即使它们共享完全相同的"tracking_number"和"carrier"属性。
如下面的例子所示,API为同一个DPD跟踪号(123457)创建了多个块:
解决方案(更新后):
有了这个更新,这些重复的条目将被正确地合并。从现在开始,所有共享相同跟踪属性的"marketplace_order_line_ids"将被分组到一个单一,干净的跟踪对象中。
如下面的例子所示,所有在DPD跟踪号123457下的物品将被正确地分组在一起:
如果订单中的物品在单独的包裹中发货,并有不同的跟踪号(例如,DPD 123457和DPD 123478),它们将正确地保持在单独的跟踪块中,如下面的例子所示:
你需要做什么
需要采取的行动
如果您的系统处理多物品发货:
- 查看您的集成: 请检查您的系统如何解析跟踪数组并处理 "marketplace_order_line_ids"。
- 如果需要,进行适应: 确保您的系统正确处理单个跟踪块内多个订单行的分组跟踪数据,而不是依赖于分割或重复跟踪对象的存在。