创建全球商品

*本文章适用于升级了CNSC/KRSC的跨境卖家

全球商品是为跨境卖家提出，您可以通过它一站式管理多个市场店铺的商品。它的优势体现在以下方面：

• 语言自动翻译：卖家可以用中文或英文填写全球商品的商品名称和描述，并设置同步更新到多个店铺商品，Shopee将会自动翻译成当地语言。
• 库存统一管理：卖家可以通过全球商品统一管理多个商品的库存。
• 商品信息同步更新：对于一些无市场差异化的商品信息，卖家可以通过修改全球商品，即可同步更新到多个店铺商品的商品信息。
• 商品一键定价：Shopee提供定价公式和公式因子的配置，卖家可以通过更新全球商品的价格，并设置同步更新到多个店铺商品，Shopee将会根据公式计算的结果更新到店铺商品。

目前升级了CNSC的中国跨境卖家和升级了KRSC的韩国跨境卖家，必须使用全球商品管理商品。对于此类卖家，请注意商品管理的流程将会和本土卖家存在差异，您需要另外对接Merchant API和Global Product API接口。对于其他例如订单相关的接口，无需做流程上的修改。

• 点击这里了解更多CNSC信息。
• 点击这里了解更多KRSC信息。

下面我们将讲解升级了CNSC或者KRSC账号体系相关概念。（只适用跨境卖家）

术语说明：

• Main account(主账户)：又称母账户，权限最高的卖家账户，账户拥有者通常是公司法人，主账户可以管理该卖家的所有商店和所有子账户。主账户的登录格式为 XXX:main，例如maidehao:main。
• Merchant（商家）：即主账户名下的公司，一个主账户激活后可以添加多个公司。
• Shop（商店）：即主账户名下的商店。一个Merchant下可以存在多个市场的店铺。主账户可以将商店授权给不同的子账户管理。

1）升级了CNSC/KRSC的店铺进行授权时，务必使用主账号登录。如何进行主账号授权请参考文章《授权与鉴权》。

2）一个主账号下，可以有多个Merchant，每个merchant下可以有多个市场的shop，包括SIP的店铺，而且，相同市场也可以存在多个shop，例如图中Merchant 1下同时有SG shop1 和SG shop 2。

下面我们将讲解全球商品和店铺商品的相关概念。

采用全球商品管理后，对于商品管理的流程，请注意以下几点的改变：

1. 创建商品

原流程还需要通过v2.product.add_item接口即可完成商品创建，现在必须通过v2.global_product.add_global_item接口创建全球商品，再调用v2.global_product.create_publish_task接口将全球商品发布到各个市场，生成店铺商品，具体发布流程请看文章《发布全球商品》。

2. 字段管理限制

我们将商品相关的字段分成三类：

1.只能通过MTSKU管理字段：这些字段无市场差异，例如类目，属性等，卖家通过更新MTSKU的字段值，Shopee将会同步更新到MPSKU；

2.MTSKU和MPSKU共同管理字段：这些字段可以有市场差异化，例如商品名称和商品描述，卖家可以选择通过MTSKU的字段值进行更新，则Shopee会经过翻译后同步更新到MPSKU，或者卖家选择单独更新某个市场的MPSKU字段值，并不修改MTSKU，则更新只生效于该MPSKU。

3.只能通过MPSKU管理字段：这些字段不通过全球商品管理，例如MPSKU的物流。

请注意：

• 库存逻辑：假设全球商品MTSKU库存为10，且MTSKU已发布店铺商品MPSKU1和MPSKU2，则MPSKU1库存=MPSKU2库存=10,当买家购买了一个 MPSKU1 时，即 MPSKU1=9 ，则 MTSKU= MPSKU2=9。
• 如果全球商品被删除，则全球商品发布过的所有店铺商品也将会被删除。但是店铺商品可以单独删除和下架而不影响全球商品。

3. 商品基本数据差异

如果您初次对接Shopee商品管理，建议先通读《商品创建准备》文章，因为创建全球商品和创建普通商品的字段基本相同。下面我们只讲述创建全球商品调用的接口和注意点。

3.1 获取全球商品类目

调用接口：v2.global_product.get_category

请注意：

• 对于不同的merchant, 这个接口返回的类目树数据一样。
• V2.global_product.get_category API返回创建全球商品可用的类目，但是可能会出现这样一种情况，类目A在马来西亚店铺不可以销售，在巴西店铺可以销售，我们将会在发布全球商品过程中提示您不可将全球商品发布到马来西亚，如果您想精确获取到各个市场的可用类目，可以调用v2.product.get_category

3.2 获取全球商品推荐类目

调用接口：v2.global_product.category_recommend

3.3 获取全球商品类目属性

调用接口：v2.global_product.get_attribute_tree

请注意：

