Tạo sản phẩm toàn cầu

*Bài viết này áp dụng cho người bán xuyên biên giới đã nâng cấp CNSC/KRSC

Sản phẩm toàn cầu là gì?

Sản phẩm toàn cầu được đề xuất cho người bán xuyên biên giới, thông qua đó bạn có thể quản lý sản phẩm của nhiều shop ở nhiều thị trường trong một nơi. Ưu điểm của sản phẩm toàn cầu được thể hiện ở các khía cạnh sau:

• Tự động dịch ngôn ngữ: người bán có thể điền tên sản phẩm và mô tả của sản phẩm toàn cầu bằng tiếng Trung hoặc tiếng Anh, và thiết lập đồng bộ cập nhật lên sản phẩm shop, Shopee sẽ tự động dịch sang ngôn ngữ địa phương.
• Quản lý tồn kho thống nhất: người bán có thể thống nhất quản lý tồn kho sản phẩm của nhiều shop thông qua sản phẩm toàn cầu.
• Đồng bộ cập nhật thông tin sản phẩm: đối với một số thông tin sản phẩm không có sự khác biệt theo thị trường, người bán có thể chỉnh sửa sản phẩm toàn cầu, sau đó Shopee sẽ đồng bộ cập nhật lên thông tin sản phẩm shop.
• Định giá một lần cho nhiều shop: Shopee cung cấp công thức định giá và cấu hình hệ số công thức, người bán có thể cập nhật giá sản phẩm toàn cầu và thiết lập đồng bộ cập nhật lên sản phẩm shop, Shopee sẽ cập nhật giá sản phẩm shop theo kết quả tính toán của công thức.

Hiện tại, người bán xuyên biên giới đã nâng cấp CNSC hoặc KRSC cần tích hợp thêm Merchant API và Global Product API, vì bạn cần quản lý thông tin sản phẩm bằng sản phẩm toàn cầu. Đối với các API khác như API liên quan đến đơn hàng, không cần thay đổi.

• Nhấp vào đây để tìm hiểu thêm về CNSC.
• Nhấp vào đây để tìm hiểu thêm về KRSC.

Hệ thống tài khoản CNSC/KRSC

Dưới đây chúng tôi sẽ giải thích các khái niệm liên quan đến hệ thống tài khoản CNSC hoặc KRSC đã nâng cấp. (Chỉ áp dụng cho người bán xuyên biên giới)

Mô tả thuật ngữ:

• Tài khoản chính: Tài khoản người bán có thẩm quyền cao nhất, chủ tài khoản thường là một pháp nhân doanh nghiệp, và tài khoản này có thể quản lý tất cả các shop và tất cả các tài khoản phụ của người bán. Định dạng đăng nhập của tài khoản chính là XXX: main, ví dụ maidehao:main.
• Merchant: Công ty thuộc tài khoản chính, có thể thêm nhiều công ty vào một tài khoản chính sau khi được kích hoạt.
• Shop: Các shop thuộc tài khoản chính. Shop ở nhiều thị trường có thể tồn tại dưới một Merchant. Tài khoản chính có thể ủy quyền cho các shop được quản lý bởi các tài khoản phụ khác nhau.

1. Khi bạn nâng cấp các shop lên tài khoản CNSC/KRSC, bạn sẽ nhận được tài khoản chính để ủy quyền, và chỉ tài khoản chính mới có thể thực hiện ủy quyền shop. Vui lòng tham khảo bài viết về cách ủy quyền bằng tài khoản chính.

2. Dưới một tài khoản chính, có thể có nhiều Merchant, và dưới mỗi Merchant có thể có nhiều shop thị trường, bao gồm cả shop của SIP. Ngoài ra, có thể có nhiều shop cùng thị trường dưới Merchant.

Sản phẩm toàn cầu và sản phẩm shop

Dưới đây chúng tôi sẽ giải thích mối quan hệ giữa sản phẩm toàn cầu và sản phẩm shop.

