亚马逊SP API提交非合作承运人追踪信息触发BadRequest错误求助

错误核心信息 #

你触发的400 BadRequest错误明确提示：

ERROR: Shipment shd793cfaf-d21d-40ec-b0f5-d9ddbeb40edb is not in a state where tracking details can be provided.

请求详情：

PUT request to https://sellingpartnerapi-eu.amazon.com/inbound/fba/2024-03-20/inboundPlans/wfc485fc53-4d3e-4ddd-b868-e6f7f70ebe9d/shipments/shd793cfaf-d21d-40ec-b0f5-d9ddbeb40edb/trackingDetails failed. Status code: 400.

可能原因及对应解决步骤 #

1. WORKING状态存在细分阶段限制 #

亚马逊FBA入站货件的WORKING状态包含多个子阶段，并非所有阶段都支持添加追踪信息：

• 若货件仅完成创建，未完成装箱确认（Box Contents Confirmation），即使显示WORKING，也无法录入追踪号。
• 部分区域要求货件先完成「标记为已发货」操作，才允许补充追踪详情。

解决方法：

• 调用getShipment接口获取货件完整状态，查看shipmentStatus的细分字段（如是否包含READY_TO_SHIP标识）。
• 到卖家后台对应货件页面，确认已完成装箱确认和发货标记，再重试API操作。

2. 非合作承运人前置信息未补全 #

对于非合作承运人，亚马逊要求先完成承运人信息录入，再添加追踪号：

• 若跳过了指定carrierCode和carrierName的步骤，API会判定货件未就绪。

解决方法：

• 先调用updateShipment接口，为货件填充正确的非合作承运人编码（如OTHER或对应第三方承运人代码）及名称。
• 确认承运人信息更新成功后，再调用putTrackingDetails接口提交追踪号。

3. API区域/版本的隐性规则变更 #

即使之前运行正常，亚马逊可能临时调整了EU区域2024-03-20版本API的状态校验逻辑：

• 排查同区域其他卖家是否遇到相同问题，确认是否为亚马逊端临时故障或规则更新。

解决方法：

• 尝试切换至更早的稳定版本API（如2021-01-01版入站接口）测试，看是否能成功录入。
• 提交卖家支持工单，提供x-amzn-RequestId（57b61921-5f37-4eb5-abb3-ae10b220427e）和货件ID，请求确认状态限制的具体原因。

4. 货件后台数据同步异常 #

即使状态显示为WORKING，可能存在系统未同步的隐性异常：

• 比如入库计划未完成后台校验，或操作状态未实时同步至API端。

解决方法：

• 等待30-60分钟后重试，给系统留足数据同步时间。
• 在卖家后台手动为该货件添加追踪号，若能成功，对比手动操作的参数与API请求参数的差异，排查是否存在参数遗漏或格式错误。

内容的提问来源于stack exchange，提问作者joel