轻易云
注册体验

领星ERP刊登流程说明接口

所属平台
领星ERP
类型
DOC
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
现已支持「刊登新品」「更新已有商品信息」「创建跟卖」,三类操作按各自独立流程运转,可在下方按需查看对应说明 「刊登新品」 将新商品刊登至亚马逊,支持刊登主站商品和低价商店商品,完整流程共五步: 确认商品 productType → 获取 JSON Schema → 本地处理 JSON Schema,填写商品资料 → 提交商品资料,等待亚马逊处理 → 查询刊登结果 步骤一:确认商品 productType 1.1 请求【查询 Amazon 根分类】接口 查询 Amazon 根分类 · 接口地址:/basicOpen/openapi/publish/manage/categoryRoot · 参数:要刊登的店铺 sid · 返回:该站点的全部根分类及其 category_unique_id,用于查询子分类 1.2 请求【查询 Amazon 子分类】接口 查询 Amazon 子分类 · 接口地址:/basicOpen/openapi/publish/manage/categoryChildren · 参数:sid、category_unique_id · 返回:该根分类的子分类及其 category_unique_id · 流程说明:如果子分类的 has_children=1,继续请求本接口,获取下一级子分类;直到 has_children=0,该分类是最末级分类;末级分类的:productTypeOrigin 字...
更新日期
2026-11-21

刊登流程说明

