STA货件流程说明
一、整体说明
1、主要功能
STA货件相关API支持您创建和更新向亚马逊物流网络运送的货件，主要功能有：
- 创建STA任务：创建STA任务并生成货件分仓预览方案，确认方案并生成货件后，提交货件承运人和承运方式等配送信息，并上传跟踪编号以确定发货。
- 查询STA任务和货件详情：查询STA任务或货件的基础信息和装箱信息。
- 取消STA任务和货件：取消现有的STA任务及其货件。
- 修改货件装箱信息：支持修改货件的装箱信息，调整箱子数量、重量、尺寸或者商品信息。
- 同步STA任务到领星：支持指定STA任务编号，手动触发STA任务同步更新到领星，包括STA任务及其货件详情，解决自动同步数据可能存在延迟情况。
2、STA任务两种流程模式
创建STA任务有两种流程模式，分别是先装箱再分仓、先分仓再装箱（仅限汽运零担LTL方式）。 
3、先装箱再分仓流程
| 步骤 | 接口（按顺序） | 调用说明 |
|---|---|---|
| 步骤①创建STA任务 | 创建STA任务 | 创建STA任务时需要填写店铺、商品信息、发货地址、分仓方式；返回异步任务ID和STA任务编号；由于亚马逊创建STA任务属于异步操作，所以返回STA任务编号不意味着已成功创建STA任务，需要使用异步任务ID去调用查询异步任务状态接口，查询实际创建结果 |
| 查询异步任务状态 | 调用创建STA任务接口后，需调用该接口查看实际结果 | |
| 获取商品预处理信息（可选） | 支持获取最新的商品预处理信息，可按最新商品预处理信息创建STA任务 | |
| 步骤②商品装箱 | 查询包装组 | 当创建STA任务传入先装箱再分仓模式时，可通过STA任务编号调用该接口查询包装组信息；返回包装组ID和每个包装组的商品信息，您可以通过该API获取每个包装组的商品信息，自行打印拣货单 |
| 提交装箱信息 | 需按照不同包装组ID维度提交装箱信息，注意需要提交所有包装组的装箱信息 | |
| 查询异步任务状态 | 调用提交装箱信息接口后，需调用该接口查看实际结果 | |
| 步骤③配送服务 | 生成货件方案 | 通过STA任务编号生成货件分仓方案 |
| 查询异步任务状态 | 调用生成货件方案接口后，需调用该接口查看实际结果 | |
| 查询货件方案 | 返回多个货件分仓预览方案，每个方案包含费用、货件信息，货件信息包含货件ID、物流中心、商品信息等 | |
| 查询货件方案的装箱信息 | 返回货件分仓预览方案的装箱信息，包含每个方案下每个货件的箱子体积、重量 | |
| 生成承运方式 | 亚马逊对待申报确认的货件增加了承运方式、送达时段的可用范围限制。请在确认货件方案前核实确认相关限制。所以在确认货件方案之前，需要查询对应的承运方式。例如：A货件方案下货件，仅支持SPD，不支持LTL；B货件方案下的货件，仅支持LTL，不支持SPD；您需要根据SPD或LTL类型，确认对应的货件方案。目前承运方式可支持以下其中一种或多种：其他承运人(SPD)、其他承运人(LTL)、SEND承运人(SPD)、SEND承运人(LTL)注意：需要生成货件方案内所有货件的的承运方式；在确认货件方案之前，可重新生成货件方案，之前已生成的货件方案会被废弃； | |
| 查询异步任务状态 | 调用生成承运方式接口后，需调用该接口查看实际结果 | |
| 查询承运方式 | 查看每个货件可支持的具体承运方式，包含SPD/LTL类型、其他承运人/SEND合作承运人类型，以及具体的承运人 | |
| 生成可选送达时间 | 亚马逊对待申报确认的货件增加了承运方式、送达时段的可用范围限制。请在确认货件方案前核实确认相关限制。所以在确认货件方案之前，需要查询对应的可用送达时段。 | |
| 查询异步任务状态 | 调用生成可选送达时间接口后，需调用该接口查看实际结果 | |
| 查询可选送达时间 | 查看每个货件可用的送达时间，不可用时间当前未返回。注意美国站货件已改为7天日历周（周日到周六），不支持灵活送达时间。 | |
| 确认货件方案 | 在确认货件方案之前，需要查询对应的承运方式、送达时间的相关可用范围限制。确认其中一个货件方案之后，其余货件方案立即失效。 | |
| 查询异步任务状态 | 调用确认货件方案接口后，需调用该接口查看实际结果 | |
| 提交货件配送服务 | 支持提交货件承运方式、送达时间、托盘等信息。注意需提交所有货件的信息。 | |
| 查询异步任务状态 | 调用提交货件配送服务接口后，需调用该接口查看实际结果 | |
| 步骤④打印标签 | 查询FBA货件箱子、卡板标签 | 确认货件方案成功后，支持打印箱唛和卡板标签 |
| 修改货件装箱信息（可选） | 提交配送服务之后，支持修改货件的装箱数据。可在步骤④或步骤⑤时修改。每个商品可修改的数量不超过申报量的5%或6个，以较大者为准。当商品数量不超过6个时，允许移除该商品。仅当货件为WORKING状态时，才支持新增箱子。 | |
| 生成可选送达时间（可选）查询异步任务状态（可选）查询可选送达时间（可选）提交送达时间（可选） | 提交配送服务之后，支持修改送达时间；如需修改，可以依次调用接口。可在步骤④或步骤⑤时修改。 | |
| 步骤⑤货件追踪 | 查询货件装箱信息 | 确认货件方案成功后，亚马逊会为每个箱子生成唯一箱号，例如FBABBBBU000001，需要获取箱号，用于SPD货件时按箱子上传跟踪号。 |
| 上传货件跟踪号 | 对于SPD货件，支持按箱子上传、修改跟踪号；对于LTL货件，支持上传提货单号； |
4、先分仓再装箱流程
| 步骤 | 接口（按顺序） | 调用说明 |
|---|---|---|
| 步骤①创建STA任务 | 创建STA任务 | 创建STA任务时需要填写店铺、商品信息、发货地址、分仓方式；返回异步任务ID和STA任务编号；由于亚马逊创建STA任务属于异步操作，所以返回STA任务编号不意味着已成功创建STA任务，需要使用异步任务ID去调用查询异步任务状态接口，查询实际创建结果 |
| 查询异步任务状态 | 调用创建STA任务接口后，需调用该接口查看实际结果 | |
| 获取商品预处理信息（可选） | 支持获取最新的商品预处理信息，可按最新商品预处理信息创建STA任务 | |
| 步骤②商品装箱 | 生成货件方案 | 通过STA任务编号生成货件分仓方案；先分仓模式下，无需查询包装组信息以及提前按包装组维度提交装箱数据，只需按货件维度提交装箱数据； |
| 查询异步任务状态 | 调用生成货件方案接口后，需调用该接口查看实际结果 | |
| 查询货件方案 | 返回多个货件分仓预览方案，每个方案包含费用、货件信息，货件信息包含货件ID、物流中心、商品信息等 | |
| 查询货件方案的装箱信息 | 返回货件分仓预览方案的装箱信息，包含每个方案下每个货件的箱子体积、重量 | |
| 提交装箱信息 | 需按照不同货件维度提交装箱信息，注意需要提交所有货件的装箱信息 | |
| 查询异步任务状态 | 调用提交装箱信息接口后，需调用该接口查看实际结果 | |
| 步骤③配送服务 | 生成承运方式 | 生成每个货件支持的LTL类型的具体承运方式。先分仓模式下，承运方式仅支持LTL类型。提交配送服务之前，支持重新生成。重新生成后，历史承运方式立即作废。 |
| 查询异步任务状态 | 调用生成承运方式接口后，需调用该接口查看实际结果 | |
| 查询承运方式 | 查看每个货件可支持的具体承运方式 | |
| 生成可选送达时间 | 生成每个货件支持的送达时间。提交配送服务之前，支持重新生成。重新生成后，历史送达时间立即作废。 | |
| 查询异步任务状态 | 调用生成可选送达时间接口后，需调用该接口查看实际结果 | |
| 查询可选送达时间 | 查看每个货件可用的送达时间，不可用时间当前未返回。注意美国站货件已改为7天日历周（周日到周六），不支持灵活送达时间。 | |
| 提交货件配送服务 | 支持提交货件承运方式、送达时间、托盘等信息。注意需提交所有货件的信息。 | |
| 查询异步任务状态 | 调用提交货件配送服务接口后，需调用该接口查看实际结果 | |
| 步骤④打印标签 | 查询FBA货件箱子、卡板标签 | 确认货件方案成功后，支持打印箱唛和卡板标签 |
| 修改货件装箱信息（可选） | 提交配送服务之后，支持修改货件的装箱数据。可在步骤④或步骤⑤时修改。每个商品可修改的数量不超过申报量的5%或6个，以较大者为准。当商品数量不超过6个时，允许移除该商品。仅当货件为WORKING状态时，才支持新增箱子。 | |
| 生成可选送达时间（可选）查询异步任务状态（可选）查询可选送达时间（可选）提交送达时间（可选） | 提交配送服务之后，支持修改送达时间；如需修改，可以依次调用接口。可在步骤④或步骤⑤时修改。 | |
| 步骤⑤货件追踪 | 查询货件装箱信息 | 确认货件方案成功后，亚马逊会为每个箱子生成唯一箱号，例如FBABBBBU000001，需要获取箱号，用于SPD货件时按箱子上传跟踪号。 |
| 上传货件跟踪号 | 对于SPD货件，支持按箱子上传、修改跟踪号；对于LTL货件，支持上传提货单号； |
二、特殊说明
1、亚马逊API暂不支持以下内容
由于亚马逊目前暂不支持以下内容，故领星提供的STA相关API也暂不支持：
- 暂不支持以下市场：巴西、土耳其
- 如有需要，请在亚马逊后台创建货件
- 暂不支持设置原厂包装模版
- 暂不支持获取您在亚马逊后台设置的原厂包装模版，API接口默认为混装包装模式
- 查询送达时段接口返回的日期范围有限，亚马逊后台时间范围暂无限制
- 发货地址在美国境内：送达时间支持选择75 天范围的日期
- 发货地址在美国境外：送达时间支持选择105 天范围的日期
2、重要流程调整更新说明
自2025年10月17日起，亚马逊对「先装箱后分仓」模式的货件分仓方案增加了承运人、送达时段的可用范围限制。请在申报前核实确认相关限制，建议您同时完成申报货件并提交配送服务再安排发货。
此时，不推荐以下API调用流程，强烈建议您按照上方API流程说明进行调整：
| 步骤 | 不建议接口调用顺序 | 调用说明 |
|---|---|---|
| 步骤①创建STA任务 | 创建STA任务 | |
| 查询异步任务状态 | ||
| 获取商品预处理信息（可选） | ||
| 步骤②商品装箱 | 查询包装组 | |
| 提交装箱信息 | ||
| 查询异步任务状态 | ||
| 步骤③配送服务 | 生成货件方案 | |
| 查询异步任务状态 | ||
| 查询货件方案 | ||
| 查询货件方案的装箱信息 | ||
| 确认货件方案 | 不建议在查询承运方式、查询送达时间之前，确认货件方案 | |
| 查询异步任务状态 | ||
| 生成承运方式 | 亚马逊对待申报确认的货件增加了承运方式、送达时段的可用范围限制。请在确认货件方案前核实确认相关限制。所以在确认货件方案之前，需要查询对应的承运方式。例如：A货件方案下货件，仅支持SPD，不支持LTL；B货件方案下的货件，仅支持LTL，不支持SPD；您需要根据SPD或LTL类型，确认对应的货件方案。目前承运方式可支持以下其中一种或多种：其他承运人(SPD)、其他承运人(LTL)、SEND承运人(SPD)、SEND承运人(LTL) | |
| 查询异步任务状态 | ||
| 查询承运方式 | ||
| 生成可选送达时间 | 亚马逊对待申报确认的货件增加了承运方式、送达时段的可用范围限制。请在确认货件方案前核实确认相关限制。所以在确认货件方案之前，需要查询对应的可用送达时段。 | |
| 查询异步任务状态 | ||
| 查询可选送达时间 | ||
| 提交货件配送服务 | ||
| 查询异步任务状态 | ||
| 步骤④打印标签 | 查询FBA货件箱子、卡板标签 | |
| 修改货件装箱信息（可选） | ||
| 生成可选送达时间（可选）查询异步任务状态（可选）查询可选送达时间（可选）提交送达时间（可选） | ||
| 步骤⑤货件追踪 | 查询货件装箱信息 | |
| 上传货件跟踪号 |
建议您参考领星系统创建货件流程：
