PUT Update Activity
Cập nhật Hoạt động Shop Scope yêu cầu: seller.promotion.write Thay đổi tiêu đề và thời gian bắt đầu, kết thúc của hoạt động khuyến mãi giảm giá sản phẩm hoặc flash sale hiện có. Phiên bản 202309
PUT/promotion/202309/activities/{activity_id}
Request
Path
| Properties | Type | Description |
|---|---|---|
| activity_id Required | string | ID hoạt động |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| title Required | string | Tên hoạt động (tối đa 50 ký tự). Tên phải là duy nhất. |
| duration_type | string | Loại thời gian hiệu lực của hoạt động hiện tại- NORMAL: begin_time và end_time phải được điền- INDEFINITE: begin_time và end_time không bắt buộc, và khuyến mãi sẽ là hoạt động dài hạn chạy vô thời hạn. 1. INDEFINITE chỉ có hiệu lực khi activity_type là SHIPPING_DISCOUNT,2. Nếu duration_type là INDEFINITE, start_time và end_time phải là 0Default: NORMAL |
| begin_time Required | int | Thời gian bắt đầu hoạt động. UNIX timestamp. Giá trị phải lớn hơn giá trị của thời gian hiện tại. |
| end_time Required | int | Thời gian kết thúc hoạt động. UNIX timestamp. |
| product_level | string | Chiều sản phẩm của hoạt động, các giá trị là:- PRODUCT: Hoạt động khuyến mãi áp dụng ở cấp sản phẩm (SPU). Bất kỳ và tất cả SKU thuộc sản phẩm này sẽ chịu khuyến mãi.- VARIATION: Hoạt động khuyến mãi chỉ áp dụng cho các SKU được chỉ định.- SHOP: Hoạt động khuyến mãi áp dụng cho tất cả sản phẩm trong shop. |
| participation_limit | []object | Số lần một người mua có thể tham gia khuyến mãi. |
| discount | object | Thông tin giảm giá. |
| target_user_info | object | Loại người dùng được nhắm đến của khuyến mãi. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong response API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 17003203 | A storewide free shipping promotion activity is already active. Only one can be created at a time. | | 17029001 | Invalid parameters | | 17029002 | Title Length Too Long | | 17029003 | The activity title is empty. | | 17029004 | Duplicate activity title. | | 17029005 | Begin Time Earlier Than Now | | 17029006 | The activity period is too short. | | 17029007 | The activity period is too long. | | 17029008 | FlashSale Period Too Long | | 17029009 | Activity does not exist | | 17029010 | Activity is deactivated | | 17029011 | Not allowed to update the beginning time of activity | | 17029012 | Not allowed to update expired activities | | 17029022 | The product or SKU cannot be in two ONGOING or NOT_START activities at the same time. | | 17029026 | Invalid SellerID | | 17029028 | You are specifying activities not in your shop. | | 17029052 | ProductType is not supported | | 17029070 | Empty gift sku info. | | 17029071 | Gift sku id is invalid, not an integer. | | 17029072 | Gift sku repeated | | 17029073 | Price of the gift exceeds the upper limit | | 17029074 | Eligible products and the gift products must not be the same product. | | 17029075 | Number of gifts per tier does not meet the limit | | 17029076 | Gift sku is out of stock. | | 17029077 | Gifts across different tiers are repeated | | 17029078 | Number of gift tiers does not meet the requirement | | 17029082 | Specified time is outside of the defined range for this activity. Please check the time range for the activity and try again. | | 17029083 | The claim limit quantity of gift can not be decreased | | 17029084 | The threshold type of gift can not be modified | | 17029085 | The number of gift tiers can not be changed | | 17029102 | Product level and shop level are not interchangeable | | 17029103 | Partial of products have already been applied to another conflict promotion during the selected period. | | 17029104 | The product(s) selected have already been applied to another buy more save more promotion during the selected period. To proceed, edit the product list or change the promotion period. | | 17029105 | The threshold type and discount type can not be modified. | | 17029106 | Participation Limit info cannot change or modify. | | 17029107 | Due to overlapping with other activities, sellers cannot create shop-scope BMSM activity. | | 17029109 | The promotion exceeds the threshold. | | 17029110 | The discount value is below the minimum threshold. | | 17029111 | The threshold value is invalid. | | 17029112 | The discount value is invalid. | | 17029113 | The number of products will exceed the maximum number of the promotion. | | 17029114 | The promotion type is not supported. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext