Amazon SP-API v2024-03-20入仓计划placementOptions返回空数据求助

调用流程核心问题确认 #

你的调用流程存在关键逻辑误解，v2024-03-20版本的Inbound API和旧版v0的getShipments设计逻辑完全不同：

• 旧版getShipments直接返回已生成的shipment实体数据
• 新版中，inboundPlans是入仓计划的容器，仅当入仓计划处于CONFIRMED（已确认仓位分配）状态时，placementOptions接口才会返回有效数据

必须补充的关键操作步骤 #

• 筛选有效入仓计划：调用GET /inbound/fba/2024-03-20/inboundPlans/时，需过滤出status字段为CONFIRMED的入仓计划。草稿（DRAFT）、待提交（SUBMITTED）状态的计划不会返回placementOptions数据。
• 调用正确的shipment数据接口：若要获取对应入仓计划的shipment详情，需调用GET /inbound/fba/2024-03-20/inboundPlans/{Inbound Plan ID}/shipments，这个接口才是旧版getShipments的替代接口，返回具体的入仓 shipment 数据。
• 验证权限完整性：确认你的SP-API授权令牌包含inbound:fba_fulfillment:read权限，权限缺失会导致接口返回空响应。

接口功能澄清 #

• placementOptions接口并非用于获取历史/当前shipment数据，它的作用是提供入仓计划的仓位配置选项（如分仓规则、推荐仓库等），仅在创建或修改入仓计划的流程中会返回有效内容。
• 历史入仓shipment数据的正确获取路径是：inboundPlans列表 → 筛选CONFIRMED计划 → 调用/shipments接口。

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