Qeasy Cloud
Get Started

领星ERP 创建STA任务 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
FBA / FBA货件(STA) · POST · 请求参数 23 个(必填 14) · 响应参数 10 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建STA任务

POST/amzStaServer/openapi/inbound-plan/createInboundPlan
Factory
{
  "operation": {
    "method": "POST",
    "path": "/amzStaServer/openapi/inbound-plan/createInboundPlan"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/amzStaServer/openapi/inbound-plan/createInboundPlan?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"addressLine1\": \"详细街道地址1\",\n    \"addressLine2\": \"详细街道地址2\",\n    \"city\": \"城市\",\n    \"companyName\": \"公司名称\",\n    \"countryCode\": \"国家(地区)\",\n    \"email\": \"邮箱\",\n    \"inboundPlanItems\": [{\n        \"expiration\": \"2023-11-20\",\n        \"labelOwner\": \"AMAZON\",\n        \"msku\": \"msku\",\n        \"prepOwner\": \"NONE\",\n        \"quantity\": 1\n    }],\n    \"phoneNumber\": \"\",\n    \"planName\": \"计划名称\",\n    \"positionType\": \"1\",\n    \"postalCode\": \"邮政编码\",\n    \"remark\": \"备注\",\n    \"shipperName\": \"发货方名称\",\n    \"sid\": 1,\n    \"stateOrProvinceCode\": \"\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "errorDetails": [],
    "requestId": "3b3d867e7d014971a580549f107c8c5a.1732773886069",
    "responseTime": "2024-11-28T14:04:46.069",
    "data": {
      "errorMsg": "错误信息",
      "inboundPlanId": "亚马逊任务编号",
      "taskId": "任务id",
      "taskStatus": "任务状态"
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1addressLine1详细街道地址1string—Required详细街道地址1
2addressLine2详细街道地址2string—Optional详细街道地址2
3city城市string—Required城市
4companyName公司名称string—Optional公司名称
5countryCode国家(地区)string—Required国家(地区)
6email邮箱string—Optional邮箱
7inboundPlanItems计划明细列表array<object>—Required计划明细列表
7.1expiration有效期string—Optional有效期
7.2labelOwner标签类型string—Required标签类型 AMAZON SELLER NONE
7.3mskumskustring—Requiredmsku
7.4prepOwner预处理提供方string—Required预处理提供方 AMAZON SELLER NONE
7.5quantity申报量integer—Required申报量
7.6prepCategory预处理分类string—Optional预处理分类:(当商品未在卖家中心设置过预处理指导时可填写) ADULT-成人:对应的预处理类型通常为无需预处理[ITEM_NO_PREP],也可传其他预处理类型 HANGER-悬挂在衣架上的服装:对应的预处理类型通常为聚乙烯塑料袋包装、取下衣架[ITEM_RMOVHANG, ITEM_POLYBAGGING],也可传其他预处理类型 TEXTILE-服装、面料、毛绒玩具和纺织品:对应的预处理类型通常为聚乙烯塑料袋包装[ITEM_POLYBAGGING],也可传其他预处理类型 BABY-母婴用品:对应的预处理类型通常为无需预处理[ITEM_NO_PREP],也可传其他预处理类型 FRAGILE-易碎品:对应的预处理类型通常为气泡膜包装、贴标签[ITEM_BUBBLEWRAP, ITEM_LABELING],也可传其他预处理类型 LIQUID-液体(未存放在玻璃容器中):对应的预处理类型通常为无需预处理[ITEM_NO_PREP],也可传其他预处理类型 PERFORATED-打孔包装:对应的预处理类型通常为聚乙烯塑料袋包装、窒息警告[ITEM_POLYBAGGING, ITEM_SUFFOSTK],也可传其他预处理类型 GRANULAR-粉末、球状或颗粒状物品:对应的预处理类型通常为聚乙烯塑料袋包装、窒息警告[ITEM_POLYBAGGING, ITEM_SUFFOSTK],也可传其他预处理类型 SHARP-尖利物品:对应的预处理类型通常为气泡膜包装、贴标签[ITEM_BUBBLEWRAP, ITEM_LABELING],也可传其他预处理类型 SMALL-小号:对应的预处理类型通常为聚乙烯塑料袋包装、贴标签[ITEM_POLYBAGGING, ITEM_LABELING],也可传其他预处理类型 SET-套装销售:对应的预处理类型通常为气泡膜包装、贴标签、套装创建[ITEM_BUBBLEWRAP,ITEM_SETCREAT, ITEM_LABELING],也可传其他预处理类型 NONE-无需进行预处理:对应的预处理类型通常为无需预处理[ITEM_NO_PREP],也可传其他预处理类型
7.7prepTypes预处理类型array<any>—Optional预处理类型:(当商品未在卖家中心设置过预处理指导时可填写) ITEM_POLYBAGGING-聚乙烯塑料袋包装:将商品放在透明袋中,以防破损、落尘或泄漏。包装袋必须印有窒息警告,必须密封(如果不是自粘袋)。商品也可以使用收缩包装。 ITEM_BUBBLEWRAP-气泡膜包装:如果商品本身不具有保护性包装,请将每件商品都用保护性气泡膜包装或者缠裹起来,也可以将商品放在保护性套箱或气泡袋中(气泡袋必须有窒息警告)。确保包装严密且完全覆盖裸露的边缘。 ITEM_LABELING-贴标签:必须在商品上应用FNSKU标签。 ITEM_SUFFOSTK-窒息警告:开口12厘米或更大的塑料袋(平放时测量)必须有窒息警告。此警告必须印在袋子上或作为标签附加。 ITEM_RMOVHANG-取下衣架:商品不能使用衣架发货。 ITEM_SETCREAT-套装创建:成套销售的商品必须在包装上贴上套装标签。例如,“套装销售”、“准备发货”或“套装勿拆”。单件商品上的条形码不得朝外,否则应予以遮盖。 ITEM_BLACK_SHRINKWRAP-不透明袋包装:将商品放入黑色或不透明的包装袋中,包装袋必须印有窒息警告,必须封紧(如果不是自粘袋)。 ITEM_SIOC-原包装发货:商品以原始产品包装发货。 ITEM_HANG_GARMENT-悬挂衣服:取下衣架,然后将商品放入透明袋中,以防损坏或落尘。商品也可以使用收缩包装。 ITEM_SETSTK-套装销售:套装产品必须在包装上标明为套装。在子套装产品上添加一个标签,清楚地说明产品必须作为整体单位接受和销售。例如,如果一套六个独特的玩具车作为整体单位销售,每辆车的包装必须表明它是套装的一部分 ITEM_TAPING-胶带固定:表示需要用胶带固定。 ITEM_BOXING-装箱:对于锋利物品、易碎物品、危险液体和黑胶唱片,可能需要装箱。对于超过4.5公斤的物品,请使用双壁瓦楞箱。 ITEM_BLANKSTK-空白贴纸:商品需要一个空白贴纸来遮盖无法被另一个贴纸覆盖的不良条形码 ITEM_CAP_SEALING-二次密封:为了防止泄漏,产品需要有以下类型的二次密封:感应密封、安全环、夹子、热收缩塑料袋或装箱。 ITEM_DEBUNDLE-拆包:需要拆开标有单独销售的一组商品。
7.8invoiceSns发货计划编码列表array<any>—Optional发货计划编码列表
8phoneNumber电话号码string—Required电话号码
9planName计划名称string—Optional计划名称
10positionType分仓方式(1-先装箱再分仓string—Required分仓方式(1-先装箱再分仓,2-先分仓再装箱)
11postalCode邮政编码string—Required邮政编码
12remark备注string—Optional备注
13shipperName发货方名称string—Required发货方名称
14sid领星店铺IDinteger—Required领星店铺ID,对应查询亚马逊店铺列表接口对应字段【sid】
15stateOrProvinceCode州/省/地区string—Required州/省/地区

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3errorDetails错误信息array<any>—Required错误信息
4requestId请求链路idstring—Required请求链路id
5responseTime响应时间string2020-05-18 11:23:47Required响应时间
6data响应数据object—Required响应数据
6.1errorMsg错误信息string—Required错误信息
6.2inboundPlanId亚马逊任务编号string—Required亚马逊任务编号
6.3taskId任务idstring—Required任务id
6.4taskStatus任务状态string—Required任务状态 process success failure local_failure

The 创建STA任务 API (/amzStaServer/openapi/inbound-plan/createInboundPlan) 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.