v2.shop_flash_sale.update_shop_flash_sale_items
POST /api/v2/shop_flash_sale/update_shop_flash_sale_items
Chỉnh sửa sản phẩm trong flash sale shop, chỉ có thể chỉnh sửa các phân loại ở trạng thái tắt hoặc bật
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/shop_flash_sale/update_shop_flash_sale_items
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Mã đối tác được cấp khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dấu thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token dùng để truy cập API, xác định quyền truy cập của bạn. Có thể dùng nhiều lần, hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của shop trên Shopee. Bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán 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ả |
|---|---|---|---|---|
| flash_sale_id | int64 | True | ||
| items | object[] | True | ||
| item_id | int64 | True | ||
| purchase_limit | int32 | False | min=0, 0 nghĩa là không giới hạn. Nếu sản phẩm đang bật hoặc có phân loại đang bật, không thể đặt trường này | |
| models | object[] | False | Nếu sản phẩm có phân loại, tham số này là bắt buộc, ngược lại không dùng trường này | |
| model_id | int64 | True | Nếu sản phẩm có phân loại, tham số này là bắt buộc. | |
| status | int32 | True | Dùng để đặt trạng thái phân loại: 0: tắt 1: bật | |
| input_promo_price | float | False | Giá khuyến mãi chưa bao gồm thuế. Nếu phân loại đang bật (status=1), không thể đặt trường này. Nếu phân loại đang tắt (status=0) và muốn đặt trường này, phải đặt status thành 1 | |
| stock | int32 | False | min=1, Tồn kho chiến dịch, chỉ có thể đặt từ tồn kho Shopee hoặc tồn kho người bán. Nếu phân loại đang bật (status=1), không thể đặt trường này. Nếu phân loại đang tắt (status=0) và muốn đặt trường này, phải đặt status thành 1 | |
| item_status | int32 | False | Trạng thái sản phẩm. Nếu sản phẩm không có phân loại, tham số này là bắt buộc, ngược lại không dùng trường này: 0: tắt 1: bật | |
| item_input_promo_price | float | False | Giá khuyến mãi của sản phẩm. Nếu sản phẩm không có phân loại, dùng trường này để cập nhật giá khuyến mãi, ngược lại không dùng. Nếu sản phẩm đang bật (item_status=1), không thể đặt trường này. Nếu sản phẩm đang tắt (item_status=0) và muốn đặt trường này, phải đặt item_status thành 1 | |
| item_stock | int32 | False | min=1, Tồn kho chiến dịch của sản phẩm. Nếu sản phẩm không có phân loại, dùng trường này để cập nhật tồn kho chiến dịch, ngược lại không dùng. Nếu sản phẩm đang bật (item_status=1), không thể đặt trường này. Nếu sản phẩm đang tắt (item_status=0) và muốn đặt trường này, phải đặt item_status thành 1 |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | Mã định danh yêu cầu API dùng để theo dõi lỗi | |
| error | string | Tên lỗi xảy ra trong yêu cầu. Trống nếu yêu cầu thành công. | |
| message | string | Mô tả chi tiết lỗi. Trống nếu yêu cầu thành công. | |
| response | object | ||
| failed_items | object[] | ||
| item_id | int64 | ||
| model_id | int64 | Nếu sản phẩm không có phân loại, trường này sẽ trống | |
| err_code | int32 | ||
| err_msg | string | Lý do tại sao phân loại không thể được thêm | |
| unqualified_conditions | object[] | Nếu phân loại không đáp ứng tiêu chí, chi tiết sẽ hiển thị ở trường này | |
| unqualified_code | int32 | ||
| unqualified_msg | string |
Không có Ví dụ Yêu cầu.