Viết tắt	Tên CNSC/KRSC	Mô tả
MTSKU	SKU toàn cầu	Người bán sẽ quản lý một số thông tin sản phẩm cơ bản bằng MTSKU, bao gồm danh mục sản phẩm, thuộc tính, trọng lượng, v.v. Sau khi xuất bản lên các thị trường khác nhau, người bán chỉ cần chỉnh sửa sản phẩm toàn cầu, Shopee sẽ đồng bộ các thay đổi lên sản phẩm shop.
MPSKU	SKU shop	Sản phẩm thực tế hiển thị cho người mua.

Thay đổi trong quy trình quản lý sản phẩm

Sau khi áp dụng quản lý sản phẩm toàn cầu, hãy lưu ý các thay đổi sau trong quy trình quản lý sản phẩm:

1. Tạo sản phẩm

Bây giờ bạn phải tạo sản phẩm toàn cầu thông qua API v2.global_product.add_global_item, sau đó gọi API v2.global_product.create_publish_task để xuất bản sản phẩm toàn cầu lên từng thị trường, khi đó sản phẩm shop sẽ được tạo ra. Để biết thêm chi tiết về quy trình xuất bản, hãy nhấp vào đây.

2. Hạn chế quản lý trường thông tin

Chúng tôi chia các trường liên quan đến sản phẩm thành ba loại:

1. Các trường chỉ có thể được quản lý bởi MTSKU: Những trường này không có sự khác biệt theo thị trường, như danh mục, thuộc tính, v.v. Khi người bán cập nhật giá trị của những trường này trong MTSKU, Shopee cũng sẽ cập nhật giá trị đó lên MPSKU.

2. Các trường được quản lý chung bởi MTSKU và MPSKU: Những trường này có sự khác biệt theo thị trường, như tên sản phẩm và mô tả sản phẩm. Nếu người bán chọn cập nhật giá trị trường qua MTSKU, Shopee sẽ dịch hoặc cập nhật giá trị đó lên MPSKU. Nếu người bán chọn cập nhật giá trị của MPSKU độc lập mà không chỉnh sửa MTSKU, cập nhật sẽ chỉ có hiệu lực cho MPSKU đó.

3. Các trường chỉ có thể được quản lý bởi MPSKU: Những trường này không được quản lý qua sản phẩm toàn cầu, như thông tin logistics.

Trường API	Quản lý bởi MTSKU	Quản lý bởi MPSKU
category_id	✓	×
attribute	✓	×
brand	✓	×
item_name	✓	✓
description	✓	✓
weight	✓	×
dimension	✓	×
price	✓	✓
stock	✓	×
image/video	✓	✓
days_to_ship	✓	✓
item_status	✓	✓
condition	✓	×
item sku	✓	×
tier_variation structure	✓	×
tier_variation-name/option	✓	✓
logistics	×	✓

Lưu ý:

• Logic tồn kho: Giả sử tồn kho của MTSKU là 10 và MTSKU đã xuất bản MPSKU1 và MPSKU2, thì tồn kho của MPSKU1 = MPSKU2 = 10. Khi người mua mua một MPSKU1, tức là tồn kho MPSKU1=9, thì tồn kho MTSKU= MPSKU2=9.
• Logic trạng thái sản phẩm: Nếu một sản phẩm toàn cầu bị xóa, tất cả các sản phẩm shop đã được xuất bản từ sản phẩm toàn cầu đó cũng sẽ bị xóa. Tuy nhiên, sản phẩm shop có thể bị xóa và ẩn danh sách riêng lẻ mà không ảnh hưởng đến sản phẩm toàn cầu.

3. Sự khác biệt dữ liệu cơ bản của sản phẩm

Nếu bạn lần đầu kết nối với quản lý sản phẩm Shopee, chúng tôi khuyến nghị đọc qua bài viết "Chuẩn bị tạo sản phẩm" trước, vì các trường của sản phẩm toàn cầu và sản phẩm shop về cơ bản là giống nhau. Ở đây chúng tôi sẽ giải thích sự khác biệt.

3.1 Lấy danh mục

API: v2.global_product.get_category

Lưu ý:

