v2.global_product.get_global_model_list

GET /api/v2/global_product/get_global_model_list

Lấy danh sách model 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_model_list

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	28001461	ID của sản phẩm toàn cầu.

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
tier_variation	object[]		Thông tin tier variation của sản phẩm toàn cầu.
name	string	tier name 1	Tên tier.
option_list	object[]		Danh sách tùy chọn tier tương ứng với tên tier.
option	string	tier option 1	Tùy chọn tier.
image	object		Thông tin hình ảnh của tier.
image_url	string	https://cf.shopee.sg/file/c54265d475b85e00ffb2404585e32b6f	URL hình ảnh.
image_id	string	c54265d475b85e00ffb2404585e32b6f	ID hình ảnh.
global_model	object[]		Các model toàn cầu.
global_model_id	int64	20004490	ID của model toàn cầu.
global_model_sku	string	model sku	SKU của model toàn cầu.
price_info	object		Thông tin giá của model toàn cầu.
original_price	float	100.5	Giá gốc của model toàn cầu.
stock_info	object[]		Thông tin tồn kho của model toàn cầu.
stock_type	int32	1	Kiểu tồn kho. "1" là tồn kho WMS, "2" là tồn kho người bán.
stock_location_id	string	1020	ID vị trí tồn kho.
current_stock	int32	10	Tồn kho hiện tại.
normal_stock	int32	10	Tồn kho thông thường.
reserved_stock	int32	10	Tồn kho đã đặt trước.
tier_index	int32[]	[0, 1]	Chỉ số cấp của model toàn cầu.
weight	string	"1.1"	Trọng lượng của model toàn cầu này, đơn vị là KG. Nếu không thiết lập trọng lượng cho model, mặc định sẽ dùng trọng lượng của sản phẩm toàn cầu.
dimension	object		Kích thước của model toàn cầu này. Nếu không thiết lập kích thước cho model, mặc định sẽ dùng kích thước của sản phẩm toàn cầu.
package_height	int32	11	Chiều cao gói hàng, đơn vị là CM.
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.
pre_order	object		Thông tin đặt hàng trước của model toàn cầu này. Lưu ý: Nếu không thiết lập DTS cho model, mặc định sẽ dùng DTS của sản phẩm toàn cầu.
days_to_ship	int32	2	Số ngày chuẩn bị hàng.
is_fulfillment_by_shopee	boolean		Đây có phải là model FBS (Fulfillment by Shopee) không.
standardise_tier_variation	object[]		Thông tin tier variation chuẩn hóa của sản phẩm toàn cầu.
variation_id	int32		ID tier variation chuẩn hóa.
variation_name	string		Tên tier variation chuẩn hóa.
variation_group_id	int32		ID nhóm tier variation chuẩn hóa.
variation_option_list	object[]		Danh sách tùy chọn tier variation chuẩn hóa.
variation_option_id	int32		ID tùy chọn tier variation chuẩn hóa.
variation_option_name	string		Tên tùy chọn tier variation chuẩn hóa.
image_id	string		ID hình ảnh.
image_url	string		URL hình ảnh.