DOC/new/api-docs/Sale/PublishHelperV2/
加工厂
{
  "operation": {
    "method": "DOC",
    "path": null
  },
  "host": "https://openapi.lingxing.com",
  "content": "现已支持「刊登新品」「更新已有商品信息」「创建跟卖」,三类操作按各自独立流程运转,可在下方按需查看对应说明\n\n「刊登新品」\n\n将新商品刊登至亚马逊,支持刊登主站商品和低价商店商品,完整流程共五步:\n\n确认商品 productType → 获取 JSON Schema → 本地处理 JSON Schema,填写商品资料 → 提交商品资料,等待亚马逊处理 → 查询刊登结果\n\n步骤一:确认商品 productType\n\n1.1 请求【查询 Amazon 根分类】接口\n\n查询 Amazon 根分类\n\n· 接口地址:/basicOpen/openapi/publish/manage/categoryRoot\n· 参数:要刊登的店铺 sid\n· 返回:该站点的全部根分类及其 category_unique_id,用于查询子分类\n\n1.2 请求【查询 Amazon 子分类】接口\n\n查询 Amazon 子分类\n\n· 接口地址:/basicOpen/openapi/publish/manage/categoryChildren\n· 参数:sid、category_unique_id\n· 返回:该根分类的子分类及其 category_unique_id\n· 流程说明:如果子分类的 has_children=1,继续请求本接口,获取下一级子分类;直到 has_children=0,该分类是最末级分类;末级分类的:productTypeOrigin 字段是商品类型,用于下一步获取刊登表单;browseNodeAttributes 字段是节点位置,在第四步构建商品资料时需要用到,请注意留存。美国站 返回 item_type_keyword,填到表单的同名字段(没有则填 productType 兜底)非美国站 返回 recommended_browse_nodes,填到表单的同名字段\n\n步骤二:获取JSON Schema\n\n请求【获取指定 productType 的 JSON Schema】接口\n\n获取指定 productType 的 JSON Schema\n\n· 接口地址:/basicOpen/openapi/publish/manage/getProductType\n· 参数:marketplaceId:市场 idproductTypeOrigin:商品类型store_id:店铺 id;刊登低价商店商品时必传,传入后将返回低价商店专用的 JSON Schema\n· 返回:该商品类型两份表单properties:站点语言propertiesZh:中文版\n· 说明:刊登新品需获取完整 JSON Schema(包含所有字段及校验规则),用于下一步构建完整商品资料\n\n步骤三:填写商品资料\n\n· 每份刊登表单包含:properties:所有字段,包括名称、定义、类型、限制、枚举值等allOf:字段定义的判断条件\n· 根据表单构建商品资料。已有多种开源库和工具可验证数据、呈现 UI 及生成代码。完整列表参见 JSON 架构工具。\n· 刊登低价商店商品时:is_value_stores_item参数需传:truebrand参数需传:genericpurchasable_offer > audience参数需传:BZRcondition_type需传:new_new\n· 刊登 FBM 配送的商品时:需填写 merchant_shipping_group 字段(运费模板 id,非名称)\n\n获取运费模板\n\n· 接口地址:/basicOpen/openapi/publish/manage/getMerchantShippingGroup\n· 参数:seller_id、marketplace_id、product_type、flagflag=0 返回已获取的运费模板(查询快)flag=1 实时请求后台最新数据(查询慢,建议优先用 flag=0)\n· 返回:数组,name 为运费模板名称,value 为运费模板 id(资料需填写模板 id)\n\n步骤四:提交商品资料\n\n请求【提交商品资料】接口,operationType=0\n\n· 接口地址:/listing/publish/openapi/amazon/product/publish\n· 按 JSON Schema 格式生成商品 JSON,放在该 SKU 的 attributes 里\n· 接口详细参数与请求示例见公共说明・提交商品资料\n\n步骤五:查询刊登结果\n\n请求【查询刊登结果】接口,确认该 SKU 是否刊登成功\n\n· 接口地址:/listing/publish/openapi/amazon/product/list\n· 参数与状态说明见公共说明・查询刊登结果\n\n「更新已有商品信息」\n\n修改已有商品的属性 (支持修改所有属性,如标题、图片、价格等),完整流程共5步:\n\n查询已有商品信息 → 获取 JSON Schema (可选) → 填写需修改字段 → 提交商品资料 → 查询刊登结果\n\n步骤一:查询已有商品信息\n\n请求【查询已有商品信息】接口\n\n查询已有商品信息\n\n· 接口地址:/listing/publish/openapi/amazon/product/search\n· 参数:sellerId、marketplaceId、mskus\n· 返回:各 msku 已有的全部商品信息返回值中的 info > productTypes > productType 即为该 msku 对应的 productType返回值中的 info > attributes 即为该 msku 目前已填写的全部属性,attributes 的结构可用于步骤三填写商品资料时使用\n\n步骤二:获取 JSON Schema(可选)\n\n若仅修改已填写字段:可跳过本步骤,在步骤三中使用步骤一获取到的 attributes 结构构建商品资料\n\n若需修改此前未填写字段:需执行本步骤,请求【获取指定 productType 的 JSON Schema】接口获取完整 JSON Schema\n\n获取指定 productType 的 JSON Schema\n\n· 接口地址:/basicOpen/openapi/publish/manage/getProductType\n· 参数:marketplaceId:市场 idproductTypeOrigin:商品类型\n· 返回:该商品类型两份表单properties:站点语言propertiesZh:中文版\n\n步骤三:填写商品资料\n\n仅需填写需要修改的字段,未填写的字段将保留原值\n\n按 JSON Schema 格式生成商品 JSON,放在该 msku 的 attributes 里\n\n步骤四:提交商品资料\n\n请求【提交商品资料】接口,operationType=1\n\n· 接口地址:/listing/publish/openapi/amazon/product/publish\n· 接口详细参数与请求示例见公共说明・提交商品资料\n\n步骤五:查询刊登结果\n\n请求【查询刊登结果】接口,确认该 SKU 是否更新成功\n\n· 接口地址:/listing/publish/openapi/amazon/product/list\n· 参数与状态说明见公共说明・查询刊登结果\n\n「创建跟卖」\n\n为已有 ASIN 创建跟卖 offer。完整流程共 5 步:\n\n校验跟卖资格 → 获取跟卖 ASIN 的 JSON Schema → 填写商品资料 → 提交商品资料 → 查询刊登结果\n\n步骤一:校验跟卖资格\n\n不是所有 ASIN 都支持跟卖,可通过请求【校验跟卖资格】接口提前确认当前店铺是否可跟卖该 ASIN\n\n校验跟卖资格\n\n步骤二:获取跟卖 ASIN 的 JSON Schema\n\n请求【获取跟卖 ASIN 的 JSON Schema】接口\n\n获取跟卖 ASIN 的 JSON Schema\n\n· 接口地址:/basicOpen/listing/publish/openapi/amazon/product/followSellSchema\n· 参数:asin、marketplaceId\n· 返回:该 ASIN 的两份跟卖表单:properties-- 站点语言,propertiesZh-- 中文版该 ASIN 的productType(可用于步骤四提交商品资料时使用):productTypeOrigin\n\n步骤三:填写商品资料\n\n· 按 JSON Schema 格式生成商品 JSON,放在该 SKU 的 attributes 里\n· 注意:创建跟卖时,商品编码仅支持填写需要跟卖的 ASIN 码,即在 merchant_suggested_asin 参数上传入跟卖的 ASIN\n\n步骤四:提交商品资料\n\n请求【提交商品资料】接口,operationType=2\n\n· 接口地址:/listing/publish/openapi/amazon/product/publish\n· 接口详细参数与请求示例见公共说明・提交商品资料\n\n步骤五:查询刊登结果\n\n请求【查询刊登结果】接口,确认该跟卖是否创建成功\n\n· 接口地址:/listing/publish/openapi/amazon/product/list\n· 参数与状态说明见公共说明・查询刊登结果\n\n公共说明\n\n1. 提交商品资料(三类操作共用)\n\n提交商品资料\n\n· 接口地址:/listing/publish/openapi/amazon/product/publish\n· 参数说明:operationType:刊登类型operationType=0:刊登新品operationType=1:更新已有商品信息operationType=2:创建跟卖\n· 支持批量提交:一次提交同个店铺的多个商品;支持混合提交:一次提交中同时进行刊登新品、更新已有商品信息和创建跟卖不同 productType 的商品需分别按对应流程构建资料,再批量提交\n\n请求示例:\n\n```json\n{\n  \"store_id\": xxxxx,\n  \"data\": [\n    {\n      \"sku\": \"xxxxxxx\",\n      \"productType\": \"xxxxx\",\n      \"operationType\": 0,  // operationType = 0 刊登新品\n      \"attributes\": {\n        \"item_name\": [\n          {\n            \"value\": \"MyBrand Carry-On Luggage\",\n            \"language_tag\": \"en_US\",\n            \"marketplace_id\": \"xxxxxxxxxxxxxxxx\"\n          }\n        ],\n        \"brand\": [\n          {\n            \"value\": \"Generic\",\n            \"language_tag\": \"en_US\",\n            \"marketplace_id\": \"xxxxxxxxxxxxxxxx\"\n          }\n        ],\n        \"supplier_declared_has_product_identifier_exemption\": [\n          {\n            \"value\": true,\n            \"marketplace_id\": \"xxxxxxxxxxxxxxxx\"\n          }\n        ],\n        \"item_type_keyword\": [\n          {\n            \"value\": \"xxxxxxxxxx\",\n            \"marketplace_id\": \"xxxxxxxxxxxxxxxx\"\n          }\n        ]\n        // ... 更多属性\n      }\n    },\n    {\n      \"sku\": \"xxxxxxx\",\n      \"productType\": \"xxxxx\",\n      \"operationType\": 1,  // operationType = 1 更新已有商品信息\n      \"attributes\": {\n        \"item_name\": [\n          {\n            \"value\": \"MyBrand Carry-On Luggage\",\n            \"language_tag\": \"en_US\",\n            \"marketplace_id\": \"xxxxxxxxxxxxxxxx\"\n          }\n        ]\n      }\n    }\n    // ... 更多 SKU\n  ]\n}\n```\n\n2. 查询刊登结果(三类操作共用)\n\n查询刊登结果\n\n请求参数\n\n· 接口地址:/listing/publish/openapi/amazon/product/list\n· 传入提交接口响应中的 record_unique_id,可查询该批次各商品的刊登结果\n· 也支持按 sku、store_id、operate_time 查询刊登结果,多个参数同时查询时为交集\n\n返回说明\n\n· status=0:表示该商品还在刊登中,请稍后重新轮询(亚马逊一般在 10 分钟内处理完成)\n· status=1:表示该商品刊登成功\n· status=2:表示该商品刊登失败,failure_reason 字段记录亚马逊的处理报错需按照报错内容修改该商品资料后,重新请求【提交商品资料】接口注意该批次已刊登成功的商品不要再重复提交\n\n构建商品资料常见问题\n\nQ1:没有品牌的商品,如何填写 brand?\n\nA1:如商品无明确品牌,可在 brand 字段填写 generic。\n\n⚠️ 某些情况下仍可能报错,具体请查看后台关于「与亚马逊无品牌商品政策相关的错误消息」的说明:帮助链接\n\nQ2:没有商品编码的商品,如何填写?\n\nA2:\n\n· externally_assigned_product_identifier 不填写\n· supplier_declared_has_product_identifier_exemption 的 value 传 true\n\n注意:\n\n必须先在亚马逊后台申请对应类目的 GTIN 豁免(流程详见后台说明:GTIN 豁免申请)\n\nGTIN 豁免按分类分别申请,部分分类不支持豁免。详见「各分类商品编码(全球贸易项目代码)要求」的说明:帮助链接\n\nQ3:如何刊登变体商品?\n\nA3:\n\n父商品信息必须包含以下属性:\n\n· parentage_level:value 属性设为 parent\n· child_parent_sku_relationship:child_relationship_type 属性设为 variation,不传 parent_sku\n· variation_theme:name 属性设为适用的值\n\n子商品信息需要具备:\n\n· parentage_level:value 属性设为 child\n· child_parent_sku_relationship:child_relationship_type 属性设为 variation,且 parent_sku 属性填写父商品的 SKU 编码\n· variation_theme:name 属性与父商品一致\n\n在为子商品选择变体主题后,相应属性变为必填项 例如,variation_theme设为SIZE、COLOR或NUMBER_OF_ITEMS,则shirt_size、color、number_of_items均变为必填。\n\n请根据所选变体主题,通过 ProductTypeDefinition 的条件要求 allOf 确定哪些属性需必填。\n\n选择variation_theme时须参考$lifecycle下的enumDeprecated。被标记为enumDeprecated的枚举值为已弃用值,请勿使用。\n\nQ4:如何引用已有商品来快速刊登新品?\n\nA4:\n\n· 请求【查询已有商品信息】接口获取已有商品的 productType、标题、描述等信息\n· 根据该 productType 请求【获取指定 productType 的 JSON Schema】接口获取刊登表单\n· 将原商品的标题、描述等信息按需填充至刊登表单,在此基础上进行修改和补充,最后请求【提交商品资料】接口完成刊登"
}

接口请求参数

暂无参数说明

接口响应参数

暂无参数说明

领星ERP的接口:刊登流程说明(/new/api-docs/Sale/PublishHelperV2/),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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