v2.global_product.add_global_model
POST /api/v2/global_product/add_global_model
Thêm 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/add_global_model
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 | 37001402 | ID của sản phẩm toàn cầu. |
| global_model | object[] | True | Danh sách thiết lập model toàn cầu. Giới hạn từ [1, 50]. | |
| 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 | [1] | Chỉ số cấp của model toàn cầu. |
| seller_stock | object[] | False | Tồn kho của người bán cho sản phẩm toàn cầu. | |
| location_id | string | False | CNZ | ID vị trí của 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 của merchant. 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 | int32 | True | 100 | Tồn kho. |
| original_price | float | True | 123.21 | Giá gốc của sản phẩm toàn cầu. |
| 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 trọng lượng cho model toàn cầu này, mặc định sẽ dùng trọng lượng của sản phẩm toàn cầu. Nếu thiết lập kích thước cho model toàn cầu này, bắt buộc phải thiết lập trọng lượng. |
| dimension | object | False | 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 toàn cầu này, mặc định sẽ dùng kích thước của sản phẩm toàn cầu. | |
| package_height | int32 | True | 11 | Chiều cao gói hàng của model toàn cầu này, đơn vị là CM. |
| package_length | int32 | True | 11 | Chiều dài gói hàng của model toàn cầu này, đơn vị là CM. |
| package_width | int32 | True | 11 | Chiều rộng gói hàng của model toàn cầu này, đơ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 toàn cầu này, mặc định sẽ 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. |
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. |
], "original_price":99.9 } ] }