v2.shop_flash_sale.update_shop_flash_sale_items
POST /api/v2/shop_flash_sale/update_shop_flash_sale_items
edit shop flash sale item, you can only edit the models in disbaled or enabled status
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/shop_flash_sale/update_shop_flash_sale_items
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Request Parameters
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| flash_sale_id | int64 | True | ||
| items | object[] | True | ||
| item_id | int64 | True | ||
| purchase_limit | int32 | False | min=0, 0 means no limit if the item is in enabled status or the item has models in enabled status, you can't set this field | |
| models | object[] | False | If the item has variation, this param is necessary, otherwise please don't use this field | |
| model_id | int64 | True | If the item has variation, this param is necessary. | |
| status | int32 | True | you can use this field to set the status of model 0: disable 1: enable | |
| input_promo_price | float | False | promotion price without tax if the model is enabled(status = 1) now, you can't set this field, you can only disable the model if the model is disabled(status = 0) now and you want to set this field, you should also set status to 1 | |
| stock | int32 | False | min=1, Campaign Stock, Campaign stock can only be reserved from either Shopee stock or Seller stock if the model is enabled(status = 1) now, you can't set this field, you can only disable the model if the model is disabled(status = 0) now and you want to set this field, you should also set status to 1 | |
| item_status | int32 | False | The status of the item. If the item has no variation, this param is necessary, otherwise don't use this field you can use this field to set the status of item 0: disable 1: enable | |
| item_input_promo_price | float | False | The promotion price of the item. If the item has no variation, you can use this field to update the promotion price of the item, otherwise don't use this field if the item is enabled(item_status = 1) now, you can't set this field, you can only disable the item if the item is disabled(item_status = 0) now and you want to set this field, you should also set item_status to 1 | |
| item_stock | int32 | False | min=1, The campaign stock of the item. If the item has no variation, you can use this field to update the campaign stock of the item, otherwise don't use this field if the item is enabled(item_status = 1) now, you can't set this field, you can only disable the item if the item is disabled(item_status = 0) now and you want to set this field, you should also set item_status to 1 |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| request_id | string | The identifier for an API request for error tracking. | |
| error | string | Indicate error type if hit error. Empty if no error happened. | |
| message | string | Indicate error details if hit error. Empty if no error happened. | |
| response | object | ||
| failed_items | object[] | ||
| item_id | int64 | ||
| model_id | int64 | If the item has no variation, this field will be empty | |
| err_code | int32 | ||
| err_msg | string | the reason why the model cannot be added | |
| unqualified_conditions | object[] | if the model doesn't meet a criteria, will show the detail in this field | |
| unqualified_code | int32 | ||
| unqualified_msg | string |
No Request Example Set.