• need_region_mandatory 请求参数和mandatory_region 响应参数的作用：因为对于某些属性，比如NCC属性，只有台湾市场的产品是强制的，如果卖家不想发布到台湾商店，我们不想拦截全球产品的正常创建，所以这个属性对于全球产品来说是可选的，但是我们会通过“mandatory_region”响应参数提示这些特定属性所需的市场代码。
• 除了第一点所说的特殊属性以外，其他属性，只要有一个市场要求必填，则 v2.global_product.get_attribute_tree 返回必填。

3.4 获取全球商品推荐属性

调用接口：v2.global_product.get_recommend_attribute

3.5 获取全球商品品牌列表

调用接口：v2.global_product.get_brand_list

3.6 获取全球商品发货天数

调用接口：v2.global_product.get_dts_limit

请注意：

V2.global_product.get_dts_limit将会返回所有市场能填写发货天数的并集，即返回的情况可以为

"days_to_ship_range_list": [

{

"min_limit": 7,

"max_limit": 8

},

{

"min_limit": 10,

"max_limit": 13

} ]

此时，全球商品可用的发货天数是7，8，10，11，12，13。

您也可以保存v2.product.get_dts_limit的接口数据，获得各个市场更加精确的发货天数要求。

3.7 获取全球商品类目是否支持尺寸表数据

调用接口：v2.global_product.support_size_chart

请注意：

我们正在推出表格类型的尺寸表格式，详情请看公告。

3.8 获取全球商品数据限制

调用接口：v2.global_product.get_global_item_limit

请注意：

text_length_multiplier的作用，由于MTSKU商品名称/描述/变体规格名称和选项名称，支持输入中文和英文，而中文语义密度较大，即用相同字符长度的中文翻译比用英文翻译成市场语言，信息会更长，所以为了中文和英文有不同的字符长度限制，我们新增了text_length_multiplier字段表示中文字符的计算倍数。即当接口返回：

"text_length_multiplier": 2.44,

"global_item_name_length_limit": {

"min_limit": 1,

"max_limit": 500

},

表示卖家如果用英文填写产品名称，则最多填写1～500个字符；如果卖家用中文填写产品名称，则最多填写1～204个字符 （500/2.44约等于204.92），描述/变体规格名称和选项名称同理。

4.创建全球商品流程

4.1 卖家完成CNSC/KRSC基础配置

卖家需要登录CNSC/KRSC 完成币种和汇率等配置后，才能进行创建全球商品，否则v2.global_product.add_global_item接口将会报错

• CNSC卖家了解更多操作指引设置基础货币：https://shopee.cn/edu/article/10614设置市场汇率：https://shopee.cn/edu/article/3904
• KRSC卖家请点击这里了解更多操作指引

4.2 完成主账号授权

详细请参考《授权与鉴权》文章中，主账号授权部分

4.3 获取主账号下所有的merchant id list和shop id list

可以调用下列接口：

第一步：授权后通过v2.public.get_access_token 获取到当前授权成功的merchant id list 和shop id list。

第二步：调用v2.merchant.get_merchant_info 接口获取每个已授权merchant的信息。

第三步：调用v2.merchant.get_shop_list_by_merchant接口获取每个merchant下已授权的shop列表。

第四步：调用v2.shop.get_shop_info接口获取每个已授权shop的信息，包括SIP主店铺和附属店铺的关系。

• 如果是普通店铺，is_sip= false 且sip_affi_shops字段不返回；
• 如果是SIP主店铺，is_sip=true 且sip_affi_shops字段返回；
• 如果是SIP附属店铺 is_sip=true 且sip_affi_shops字段不返回。

4.4 设置商品信息同步开关

卖家可以通过CNSC/KRSC或者接口设置全球商品信息的更新是否自动同步到店铺商品。

CNSC/KRSC截图：

*勾选表示同步，不勾选则不同步。

通过接口v2.global_product.set_sync_field设置，上传的参数值true表示同步，false表示不同步。

4.5 创建全球商品

4.5.1上传媒体文件

商品的图片（image）和视频（video），都需要预先存储在Shopee的媒体资料库中，所以您需要先调用media_space相关的接口上传。详细可参考文章《创建商品》 “上传媒体文件”部分。

上传图片和视频后，您就可以调用v2.global_product.add_global_item接口创建商品。

4.5.2上传类目和类目属性

1）上传类目

全球商品必须上传类目（category_id）。您只能选择v2.global_product.get_category接口中返回“has_children”=false的ID进行上传。

2）上传属性

全球商品必须上传必填的属性（attribute_list）。您可以通过《获取商品基础信息》文章了解到各种属性类型。各种属性类型如何上传，详细可参考文章《创建商品》 “上传属性”部分

4.5.3上传全球商品名称

全球商品名称（global_item_name）只能填写纯简体中文或纯英文和数字。请不要混合输入中英文，如“漂亮牌dress ready stock”，这样可能会导致部分标题没有被翻译为当地语言，导致商品被禁卖；

