v2.global_product.create_publish_task

POST /api/v2/global_product/create_publish_task

Tạo tác vụ đăng bán cho sản phẩm toàn cầu. Chỉ dành cho người bán Trung Quốc đại lục và người bán Hàn Quốc.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/global_product/create_publish_task

Tham số chung

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamp	timestamp	1610000000	Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
merchant_id	int	1	Mã định danh duy nhất của Shopee cho một merchant. Bắt buộc cho mọi yêu cầu cấp merchant (người dùng CB CNSC gọi các API liên quan đến sản phẩm toàn cầu).
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, merchant_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

Tên	Kiểu	Bắt buộc	Mẫu	Mô tả
global_item_id	int64	True	3500140268	ID của sản phẩm toàn cầu.
shop_id	int32	True	600620392	ID của cửa hàng cần đăng bán đến.
shop_region	string	True	TW	Khu vực của cửa hàng.
item	object	False		Thông tin sản phẩm.
item_name	string	False	item name	Tên sản phẩm. Nếu tải lên trường này, giá trị của bạn sẽ được dùng (cần truyền giá trị bằng ngôn ngữ địa phương). Nếu không tải lên, Shopee sẽ tự động dịch tên sản phẩm toàn cầu sang ngôn ngữ địa phương.
description	string	False	item description	Mô tả sản phẩm. Nếu tải lên trường này, giá trị của bạn sẽ được dùng (cần truyền giá trị bằng ngôn ngữ địa phương). Nếu không tải lên, Shopee sẽ tự động dịch mô tả sản phẩm toàn cầu sang ngôn ngữ địa phương.
item_status	string	False	NORMAL	Trạng thái của sản phẩm.
original_price	float	False	100.5	Giá gốc của sản phẩm. Người bán SG/MY/BR/MX/PL/ES/AR: Có thể đặt giá với hai chữ số thập phân, các khu vực khác chỉ được đặt giá là số nguyên. Nếu tải lên trường này, giá trị của bạn sẽ được dùng (cần truyền giá trị bằng tiền tệ địa phương). Nếu không tải lên, Shopee sẽ tự động tính giá.
image	object	False		Thông tin hình ảnh của sản phẩm.
image_id_list	string[]	True	["c54265d475b85e00ffb2404585e32b6f"]	Danh sách ID hình ảnh của sản phẩm.
model	object[]	False		Thông tin model của sản phẩm.
tier_index	int32[]	True	[0, 0]	Chỉ số cấp của model.
original_price	float	True	100.5	Giá gốc của model. Nếu tải lên trường này, giá trị của bạn sẽ được dùng (cần truyền giá trị bằng tiền tệ địa phương). Nếu không tải lên, Shopee sẽ tự động tính giá.
model_status	string	False	NORMAL	Có thể là "NORMAL" hoặc "UNAVAILABLE". Model NORMAL có thể được bán cho người mua, model UNAVAILABLE thì không. Nếu không tải lên trường này, trạng thái model mặc định là "NORMAL".
size_chart	string	False	591ab15ea954b9879374765854595600	Bảng kích thước của sản phẩm. Hiện chỉ hỗ trợ image_id.
logistic	object[]	False		Thông tin vận chuyển của sản phẩm.
logistic_id	int32	True	1001	ID kênh vận chuyển.
enabled	boolean	True	true	Kênh vận chuyển này có được bật hay không.
shipping_fee	float	False	10.5	Phí vận chuyển.
size_id	int32	False	10	ID kích thước.
is_free	boolean	False	false	Kênh vận chuyển này có miễn phí hay không.
pre_order	object	False		Thông tin đặt hàng trước của sản phẩm.
is_pre_order	boolean	True	true	Sản phẩm này có phải là đặt hàng trước hay không.
days_to_ship	int32	False	3	Số ngày chuẩn bị hàng. Bắt buộc nếu is_pre_order là true.
description_info	object	False		Trường mô tả mới. Chỉ người bán trong danh sách trắng mới có thể sử dụng. Nếu sử dụng trường này, hãy tải lên description_type=extended, nếu không API sẽ trả lỗi. Nếu tải lên trường này, giá trị của bạn sẽ được dùng (cần truyền giá trị bằng ngôn ngữ địa phương). Nếu không tải lên, Shopee sẽ tự động dịch mô tả sản phẩm toàn cầu.
extended_description	object	False		Nếu description_type là extended, thông tin mô tả cần được thiết lập bằng trường này.
field_list	object[]	False		Danh sách trường của mô tả mở rộng.
field_type	string	False		Kiểu trường mô tả mở rộng: xem Định nghĩa dữ liệu - description_field_type (text, image).
text	string	False		Nếu field_type là text, thông tin văn bản sẽ được thiết lập bằng trường này.
image_info	object	False		Nếu field_type là image, URL hình ảnh sẽ được thiết lập bằng trường này.
image_id	string	False		ID hình ảnh.
standardise_tier_variation	object[]	False
variation_id	int	False
variation_name	string	False
variation_group_id	int	False
variation_option_list	object[]	False
variation_option_id	int	False
variation_option_name	string	False
image_id	string	False

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string		Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
message	string		Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
warning	string		Thông báo cảnh báo.
request_id	string	369c79e9a42147f6912e2bf21c96ba23	Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.
response	object
publish_task_id	int64	202011300000012008	ID của tác vụ đăng bán.

, "category_id": 7535, "standardise_tier_variation": [ { "variation_id": 0, "variation_name": "Size", "variation_option_list": [ { "image_id": "br-11134207-7r98o-m8s1833s61he9a", "image_url": "https://cf.shopee.com.br/file/br-11134207-7r98o-m8s1833s61he9a", "variation_option_id": 0, "variation_option_name": "S" }, { "image_id": "br-11134207-7r98o-m8s1833s7g1u9a", "image_url": "https://cf.shopee.com.br/file/br-11134207-7r98o-m8s1833s7g1u9a", "variation_option_id": 0, "variation_option_name": "M" } ] } ], "model": [ { "tier_index": [ 0, 0 ], "original_price": 100.5 }, { "tier_index": [ 0, 1 ], "original_price": 101.5 }, { "tier_index": [ 1, 0 ], "original_price": 110.5 }, { "tier_index": [ 1, 1 ], "original_price": 120.5 } ], "size_chart": "591ab15ea954b9879374765854595600", "logistic": [ { "logistic_id": 1001, "enabled": true, "shipping_fee": 10, "size_id": 10, "is_free": false } ], "pre_order": { "is_pre_order": true, "days_to_ship": 3 }, "description_info": { "extended_description": { "field_list": [ { "field_type": "text", "text": "text description 1" }, { "field_type": "image", "image_info": { "image_id": "1e076dff0699d8e778c06dd6c02df1fe" } }, { "field_type": "image", "image_info": { "image_id": "c07ac95ba7bb624d731e37fe2f0349de" } }, { "field_type": "text", "text": "text description 1" } ] } } } }