Lingxing
切换旧版

刊登流程说明

整体流程

支持「刊登新品」「更新已有商品信息」「创建跟卖」，共涉及以下 5 个步骤：

  1. 确认商品 productType
  2. 获取 JSON Schema
  3. 本地处理 JSON Schema，填写商品资料
  4. 提交商品资料，等待亚马逊处理
  5. 查询刊登结果

不同业务类型在各步骤中存在差异，具体说明如下。

------

步骤一：确认商品 productType

「刊登新品」

1. 请求【查询 Amazon 根分类】接口

查询 Amazon 根分类

  • 接口地址：/basicOpen/openapi/publish/manage/categoryRoot
  • 参数：要刊登的店铺 sid
  • 返回：该站点的全部根分类及其 category_unique_id，用于查询子分类
2. 请求【查询 Amazon 子分类】接口

查询 Amazon 子分类

  • 接口地址：/basicOpen/openapi/publish/manage/categoryChildren
  • 参数：sid、category_unique_id
  • 返回：该根分类的子分类及其 category_unique_id
  • 流程说明：
    • 如果子分类的 has_children=1，继续请求查询 Amazon 子分类接口，获取下一级子分类；
    • 直到 has_children=0，该分类是最末级分类；
    • 末级分类的：
      • productTypeOrigin 字段是商品类型，用于下一步获取刊登表单；
      • browseNodeAttributes 字段是节点位置，在第四步构建商品资料时需要用到，请注意留存。
        • 美国站 返回 item_type_keyword，填到表单的同名字段（没有则填 productType 兜底）
        • 非美国站 返回 recommended_browse_nodes，填到表单的同名字段

「更新已有商品信息」

请求【查询已有商品信息】接口

查询已有商品信息

  • 接口地址：/listing/publish/openapi/amazon/product/search
  • 参数：store_id、skus（最多20个）
  • 返回：各msku已有的全部商品信息
    • 返回值中的 info > productTypes> productType 即为该msku对应的 productType
    • 返回值中的info > attributes 即为该msku目前已填写的全部属性，attributes 的结构可用于步骤三填写商品资料时使用

「创建跟卖」

无需确认productType，可直接在步骤二中使用跟卖ASIN获取 JSON Schema

------

步骤二：获取 JSON Schema

「刊登新品」「更新已有商品信息」：获取指定 productType 的 JSON Schema

获取指定 productType 的 JSON Schema

  • 接口地址：/basicOpen/openapi/publish/manage/getProductType
  • 参数：
    • marketplaceId：市场id
    • productTypeOrigin：商品类型
    • store_id：店铺id；刊登低价商店商品时必传，传入后将返回低价商店专用的JSON Schema；刊登主站商品时请勿传该参数
  • 返回：该商品类型两份表单
    • properties：站点语言
    • propertiesZh：中文版
  • 说明：
    • 「刊登新品」：需获取完整 JSON Schema（包含所有字段及校验规则），用于第三步构建完整商品资料
    • 「更新已有商品信息」：
      • 若仅修改已填写字段，可跳过此步骤，在第三步中使用第一步获取到的attributes 结构构建商品资料
      • 若需修改此前未填写字段，则需执行此步骤以获取完整JSON Schema

「创建跟卖」：获取跟卖 ASIN 的 JSON Schema

获取跟卖 ASIN 的JSON Schema

  • 接口地址：/basicOpen/listing/publish/openapi/amazon/product/followSellSchema
  • 参数：store_id、asin、marketplaceId
  • 返回：
    • 该ASIN的两份跟卖表单：data.productType.properties--站点语言，data.productType.propertiesZh--中文版（均为JSON字符串）
    • 该ASIN的商品类型：data.productType.productTypeOrigin，用于第四步提交商品资料时填写productType

------

步骤三：本地处理 JSON Schema，填写商品资料

  • 每份刊登表单包含：
    • properties：所有字段，包括名称、定义、类型、限制、枚举值等
    • allOf：字段定义的判断条件
  • 根据表单构建商品资料。已有多种开源库和工具可验证数据、呈现 UI 及生成代码。完整列表参见 JSON 架构工具。
  • 特别注意：
    • 「创建跟卖」时，商品编码仅支持填写需要跟卖的ASIN码，即在merchant_suggested_asin参数上传入跟卖的ASIN
    • 「刊登低价商店商品」时：
      • is_value_stores_item参数需传：true
      • brand参数需传：generic
      • purchasable_offer > audience参数需传：BZR
      • condition_type需传：new_new
    • 「更新已有商品信息」时，仅需填写需要修改的字段，未填写的字段将保留原值
    • 刊登 FBM 配送的商品需填写 merchant_shipping_group 字段（运费模板 id，非名称）

获取运费模板

  • 接口地址：/basicOpen/openapi/publish/manage/getMerchantShippingGroup
  • 参数：
    • sellerId、marketplaceId、productType、flag
    • flag=0 返回已获取的运费模板（查询快）
    • flag=1 实时请求后台最新数据（查询慢，建议优先用 flag=0）
  • 返回：数组，name 为运费模板名称，value 为运费模板 id（资料需填写模板 id）

------

