/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· 将原商品的标题、描述等信息按需填充至刊登表单,在此基础上进行修改和补充,最后请求【提交商品资料】接口完成刊登"
}No parameter reference available
No parameter reference available
The 刊登流程说明 API (/new/api-docs/Sale/PublishHelperV2/) 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.