/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": "任务状态"
}
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | addressLine1 | 详细街道地址1 | string | — | 必填 | 详细街道地址1 |
| 2 | addressLine2 | 详细街道地址2 | string | — | 可选 | 详细街道地址2 |
| 3 | city | 城市 | string | — | 必填 | 城市 |
| 4 | companyName | 公司名称 | string | — | 可选 | 公司名称 |
| 5 | countryCode | 国家(地区) | string | — | 必填 | 国家(地区) |
| 6 | 邮箱 | string | — | 可选 | 邮箱 | |
| 7 | inboundPlanItems | 计划明细列表 | array<object> | — | 必填 | 计划明细列表 |
| 7.1 | expiration | 有效期 | string | — | 可选 | 有效期 |
| 7.2 | labelOwner | 标签类型 | string | — | 必填 | 标签类型 AMAZON SELLER NONE |
| 7.3 | msku | msku | string | — | 必填 | msku |
| 7.4 | prepOwner | 预处理提供方 | string | — | 必填 | 预处理提供方 AMAZON SELLER NONE |
| 7.5 | quantity | 申报量 | integer | — | 必填 | 申报量 |
| 7.6 | prepCategory | 预处理分类 | 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.7 | prepTypes | 预处理类型 | 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.8 | invoiceSns | 发货计划编码列表 | array<any> | — | 可选 | 发货计划编码列表 |
| 8 | phoneNumber | 电话号码 | string | — | 必填 | 电话号码 |
| 9 | planName | 计划名称 | string | — | 可选 | 计划名称 |
| 10 | positionType | 分仓方式(1-先装箱再分仓 | string | — | 必填 | 分仓方式(1-先装箱再分仓,2-先分仓再装箱) |
| 11 | postalCode | 邮政编码 | string | — | 必填 | 邮政编码 |
| 12 | remark | 备注 | string | — | 可选 | 备注 |
| 13 | shipperName | 发货方名称 | string | — | 必填 | 发货方名称 |
| 14 | sid | 领星店铺ID | integer | — | 必填 | 领星店铺ID,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 15 | stateOrProvinceCode | 州/省/地区 | string | — | 必填 | 州/省/地区 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | errorDetails | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | requestId | 请求链路id | string | — | 必填 | 请求链路id |
| 5 | responseTime | 响应时间 | string | 2020-05-18 11:23:47 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | errorMsg | 错误信息 | string | — | 必填 | 错误信息 |
| 6.2 | inboundPlanId | 亚马逊任务编号 | string | — | 必填 | 亚马逊任务编号 |
| 6.3 | taskId | 任务id | string | — | 必填 | 任务id |
| 6.4 | taskStatus | 任务状态 | string | — | 必填 | 任务状态 process success failure local_failure |
领星ERP的接口:创建STA任务(/amzStaServer/openapi/inbound-plan/createInboundPlan),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。