步骤四：提交商品资料，等待亚马逊处理

提交商品资料

  • 按 JSON Schema 格式生成商品 JSON，放在该 SKU 的 attributes 里
  • 接口地址：/listing/publish/openapi/amazon/product/publish
  • 参数说明：operationType：刊登类型
    • operationType=0：刊登新品
    • operationType=1：更新已有商品信息
    • operationType=2：创建跟卖
  • 支持批量提交，一次提交同个店铺的多个商品；支持混合提交，一次提交中同时进行刊登新品、更新已有商品信息和创建跟卖
    • 不同 productType 的商品需重复步骤一~三，分别构建资料，然后批量提交
  • 注意：不是所有ASIN都支持跟卖，可通过请求 校验跟卖资格 接口提前确认当前店铺是否可跟卖该ASIN
    • 接口地址：/basicOpen/listing/publish/openapi/amazon/product/followSellEligibility
    • 参数：store_id、asin、conditionType；新品的conditionType传new_new
    • 返回：data.allowFollow为1表示支持跟卖，为0表示不支持；不支持时可查看data.reason中的原因

请求示例

{
  "store_id": xxxxx,
  "data": [
    {
      "sku": "xxxxxxx",
      "productType": "xxxxx",
      "operationType": 0,  // operationType = 0 刊登新品
      "attributes": {
        "item_name": [
          {
            "value": "MyBrand Carry-On Luggage",
            "language_tag": "en_US",
            "marketplace_id": "xxxxxxxxxxxxxxxx"
          }
        ],
        "brand": [
          {
            "value": "Generic",
            "language_tag": "en_US",
            "marketplace_id": "xxxxxxxxxxxxxxxx"
          }
        ],
        "supplier_declared_has_product_identifier_exemption": [
          {
            "value": true,
            "marketplace_id": "xxxxxxxxxxxxxxxx"
          }
        ],
        "item_type_keyword": [
          {
            "value": "xxxxxxxxxx",
            "marketplace_id": "xxxxxxxxxxxxxxxx"
          }
        ]
        // ... 更多属性
      }
    },
    {
      "sku": "xxxxxxx",
      "productType": "xxxxx",
      "operationType": 1,  // operationType = 1 更新已有商品信息
      "attributes": {
        "item_name": [
          {
            "value": "MyBrand Carry-On Luggage",
            "language_tag": "en_US",
            "marketplace_id": "xxxxxxxxxxxxxxxx"
          }
        ]
      }
    }
    // ... 更多 SKU
  ]
}

------

步骤五：查询刊登结果

查询刊登结果

请求【查询刊登结果】接口

  • 接口地址：/listing/publish/openapi/amazon/product/list
  • 请求参数：
    • 传入步骤四响应中的 record_unique_id，可查询该批次各商品的刊登结果；
    • 也支持按 sku、store_id、operate_time 查询刊登结果，多个参数同时查询时为交集；

返回说明

  • status=0：表示该商品还在刊登中，请稍后重新轮询（亚马逊一般在 10 分钟内处理完成）
  • status=1：表示该商品刊登成功
  • status=2：表示该商品刊登失败，failure_reason 字段记录亚马逊的处理报错
    • 需按照报错内容修改该商品资料后，重新请求发布商品接口
    • 注意该批次已刊登成功的商品不要再重复提交

------

构建商品资料常见问题

Q1：没有品牌的商品，如何填写 brand？

A1：如商品无明确品牌，可在 brand 字段填写 "generic"。

⚠️ 某些情况下仍可能报错，具体请查看后台关于「与亚马逊无品牌商品政策相关的错误消息」的说明：帮助链接

------

Q2：没有商品编码的商品，如何填写？

A2：

  • externally_assigned_product_identifier 不填写
  • supplier_declared_has_product_identifier_exemption 的 value 传 true

注意：

- 必须先在亚马逊后台申请对应类目的 GTIN 豁免（流程详见后台说明：GTIN豁免申请）。

- GTIN豁免按分类分别申请，部分分类不支持豁免。详见「各分类商品编码（全球贸易项目代码）要求」的说明：帮助链接

------

Q3：如何刊登变体商品？

A3：

父商品信息必须包含以下属性：
  • parentage_level：value 属性设为 parent
  • child_parent_sku_relationship：child_relationship_type 属性设为 variation，不传 parent_sku
  • variation_theme：name 属性设为适用的值
子商品信息需要具备：
  • parentage_level：value 属性设为 child
  • child_parent_sku_relationship：child_relationship_type 属性设为 variation，且 parent_sku 属性填写父商品的 SKU 编码
  • variation_theme：name 属性与父商品一致

在为子商品选择变体主题后，相应属性变为必填项 例如，variation_theme 设为 SIZE、COLOR 或 NUMBER_OF_ITEMS，则 shirt_size、color、number_of_items 均变为必填。

请根据所选变体主题，通过 ProductTypeDefinition 的条件要求（allOf）确定哪些属性需必填。

选择 variation_theme 时须参考 $lifecycle 下的 enumDeprecated。被标记为 enumDeprecated 的枚举值为已弃用值，请勿使用。

------

Q4：如何引用已有商品来快速刊登新品？

A4：