轻易云
注册体验

领星ERP创建STA任务接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
FBA / FBA货件(STA) · POST · 请求参数 23 个(必填 14) · 响应参数 10 个 · 限流令牌桶容量 1
更新日期
2026-11-21

创建STA任务

POST/amzStaServer/openapi/inbound-plan/createInboundPlan
加工厂
{
  "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": "任务状态"
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1addressLine1详细街道地址1string—必填详细街道地址1
2addressLine2详细街道地址2string—可选详细街道地址2
3city城市string—必填城市
4companyName公司名称string—可选公司名称
5countryCode国家(地区)string—必填国家(地区)
6email邮箱string—可选邮箱
7inboundPlanItems计划明细列表array<object>—必填计划明细列表
7.1expiration有效期string—可选有效期
7.2labelOwner标签类型string—必填标签类型 AMAZON SELLER NONE
7.3mskumskustring—必填msku
7.4prepOwner预处理提供方string—必填预处理提供方 AMAZON SELLER NONE
7.5quantity申报量integer—必填申报量
7.6prepCategory预处理分类string—可选预处理分类:(当商品未在卖家中心设置过预处理指导时可填写) 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>—可选预处理类型:(当商品未在卖家中心设置过预处理指导时可填写) 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>—可选发货计划编码列表
8phoneNumber电话号码string—必填电话号码
9planName计划名称string—可选计划名称
10positionType分仓方式(1-先装箱再分仓string—必填分仓方式(1-先装箱再分仓,2-先分仓再装箱)
11postalCode邮政编码string—必填邮政编码
12remark备注string—可选备注
13shipperName发货方名称string—必填发货方名称
14sid领星店铺IDinteger—必填领星店铺ID,对应查询亚马逊店铺列表接口对应字段【sid】
15stateOrProvinceCode州/省/地区string—必填州/省/地区

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3errorDetails错误信息array<any>—必填错误信息
4requestId请求链路idstring—必填请求链路id
5responseTime响应时间string2020-05-18 11:23:47必填响应时间
6data响应数据object—必填响应数据
6.1errorMsg错误信息string—必填错误信息
6.2inboundPlanId亚马逊任务编号string—必填亚马逊任务编号
6.3taskId任务idstring—必填任务id
6.4taskStatus任务状态string—必填任务状态 process success failure local_failure

领星ERP的接口:创建STA任务(/amzStaServer/openapi/inbound-plan/createInboundPlan),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。