关于Amazon Fulfillment Inbound API v2024-03-20获取发货单的问询

能否在v2024-03-20版本中获取发货单？ #

可以，但逻辑和v0版本差异很大：

• v0的GET /fba/inbound/v0/shipments是直接返回所有发货单；而v2024-03-20采用「入库计划（InboundPlan）-发货单」的层级结构，只有当发货单主动关联到入库计划后，调用GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}才会返回shipments数据。
• 你用v0创建的历史发货单不会自动关联到v2024-03-20的入库计划，这就是你返回shipments: []的根本原因。

解决shipments为空的方案 #

• 历史发货单：v2024-03-20没有直接迁移历史数据的接口，你可以继续使用v0接口获取（直到官方完全停用），或者调用v2024-03-20的searchShipments接口，通过指定筛选条件（如日期范围、ASIN、发货单状态等）查询历史发货单。
• 新发货单：必须先通过v2024-03-20创建入库计划，再在该计划下创建发货单，之后查询入库计划详情时才能看到关联的shipments列表。

关于文档矛盾的说明 #

亚马逊SP-API文档存在更新滞后的问题：

• 部分章节标记「已弃用」但文字说明「未弃用」，属于文档维护疏漏。目前v0的getShipments确实已被官方标记为弃用，但仍可调用，直到官方完全下线该接口。
• v2024-03-20中替代v0getShipments的核心接口是searchShipments，而非依赖入库计划的查询接口，这一点文档描述不够清晰，容易造成误解。

内容的提问来源于stack exchange，提问作者m.nicolau