v2.global_product.update_global_item

POST /api/v2/global_product/update_global_item

Cập nhật 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/update_global_item

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	100369	ID của sản phẩm toàn cầu.
category_id	int32	False	7535	ID danh mục của sản phẩm toàn cầu.
global_item_name	string	False	item name	Tên sản phẩm toàn cầu.
description	string	False	item description	Mô tả sản phẩm toàn cầu.
global_item_sku	string	False	item sku	SKU của sản phẩm toàn cầu.
weight	float	False	100.5	Trọng lượng của sản phẩm toàn cầu này, đơn vị là KG. Cập nhật trọng lượng sản phẩm toàn cầu sẽ ghi đè trọng lượng của tất cả global model thuộc sản phẩm này.
dimension	object	False		Kích thước của sản phẩm toàn cầu này. Cập nhật kích thước sẽ ghi đè kích thước của tất cả global model thuộc sản phẩm này.
package_length	int32	False	11	Chiều dài gói hàng, đơn vị là CM.
package_width	int32	False	11	Chiều rộng gói hàng, đơn vị là CM.
package_height	int32	False	11	Chiều cao gói hàng, đơn vị là CM.
pre_order	object	False		Thông tin đặt hàng trước của sản phẩm toàn cầu. Cập nhật DTS của sản phẩm toàn cầu sẽ ghi đè DTS của tất cả global model thuộc sản phẩm này.
days_to_ship	int32	True	3	Số ngày chuẩn bị hàng.
condition	string	False	NEW	Tình trạng sản phẩm toàn cầu, có thể là "NEW" hoặc "USED".
image	object	False		Thông tin hình ảnh của sản phẩm toàn cầu.
image_id_list	string[]	True	["c54265d475b85e00ffb2404585e32b6f", "6fb33d484f232510b5f9b169f2758322"]	Danh sách ID hình ảnh của sản phẩm toàn cầu.
video_upload_id	string[]	False	["591ab15ea954b9879374765854595600"]	ID upload video của sản phẩm toàn cầu.
brand	object	False
brand_id	int32	False	1078	ID thương hiệu.
attribute_list	object[]	False		Thuộc tính sản phẩm.
attribute_id	int32	False	1007105	ID thuộc tính.
attribute_value_list	object[]	False
value_id	int32	False	38173	ID giá trị thuộc tính. Trong các trường hợp sau, value_id cần được tải lên là 0, và original_value_name là bắt buộc, cần điền giá trị tùy chỉnh: (1) AttributeInputType là TEXT_FILED; (2) AttributeInputType là COMBO_BOX hoặc MULTIPLE_SELECT_COMBO_BOX và người bán muốn điền giá trị tùy chỉnh.
original_value_name	string	False	Red	Tên giá trị thuộc tính từ API global_product.get_attributes. Bắt buộc nếu value_id = 0. Nếu AttributeType là DATE_TYPE hoặc TIMESTAMP_TYPE, có thể tải lên timestamp (kiểu string) làm original_value_name.
value_unit	string	False	Kg	Đơn vị giá trị thuộc tính (chỉ dành cho thuộc tính định lượng).
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ể dùng. Nếu dùng trường này, phải tải lên description_type=extended, nếu không API sẽ trả về lỗi. Nếu không dùng trường này, không cần tải lên description_type hoặc tải lên description_type=normal.
extended_description	object	False		Nếu description_type là extended, thông tin mô tả phải được thiết lập qua trường này.
field_list	object[]	False		Danh sách trường trong 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 được thiết lập qua trường này.
image_info	object	False		Nếu field_type là image, URL hình ảnh được thiết lập qua trường này.
image_id	string	False		ID hình ảnh.
description_type	string	False		Các giá trị: xem Định nghĩa dữ liệu - description_type (normal, extended). Nếu muốn dùng extended_description hoặc thay đổi loại mô tả, trường này phải được nhập.
size_chart_info	object	False
size_chart	string	False		ID hình ảnh bảng size. Nếu muốn xóa hình ảnh bảng size của sản phẩm, truyền "size_chart" rỗng. Chỉ cần điền một trong hình ảnh hoặc template. Nếu điền cả hai, chỉ template được giữ lại. Lưu ý: Cả cửa hàng CB và nội địa đều hỗ trợ thiết lập "size_chart".
size_chart_id	int64	False		ID template bảng size. Nếu muốn xóa template bảng size của sản phẩm, truyền "size_chart_id" là 0. Chỉ cần điền một trong hình ảnh hoặc template. Nếu điền cả hai, chỉ template được giữ lại. Lưu ý: Cả cửa hàng nội địa và CB đều hỗ trợ thiết lập "size_chart_id" và người bán cần thiết lập template bảng size trong CBSC trước.

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	98eae35efff24dd0974c21a847127184	Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.
response	object
global_item_id	int64	100369	ID sản phẩm toàn cầu đã cập nhật.

, "pre_order": { "days_to_ship": 2 }, "condition": "NEW", "image": { "image_id_list": [ "c54265d475b85e00ffb2404585e32b6f", "6fb33d484f232510b5f9b169f2758322" ] }, "video_upload_id": [ "591ab15ea954b9879374765854595600" ], "attribute_list": [{ "attribute_id": 5357, "attribute_value_list": [ { "value_id":0, "original_value_name":"red", "value_unit":"kg" } ] }], "brand":{ "brand_id":123 }, "description_type":"extended", "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" } ] } } }