v2.global_product.add_global_item
POST /api/v2/global_product/add_global_item
Thêm sản phẩm toàn cầu. Chỉ dành cho người bán Trung Quốc đại lục sử dụng China Seller Centre (CNSC). Chi tiết tại https://shopee.cn/cooperate/46/53/926.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/global_product/add_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ả |
|---|---|---|---|---|
| category_id | int64 | True | 14695 | ID danh mục của sản phẩm toàn cầu. |
| global_item_name | string | True | item name sample | Tên của sản phẩm toàn cầu. |
| description | string | True | item description sample | Mô tả của sản phẩm toàn cầu. |
| global_item_sku | string | False | item sku sample | SKU của sản phẩm toàn cầu. |
| 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. |
| original_price | float | True | 95.5 | Giá gốc của sản phẩm toàn cầu. |
| normal_stock | int64 | False | 100 | Tồn kho thông thường của sản phẩm toàn cầu. |
| weight | float | True | 100.5 | Trọng lượng của sản phẩm toàn cầu. |
| dimension | object | False | Thông tin kích thước của sản phẩm toàn cầu. | |
| package_length | int64 | True | 11 | Chiều dài gói hàng của sản phẩm toàn cầu. |
| package_width | int64 | True | 11 | Chiều rộng gói hàng của sản phẩm toàn cầu. |
| package_height | int64 | True | 11 | Chiều cao gói hàng của sản phẩm toàn cầu. |
| pre_order | object | True | Thông tin đặt hàng trước của sản phẩm toàn cầu. | |
| days_to_ship | int64 | 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". |
| video_upload_id | string[] | False | ["00a2258551b5a2f0a7c283f877330f93"] | ID video đã tải lên của sản phẩm toàn cầu. Chỉ chấp nhận tối đa một video_upload_id. |
| brand | object | False | ||
| brand_id | int64 | False | 1078 | ID của thương hiệu. |
| original_brand_name | string | False | Nike | Tên gốc của thương hiệu. |
| attribute_list | object[] | False | Thuộc tính sản phẩm. | |
| attribute_id | int64 | False | 1007105 | ID của thuộc tính. |
| attribute_value_list | object[] | False | ||
| value_id | int64 | False | 38173 | ID của 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 của giá trị thuộc tính. original_value_name lấy từ API global_product.get_attributes. Nếu value_id=0, trường này là bắt buộc. Nếu AttributeType là DATE_TYPE hoặc TIMESTAMP_TYPE, bạn có thể tải lên timestamp (kiểu string) làm original_value_name. |
| value_unit | string | False | kg | Đơn vị của giá trị thuộc tính (chỉ áp dụng 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ể 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. 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ả cần được thiết lập bằng trường này. | |
| field_list | object[] | False | Danh sách trường của 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 sẽ được thiết lập bằng trường này. | |
| image_info | object | False | Nếu field_type là image, URL hình ảnh sẽ được thiết lập bằng trường này. | |
| image_id | string | False | ID hình ảnh. | |
| description_type | string | False | Giá trị: xem Định nghĩa dữ liệu - description_type (normal, extended). Nếu muốn sử dụng extended_description, trường này phải được điền. | |
| 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. |
| stock | int32 | True | 100 | Tồn kho. |
| ds_cat_rcmd_id | string | False | ID dịch vụ gợi ý danh mục. | |
| size_chart_info | object | False | ||
| size_chart | string | False | ID hình ảnh bảng kích thước. Nếu muốn xóa hình ảnh bảng kích thước của sản phẩm, hãy truyền "size_chart" rỗng. Chỉ cần điền một trong hai: hình ảnh hoặc mẫu. Nếu cả hai đều được điền, chỉ mẫu sẽ được giữ lại. Lưu ý: Cả cửa hàng CB và cửa hàng nội địa đều hỗ trợ thiết lập "size_chart". | |
| size_chart_id | int64 | False | ID mẫu bảng kích thước. Nếu muốn xóa mẫu bảng kích thước của sản phẩm, hãy truyền "size_chart_id" là 0. Chỉ cần điền một trong hai: hình ảnh hoặc mẫu. Nếu cả hai đều được điền, chỉ mẫu sẽ được giữ lại. Lưu ý: Cả cửa hàng nội địa và cửa hàng CB đều hỗ trợ thiết lập "size_chart_id" và người bán cần thiết lập mẫu size_chart 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 | 1007962 | ID của sản phẩm toàn cầu vừa thêm. |
}, "brand":{ "brand_id":1078, "original_brand_name":"Nike" }, "category_id":14695, "condition":"NEW", "description":"item description sample", "description_info":{ "extended_description":{ "field_list":{ "field_type":"", "image_info":{ "image_id":"" }, "text":"" } } }, "description_type":"", "dimension":{ "package_height":11, "package_length":12, "package_width":13 }, "global_item_name":"item name sample", "global_item_sku":"item sku sample", "image":{ "image_id_list":"["c54265d475b85e00ffb2404585e32b6f", "6fb33d484f232510b5f9b169f2758322"]" }, "normal_stock":100, "original_price":95.5, "pre_order":{ "days_to_ship":3 }, "video_upload_id":"["00a2258551b5a2f0a7c283f877330f93"]", "weight":100.5, "seller_stock":[ { "location_id":"CNZ", "stock":100 } ] }
No Response Example Set.