• Đối với các merchant khác nhau, API này trả về cùng một dữ liệu cây danh mục.
• API v2.global_product.get_category sẽ trả về các danh mục có sẵn cho sản phẩm toàn cầu. Tuy nhiên, có thể xảy ra tình huống danh mục A không có sẵn ở shop Malaysia nhưng có sẵn ở shop Brazil, trong quá trình xuất bản sản phẩm toàn cầu chúng tôi sẽ thông báo bạn không nên xuất bản sản phẩm toàn cầu lên Malaysia. Nếu bạn muốn lấy chính xác danh mục có sẵn cho từng thị trường, bạn có thể gọi API v2.product.get_category.

3.2 Lấy danh mục được đề xuất

API: v2.global_product.category_recommend

3.3 Lấy thuộc tính

API：v2.global_product.get_attribute_tree

Lưu ý:

• Chức năng của tham số yêu cầu need_region_mandatory và tham số phản hồi mandatory_region: vì đối với một số thuộc tính, ví dụ như thuộc tính NCC, chỉ bắt buộc cho sản phẩm ở thị trường Đài Loan. Nếu người bán không muốn xuất bản lên shop Đài Loan, chúng tôi không muốn chặn quy trình tạo sản phẩm toàn cầu, vì vậy thuộc tính này sẽ là tùy chọn cho sản phẩm toàn cầu, nhưng chúng tôi sẽ thông báo qua tham số phản hồi "mandatory_region" về mã thị trường yêu cầu các thuộc tính nhất định đó.
• Ngoại trừ các thuộc tính đặc biệt được đề cập ở điểm đầu, tất cả các thuộc tính khác, miễn là một trong các thị trường yêu cầu bắt buộc, sẽ được API v2.global_product.get_attribute_tree trả về là bắt buộc.

3.4 Lấy thuộc tính được đề xuất

API: v2.global_product.get_recommend_attribute

3.5 Lấy danh sách thương hiệu có sẵn

API: v2.global_product.get_brand_list

3.6 Lấy số ngày giao hàng

API: v2.global_product.get_dts_limit

Lưu ý:

API v2.global_product.get_dts_limit sẽ trả về tổng hợp số ngày giao hàng có thể điền cho tất cả các thị trường, tức là có thể là

"days_to_ship_range_list": [

  \{

            "min\_limit": 7,

           "max\_limit": 8

      \},

     \{

         "min\_limit": 10,

           "max\_limit": 13

      \} ]

Trong trường hợp này, các số ngày giao hàng có sẵn cho sản phẩm toàn cầu là 7, 8, 10, 11, 12 và 13.

Bạn cũng có thể lưu dữ liệu API của v2.product.get_dts_limit để lấy số ngày giao hàng chính xác hơn cho từng thị trường.

3.7 Lấy thông tin về việc danh mục có hỗ trợ bảng size không

API: v2.global_product.support_size_chart

Lưu ý:

Chúng tôi đang triển khai bảng size dạng bảng. Vui lòng xem thông báo để biết chi tiết.

3.8 Lấy giới hạn sản phẩm toàn cầu

API: v2.global_product.get_global_item_limit

Lưu ý:

Chức năng của trường text_length_multiplier: Đối với tên sản phẩm/mô tả/tên biến thể và tên tùy chọn của MTSKU, chúng tôi hỗ trợ người bán nhập bằng tiếng Trung và tiếng Anh, nhưng bản dịch tiếng Trung với cùng độ dài ký tự sẽ có thông tin dài hơn bản dịch tiếng Anh sang ngôn ngữ thị trường, vì vậy để tiếng Trung và tiếng Anh có giới hạn độ dài ký tự khác nhau, chúng tôi đã thêm trường text_length_multiplier để chỉ ra hệ số nhân ký tự tiếng Trung. Nghĩa là, khi API trả về

"text_length_multiplier": 2.44,

"global_item_name_length_limit": {

       "min\_limit": 1,

       "max\_limit": 500

},

Điều này có nghĩa là nếu người bán điền tên sản phẩm bằng tiếng Anh, số ký tự tối đa là 1 đến 500; nếu người bán điền tên sản phẩm bằng tiếng Trung, số ký tự tối đa là 1 đến 204 (vì 500/2.44 =204.92). Mô tả/tên biến thể và tên tùy chọn có logic tương tự.

4. Tạo sản phẩm toàn cầu

4.1 Hoàn tất cấu hình cơ bản CNSC/KRSC

