Qeasy Cloud
Get Started

领星ERP STA货件流程说明 API

Platform
领星ERP
Type
DOC
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
一、整体说明 1、主要功能 STA货件相关API支持您创建和更新向亚马逊物流网络运送的货件,主要功能有: · 创建STA任务:创建STA任务并生成货件分仓预览方案,确认方案并生成货件后,提交货件承运人和承运方式等配送信息,并上传跟踪编号以确定发货。 · 查询STA任务和货件详情:查询STA任务或货件的基础信息和装箱信息。 · 取消STA任务和货件:取消现有的STA任务及其货件。 · 修改货件装箱信息:支持修改货件的装箱信息,调整箱子数量、重量、尺寸或者商品信息。 · 同步STA任务到领星:支持指定STA任务编号,手动触发STA任务同步更新到领星,包括STA任务及其货件详情,解决自动同步数据可能存在延迟情况。 2、STA任务两种流程模式 创建STA任务有两种流程模式,分别是先装箱再分仓、先分仓再装箱(仅限汽运零担LTL方式)。 3、先装箱再分仓流程 | 步骤 | 接口(按顺序) | 调用说明 | |---|---|---| | 步骤①创建STA任务 | 创建STA任务 | 创建STA任务时需要填写店铺、商品信息、发货地址、分仓...
Updated At
2026-11-21

STA货件流程说明

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

Request Parameters

No parameter reference available

Response Parameters

No parameter reference available

The STA货件流程说明 API (/new/api-docs/Case/staProcessNew/) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.