4.5.4上传全球商品描述

全球商品描述（description​​）只能填写简体中文、英文和数字。

*请注意：

目前我们支持白名单卖家可以使用带图文的商品描述（extended_description）,如何使用详细参考FAQ。

4.5.5上传全球商品价格

全球商品的价格（original_price），中国跨境卖家可以使用人民币或者美元进行定价，韩国跨境卖家可以使用美元定价，中国跨境卖家设置的币种，您需要查看v2.merchant.get_merchant_info接口中的merchant_currency字段，根据卖家选择的币种上传对应币种的价格。

4.5.6上传全球商品库存

请注意：

例如MTSKU一共发布了三个市场，店铺商品分别是MPSKU1, MPSKU2,MPSKU3, 则MTSKU库存设置为100时，库存MPSKU1=MPSKU2=MPSKU3=100,当MPSKU1售出1个商品后，库存MTSKU=MPSKU1=MPSKU2=MPSKU3=99

4.6 创建变体

当您创建商品成功之后，v2.global_product.add_global_item将会返回global_item_id，这是全球商品的唯一标识。如果您还需要定义规格，创建多个选项变体，例如商品的颜色尺寸，可以调用v2.global_product.init_tier_variation接口创建变体，调用成功后，调用v2.global_product.get_global_model_list API 获取每个变体的global_model_id，作为变体的唯一标识。

4.6.1 创建一层规格变体

假设商品有尺寸的规格，尺寸包含XS、S和M。我们称这种商品是1-tier variation的结构。

v2.global_product.init_tier_variation请求参数如下：

{

    "global_item_id": 800188562,

    "tier_variation": [

        {

            "name": "size",

            "option_list": [

                {

                    "option": "XS",

                    "image": {"image_id":"82becb4830bd2ee90ad6acf8a9dc26d7"}

                },

                {

                    "option": "S",

        "image": {"image_id":"72becb4830bd2ee90ad6acf879dc26d7"}

                },

                {

                    "option": "M",

      "image": {"image_id":"92becb4830bd2ee90ad6acf8a9dc26d7"}

                }

            ]

        }

    ],

    "model": [

        {

            "tier_index": [0],

            "original_price": 100,

            "global_model_sku": "sku1",

            "normal_stock": 10

        },

        {

            "tier_index": [1],

            "original_price": 200,

            "global_model_sku": "sku1",

            "normal_stock": 20

        },

       {

            "tier_index": [2],

            "original_price": 300,

            "global_model_sku": "sku3",

            "normal_stock": 30

        }

    ]

}

4.6.2 创建两层规格变体

假设商品有颜色和尺寸的规格，颜色包括红色和蓝色，尺寸包含XL和L。我们称这种商品是2-tier variation的结构，因此此例子中最多有2*2=4 个变体。

v2.global_product.init_tier_variation请求参数如下：

 {

  "global_item_id": 100917481,

  "tier_variation": [

    {

      "name": "color",

      "option_list": [

        {

          "image": {"image_id": "82becb4830bd2ee90ad6acf8a9dc26d7"},

          "option": "Red"

        },

        {

          "image": {"image_id": "72becb4830bd2ee90ad6acf879dc26d7"},

          "option": "Blue"

        }

      ]

    },

    {

      "name": "size",

      "option_list": [

        {

          "option": "XL"

        },

        {

          "option": "L"

        }

      ]

    }

  ],

  "model": [

    { 

      "tier_index": [0,0],

      "original_price": 100,

      "normal_stock": 10,

      "global_model_sku": "sku1"

    },

    {

     "tier_index": [0,1],

      "original_price": 200,

      "normal_stock": 20,

      "global_model_sku": "sku2"

    },

    {

      "tier_index": [1,0],

      "original_price": 300,

      "normal_stock": 30,

      "global_model_sku": "sku3"

    },

    {

     "tier_index": [1,1],

      "original_price": 400,

      "normal_stock": 40,

      "global_model_sku": "sku4"

    }  ]

}

请注意：

• 您定义的option，我们会按顺序显示Shopee商城端，Shopee目前只支持定义最多两层规格。
• 您可以为每个变体定义一张图片。如果是两层规格的商品，您只能定义第一层option，也就是例子中您可以根据颜色定义变体图片，不能根据尺寸定义变体图片。一旦要添加变体图片，则第一层所有的option都需要定义图片。我们不允许部分option有图片，部分option没有图片。图片需要先调用v2.media_space.upload_image接口上传。
• 请注意您定义的tier_index必须从0开始定义且不能溢出，否则会报错。
• 建议您创建商品后间隔5秒后创建变体，因为我们底层创建商品数据可能存在延迟。
• 创建成功后您可以调用v2.global_product.get_global_model_list接口获取到每个tier_index对应的model id。

下一步请查看如何发布全球商品