Người bán cần đăng nhập vào CNSC/KRSC để hoàn tất cấu hình tiền tệ và tỷ giá trước khi tạo sản phẩm toàn cầu, nếu không API v2.global_product.add_global_item sẽ báo lỗi.

• Người bán CNSC tìm hiểu thêm về hướng dẫn vận hành

• Thiết lập tiền tệ: https://shopee.cn/edu/article/10614

• Thiết lập tỷ giá: https://shopee.cn/edu/article/3904

• Đối với người bán KRSC, vui lòng nhấp vào đây để biết thêm chi tiết.

4.2 Hoàn tất ủy quyền tài khoản chính

Vui lòng tham khảo "Ủy quyền và Xác thực"

4.3 Lấy danh sách merchant id và shop id dưới tài khoản chính

Có thể gọi các API sau:

Bước 1: Lấy danh sách merchant id và shop id đã được ủy quyền hiện tại thông qua API v2.public.get_access_token sau khi ủy quyền.

Bước 2: Gọi API v2.merchant.get_merchant_info để lấy thông tin merchant của từng merchant đã được ủy quyền.

Bước 3: Gọi API v2.merchant.get_shop_list_by_merchant để lấy danh sách các shop đã được ủy quyền của từng merchant.

Bước 4: Gọi API v2.shop.get_shop_info để lấy thông tin của từng shop đã được ủy quyền, bao gồm mối quan hệ giữa shop SIP chính và các shop liên kết.

• Nếu là shop thông thường, is_sip= false và trường sip_affi_shops không được trả về;
• Nếu là shop SIP chính, is_sip=true và trường sip_affi_shops được trả về;
• Nếu là shop SIP liên kết, is_sip=true và trường sip_affi_shops không được trả về.

4.4 Thiết lập đồng bộ thông tin sản phẩm

Người bán có thể thiết lập các cập nhật thông tin sản phẩm toàn cầu có tự động đồng bộ lên sản phẩm shop hay không thông qua CNSC/KRSC hoặc API.

Ảnh chụp màn hình CNSC/KRSC.

*Đã chọn nghĩa là đồng bộ, bỏ chọn nghĩa là không đồng bộ.

Thiết lập qua API v2.global_product.set_sync_field, "true" nghĩa là đồng bộ, "false" nghĩa là không đồng bộ.

4.5 Tải lên sản phẩm toàn cầu

4.5.1 Tải lên tệp media

Hình ảnh và video sản phẩm cần được lưu trữ trước trong không gian media của Shopee, vì vậy bạn cần gọi API media_space liên quan để tải lên trước. Để biết thêm chi tiết, vui lòng tham khảo phần "Tải lên tệp media".

Sau khi tải lên hình ảnh và video, bạn có thể gọi API v2.global_product.add_global_item để tạo sản phẩm toàn cầu.

4.5.2 Tải lên danh mục và thuộc tính danh mục

1. Tải lên danh mục

Sản phẩm toàn cầu bắt buộc phải có category id. Bạn chỉ có thể chọn category id có "has_children"=false từ API v2.global_product.get_category.

2）Tải lên thuộc tính

Sản phẩm toàn cầu phải tải lên các thuộc tính bắt buộc. Bạn có thể tìm hiểu về các loại thuộc tính khác nhau qua bài viết "Chuẩn bị tạo sản phẩm". Để biết chi tiết cách tải lên các loại thuộc tính khác nhau cho sản phẩm, vui lòng tham khảo bài viết "Tạo sản phẩm".

4.5.3 Tải lên tên sản phẩm toàn cầu

global_item_name chỉ có thể được tải lên bằng tiếng Trung giản thể thuần túy hoặc tiếng Anh thuần túy và số. Vui lòng không trộn lẫn tiếng Anh và tiếng Trung trong tên, vì điều này có thể dẫn đến một số từ không được dịch sang ngôn ngữ địa phương, sau đó sản phẩm có thể bị cấm.

4.5.4 Tải lên mô tả sản phẩm toàn cầu

Mô tả sản phẩm toàn cầu chỉ có thể được điền bằng tiếng Trung giản thể, tiếng Anh và số.

Lưu ý:

