/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×tamp=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": "任务状态"
}
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | addressLine1 | 详细街道地址1 | string | — | Required | 详细街道地址1 |
| 2 | addressLine2 | 详细街道地址2 | string | — | Optional | 详细街道地址2 |
| 3 | city | 城市 | string | — | Required | 城市 |
| 4 | companyName | 公司名称 | string | — | Optional | 公司名称 |
| 5 | countryCode | 国家(地区) | string | — | Required | 国家(地区) |
| 6 | 邮箱 | string | — | Optional | 邮箱 | |
| 7 | inboundPlanItems | 计划明细列表 | array<object> | — | Required | 计划明细列表 |
| 7.1 | expiration | 有效期 | string | — | Optional | 有效期 |
| 7.2 | labelOwner | 标签类型 | string | — | Required | 标签类型 AMAZON SELLER NONE |
| 7.3 | msku | msku | string | — | Required | msku |
| 7.4 | prepOwner | 预处理提供方 | string | — | Required | 预处理提供方 AMAZON SELLER NONE |
| 7.5 | quantity | 申报量 | integer | — | Required | 申报量 |
| 7.6 | prepCategory | 预处理分类 | 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.7 | prepTypes | 预处理类型 | 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.8 | invoiceSns | 发货计划编码列表 | array<any> | — | Optional | 发货计划编码列表 |
| 8 | phoneNumber | 电话号码 | string | — | Required | 电话号码 |
| 9 | planName | 计划名称 | string | — | Optional | 计划名称 |
| 10 | positionType | 分仓方式(1-先装箱再分仓 | string | — | Required | 分仓方式(1-先装箱再分仓,2-先分仓再装箱) |
| 11 | postalCode | 邮政编码 | string | — | Required | 邮政编码 |
| 12 | remark | 备注 | string | — | Optional | 备注 |
| 13 | shipperName | 发货方名称 | string | — | Required | 发货方名称 |
| 14 | sid | 领星店铺ID | integer | — | Required | 领星店铺ID,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 15 | stateOrProvinceCode | 州/省/地区 | string | — | Required | 州/省/地区 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | errorDetails | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | requestId | 请求链路id | string | — | Required | 请求链路id |
| 5 | responseTime | 响应时间 | string | 2020-05-18 11:23:47 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | errorMsg | 错误信息 | string | — | Required | 错误信息 |
| 6.2 | inboundPlanId | 亚马逊任务编号 | string | — | Required | 亚马逊任务编号 |
| 6.3 | taskId | 任务id | string | — | Required | 任务id |
| 6.4 | taskStatus | 任务状态 | 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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.