Xuất bản 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.
Sau khi tạo sản phẩm toàn cầu, bạn có thể xuất bản sản phẩm đó sang từng thị trường, nhưng mỗi thị trường chỉ có thể có một sản phẩm shop từ một sản phẩm toàn cầu.
Dưới đây là luồng gọi API.
Bước 1: Lấy danh sách shop có thể xuất bản
API: v2.global_product.get_publishable_shop
Bạn có thể lấy danh sách các shop có thể xuất bản sản phẩm toàn cầu qua API này. Tuy nhiên, chúng tôi sẽ không trả về các shop tương ứng trong các trường hợp sau:
- Các shop chưa thực hiện ủy quyền shop
- Các shop liên kết SIP
- Các shop thuộc thị trường đã xuất bản
Bước 2: Lấy kênh vận chuyển của shop
API: v2.logistics.get_channel_list
Bạn cần gọi API v2.logistics.get_channel_list và chọn kênh có enable=true và mask_channel_id=0 cho sản phẩm shop. Nếu bạn xuất bản sản phẩm toàn cầu mà không tải lên kênh shop, chúng tôi sẽ tự động chọn các kênh shop đang được bật và khả dụng cho bạn.
Bước 3: Xuất bản sản phẩm toàn cầu
API: v2.global_product.create_publish_task
Đối với các trường tùy chọn của v2.global_product.create_publish_task, nếu bạn không tải lên, Shopee sẽ thực hiện một số xử lý và tải lên sản phẩm shop. Nếu bạn tải lên, đó sẽ là giá trị tùy chỉnh và Shopee sẽ không thực hiện thêm xử lý nào. Logic cụ thể như sau:
| Tên trường | Tải lên giá trị tùy chỉnh |
| item_name | Có: Người bán cần tự dịch sang ngôn ngữ địa phương rồi tải lên. Không: Shopee sẽ tự dịch sang ngôn ngữ địa phương. |
| description_info/description | Có: Người bán cần tự dịch sang ngôn ngữ địa phương rồi tải lên. Không: Shopee sẽ tự dịch sang ngôn ngữ địa phương. |
| original_price | Có: Người bán cần tải lên giá theo tiền tệ địa phương. Không: Shopee tính giá địa phương dựa trên giá sản phẩm toàn cầu và công thức tính toán. |
| tier_variation--name | Có: Người bán cần tự dịch sang ngôn ngữ địa phương rồi tải lên. Không: Shopee sẽ tự dịch sang ngôn ngữ địa phương. |
| tier_variation--option_list--option | Có: Người bán cần tự dịch sang ngôn ngữ địa phương rồi tải lên. Không: Shopee sẽ tự dịch sang ngôn ngữ địa phương. |
| image | Có: Người bán tải lên hình ảnh tùy chỉnh. Không: Shopee sẽ sao chép hình ảnh của sản phẩm toàn cầu. |
Sau khi gọi API thành công, bạn sẽ nhận được publish_task_id.
API: v2.global_product.get_publish_task_result
API này sẽ trả về kết quả tác vụ xuất bản thành công hay không. Nếu thành công, sẽ trả về item_id, shop_id và thông tin region; nếu thất bại, sẽ trả về lý do cụ thể.
Lưu ý: Nếu shop được xuất bản là shop chính SIP, sau khi xuất bản thành công, Shopee sẽ tự động xuất bản sản phẩm toàn cầu sang các shop liên kết thuộc shop chính SIP đó.
Bước 4: Lấy danh sách sản phẩm shop đã xuất bản
API: v2.global_product.get_published_list
API sẽ trả về item_id và shop_id của tất cả các shop đã xuất bản thành công sản phẩm toàn cầu này, bao gồm cả các sản phẩm shop mà Shopee tự động xuất bản sang các shop liên kết.
Lưu ý: API này không trả về các sản phẩm shop đã xuất bản nhưng chưa thực hiện ủy quyền shop.