Hiện tại chúng tôi hỗ trợ người bán được whitelist chèn hình ảnh vào mô tả, vui lòng tham khảo FAQ để biết chi tiết cách tải lên.

4.5.5 Tải lên giá sản phẩm toàn cầu

Người bán xuyên biên giới Trung Quốc có thể sử dụng CNY hoặc USD để định giá, người bán xuyên biên giới Hàn Quốc có thể sử dụng USD để định giá. Bạn cần kiểm tra trường merchant_currency trong API v2.merchant.get_merchant_info, sau đó tải lên giá của loại tiền tệ tương ứng theo tiền tệ mà người bán đã chọn.

4.5.6 Tải lên tồn kho sản phẩm toàn cầu

Lưu ý logic tồn kho:

Ví dụ, nếu MTSKU xuất bản 3 MPSKU là MPSKU1, MPSKU2, MPSKU3, thì khi tồn kho MTSKU được đặt là 100, tồn kho MPSKU1=MPSKU2=MPSKU3=100. Khi MPSKU1 bán được một sản phẩm, tồn kho MTSKU=MPSKU1=MPSKU2=MPSKU3=99.

4.6 Tạo biến thể

Khi bạn tạo sản phẩm toàn cầu thành công, API v2.global_product.add_global_item sẽ trả về global_item_id, là mã định danh duy nhất của sản phẩm toàn cầu. Nếu bạn cũng cần xác định thông số kỹ thuật và tạo nhiều biến thể, bạn có thể gọi API v2.global_product.init_tier_variation, sau đó bạn sẽ nhận được global_model_id từ API v2.global_product.get_global_model_list cho mỗi biến thể như là mã định danh duy nhất của biến thể.

4.6.1 Tạo biến thể 1 tầng

Giả sử sản phẩm có thông số kích cỡ, kích cỡ bao gồm XS, S và M. Chúng ta gọi đây là sản phẩm biến thể 1 tầng.

tier_index	size	price	stock	sku
tier_index[0]	XS	100	10	sku1
tier_index[1]	S	200	20	sku2
tier_index[2]	M	300	30	sku3

Ví dụ yêu cầu API v2.global_product.init_tier_variation:

Json

{

    "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 Tạo biến thể 2 tầng

Giả sử sản phẩm có thông số màu sắc và kích cỡ, màu sắc bao gồm đỏ và xanh, và kích cỡ bao gồm XL và L. Chúng ta gọi đây là sản phẩm biến thể 2 tầng, vì vậy trong ví dụ này có tối đa 2*2=4 biến thể.

tier_index	color	size	price	stock	sku
tier_index[0,0]	Red	XL	100	10	sku1
tier_index[0,1]	Red	L	200	20	sku2
tier_index[1,0]	Blue	XL	300	30	sku3
tier_index[1,1]	Blue	L	400	40	sku4

Ví dụ yêu cầu API v2.global_product.init_tier_variation:

Json

 {

  "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"

    }  ]

}

Lưu ý:

• Các tùy chọn bạn xác định sẽ được hiển thị theo thứ tự trên gian hàng Shopee. Shopee hiện chỉ hỗ trợ xác định biến thể tối đa 2 tầng.
• Bạn có thể xác định hình ảnh cho mỗi biến thể. Nếu là sản phẩm biến thể 2 tầng, bạn chỉ có thể xác định hình ảnh cho các tùy chọn lớp đầu tiên, tức là trong ví dụ, bạn có thể xác định hình ảnh biến thể theo màu sắc, nhưng không theo kích cỡ. Khi bạn muốn thêm hình ảnh biến thể, tất cả các tùy chọn ở lớp đầu tiên đều cần xác định hình ảnh. Hình ảnh cần được tải lên bằng cách gọi API v2.media_space.upload_image trước.
• tier_index phải bắt đầu từ 0 và không được vượt quá giới hạn, nếu không sẽ báo lỗi.
• Chúng tôi khuyến nghị bạn tạo biến thể sau khoảng 5 giây sau khi tạo sản phẩm, vì có thể có độ trễ trong việc tạo dữ liệu sản phẩm.

Tiếp theo, hãy xem cách xuất bản sản phẩm toàn cầu