v2.global_product.get_global_item_info

GET /api/v2/global_product/get_global_item_info

Lấy thông tin 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/get_global_item_info

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_list	int64	True		Danh sách ID sản phẩm toàn cầu. Giới hạn độ dài từ [1, 20].

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	6f235f4a343e4feb8a9ed74c439f6663	Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.
response	object
global_item_list	object[]
global_item_id	int64	27001415	Mã định danh duy nhất của Shopee cho một sản phẩm toàn cầu.
global_item_name	string	MY OLD NEW two tier model item 5	Tên của sản phẩm toàn cầu.
description	string	MY OLD NEW default no model itemMY OLD NEW default no model itemMY OLD NEW default no model item	Mô tả của sản phẩm toàn cầu.
global_item_sku	string	sku1	SKU sản phẩm toàn cầu (đơn vị lưu kho) là mã định danh do người bán tự định nghĩa, đôi khi còn gọi là SKU cha. SKU sản phẩm có thể được gán cho một sản phẩm trong danh sách Shopee.
global_item_status	string	NORMAL	Trạng thái hiện tại của sản phẩm. Chỉ có thể truy vấn sản phẩm toàn cầu có trạng thái NORMAL, nếu không API sẽ trả lỗi.
create_time	timestamp	1605247451	Thời điểm tạo sản phẩm toàn cầu.
update_time	timestamp	1605247451	Thời điểm cập nhật gần nhất của sản phẩm toàn cầu.
stock_info	object[]		Nếu sản phẩm có model, trường này sẽ không được trả về. Vui lòng lấy thông tin qua API get_model_list.
stock_type	int32	2	Kiểu tồn kho.
stock_location_id	string	KRZ	ID vị trí của tồn kho.
normal_stock	int32	44	Số lượng tồn kho thông thường của biến thể theo đơn vị tiền tệ niêm yết.
reserved_stock	int32	0	Số lượng tồn kho đã đặt trước của biến thể theo đơn vị tiền tệ niêm yết.
price_info	object[]		Nếu sản phẩm có model, price_info sẽ không được trả về. Vui lòng lấy giá của từng model qua API get_global_model_list.
currency	string	CNY	Mã ba chữ số đại diện cho đơn vị tiền tệ dùng cho sản phẩm trong danh sách Shopee.
original_price	float	100.1	Giá gốc của sản phẩm theo đơn vị tiền tệ niêm yết.
sip_item_price	float	11.11	Giá SIP của sản phẩm.
sip_item_price_source	string	auto	Nguồn giá SIP (auto hoặc manual).
image	object
image_id_list	string[]	["bf5a022e4624ff6c01ef151001762db7", "1a689fb0124a6d8762761f3ae13815ed"]	Danh sách URL hình ảnh.
image_url_list	string[]	["https://s-cf-tw.shopeesz.com/file/bf5a022e4624ff6c01ef151001762db7", "https://s-cf-tw.shopeesz.com/file/1a689fb0124a6d8762761f3ae13815ed"]	Danh sách ID hình ảnh.
weight	string	"1.1"	Trọng lượng của sản phẩm toàn cầu này, đơn vị là KG. Nếu đã thiết lập trọng lượng cho model toàn cầu thuộc sản phẩm này, trong thời gian chuyển đổi sẽ trả về trọng lượng lớn nhất của tất cả model để đảm bảo tương thích hệ thống. Vui lòng chuyển sang gọi v2.global_product.get_global_model_list để lấy trọng lượng model.
dimension	object		Kích thước của sản phẩm toàn cầu này. Nếu đã thiết lập kích thước cho model toàn cầu thuộc sản phẩm này, trong thời gian chuyển đổi sẽ trả về kích thước có thể tích lớn nhất (tính theo chiều cao × chiều dài × chiều rộng). Vui lòng chuyển sang gọi v2.global_product.get_global_model_list để lấy kích thước model.
package_length	int32	11	Chiều dài gói hàng, đơn vị là CM.
package_width	int32	11	Chiều rộng gói hàng, đơn vị là CM.
package_height	int32	11	Chiều cao gói hàng, đơn vị là CM.
pre_order	object		Nếu đã thiết lập DTS cho model toàn cầu thuộc sản phẩm này, trong thời gian chuyển đổi sẽ trả về DTS lớn nhất của tất cả model. Vui lòng chuyển sang gọi v2.global_product.get_global_model_list để lấy DTS model.
days_to_ship	int32	3	Số ngày chuẩn bị hàng.
size_chart	string	1a689fb0124a6d8762761f3ae13815ed	URL hình ảnh bảng kích thước.
condition	string	NEW	Hàng cũ hay hàng mới.
has_model	boolean	true	Sản phẩm có chứa model hay không.
video	object
video_url	string	1a689fb0124a6d8762761f3ae13815ed	URL video.
thumbnail_url	string	7432bfa3713715bc1f88f4025241eb6d	Ảnh thumbnail của video.
duration	int32	100	Thời lượng video.
category_id	int32	2347462	Mã định danh duy nhất của Shopee cho một danh mục.
brand	object
brand_id	int32	6238	ID của thương hiệu.
original_brand_name	string	Nike	Tên gốc của thương hiệu.
attribute_list	object[]
attribute_id	int32	4811	Mã định danh của từng danh mục.
original_attribute_name	string	Brand: L2 Default [14644]	Tên của từng thuộc tính.
attribute_value_list	object[]
value_id	int32	1047251	Mã định danh duy nhất cho giá trị của thuộc tính sản phẩm này.
original_value_name	string	10	Tên giá trị của thuộc tính sản phẩm này.
value_unit	string	kg	Đơn vị giá trị của thuộc tính sản phẩm này.
description_info	object		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.
extended_description	object		Nếu description_type là extended, thông tin mô tả sẽ được trả về qua trường này.
field_list	object[]		Danh sách trường của mô tả mở rộng.
field_type	string		Kiểu trường mô tả mở rộng: xem Định nghĩa dữ liệu - description_field_type (text, image).
text	string		Nếu field_type là text, thông tin văn bản sẽ được trả về qua trường này.
image_info	object		Nếu field_type là image, URL hình ảnh sẽ được trả về qua trường này.
image_id	string		ID hình ảnh.
image_url	string		URL hình ảnh.
description_type	object		Kiểu mô tả: xem Định nghĩa dữ liệu - description_type (normal, extended).
is_fulfillment_by_shopee	boolean		Sản phẩm có được thực hiện bởi Shopee hay không.
size_chart_id	int64		ID mẫu bảng kích thước.