v2.global_product.init_tier_variation

POST /api/v2/global_product/init_tier_variation

Chỉ dành cho người bán Trung Quốc đại lục và người bán Hàn Quốc. Nếu chỉ định nghĩa màu sắc, đó là một tier; nếu định nghĩa màu sắc và kích thước, đó là hai tier. Hỗ trợ tối đa cấu trúc hai tier. API này có thể chuyển đổi từ không có tier sang một tier, không có tier sang hai tier, một tier sang hai tier, hai tier sang một tier, một tier sang không có tier, hai tier sang không có tier. Vui lòng tạo variation sau khoảng 5 giây kể từ khi tạo sản phẩm, vì có thể có độ trễ.

Đường dẫn Endpoint

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

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_model	object[]	True		Danh sách thông tin model, tối đa 50 model.
original_price	float	True	12.34	Giá gốc của model toàn cầu.
seller_stock	object[]	False		Tồn kho người bán của sản phẩm toàn cầu.
location_id	string	False	CNZ	ID vị trí tồn kho. Nếu merchant có cửa hàng 3PF, location_id không được để trống. Có thể dùng API get_merchant_warehouse_location_list để lấy danh sách location_id. Nếu merchant không có cửa hàng 3PF (chỉ có cửa hàng CBSC thông thường), location_id có thể để trống.
stock	int64	True	100	Tồn kho.
global_model_sku	string	False	sku	SKU của model toàn cầu. Độ dài model_sku không được vượt quá 100 ký tự.
tier_index	int32[]	True	[0,1]	Chỉ số tier của model toàn cầu, bắt đầu từ 0. Nếu muốn cập nhật từ một hoặc hai tier sang không có tier, truyền tier_variation và standardise_tier_variation là [], và truyền global_model >> tier_index là [], đồng thời truyền original_price, seller_stock, v.v. để thiết lập giá và tồn kho cho sản phẩm không có cấu trúc tier.
weight	float	False	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, mặc định dùng trọng lượng sản phẩm toàn cầu. Nếu thiết lập kích thước cho model này, phải thiết lập trọng lượng cho model này.
dimension	object	False		Kích thước của model toàn cầu này. Nếu không thiết lập, mặc định dùng kích thước sản phẩm toàn cầu.
package_height	int32	True	11	Chiều cao gói hàng, đơn vị là CM.
package_length	int32	True	11	Chiều dài gói hàng, đơn vị là CM.
package_width	int32	True	11	Chiều rộng gói hàng, đơn vị là CM.
pre_order	object	False		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 dùng DTS của sản phẩm toàn cầu.
days_to_ship	int32	True	2	Số ngày chuẩn bị hàng. Vui lòng lấy phạm vi days_to_ship từ API get_dts_limit.
global_item_id	int32	True	22001469	ID của sản phẩm toàn cầu.
standardise_tier_variation	object[]	False		Phải có ít nhất một trong standardise_tier_variation và tier_variation. Nếu muốn cập nhật từ một hoặc hai tier sang không có tier, truyền tier_variation và standardise_tier_variation là [].
variation_id	int32	True		ID tier variation chuẩn hóa.
variation_name	string	False		Tên tier variation chuẩn hóa.
variation_group_id	int32	False		ID nhóm tier variation chuẩn hóa.
variation_option_list	object[]	True		Danh sách tùy chọn tier variation chuẩn hóa.
variation_option_id	int32	True		ID tùy chọn tier variation chuẩn hóa.
variation_option_name	string	False		Giá trị tùy chọn tier variation chuẩn hóa.
image_id	string	False		ID hình ảnh tùy chọn tier variation chuẩn hóa.

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.