---
title: "Update promotion product"
method: PUT
path: "/shops/{SHOP_ID}/promotion_advance/{PROMOTION_ID}"
tags: ["Promotion"]
---

# Update promotion product

`PUT /shops/{SHOP_ID}/promotion_advance/{PROMOTION_ID}`

## Request

- Base URL: `https://pos.pages.fm/api/v1`
- URL: `https://pos.pages.fm/api/v1/shops/{SHOP_ID}/promotion_advance/{PROMOTION_ID}`
- Auth: API key in query parameter `api_key`

Update promotion

## Path parameters

- `SHOP_ID` integer, required
- `PROMOTION_ID` string, required

## Request body

- object
  - `promotion_advance` Promotion, required: Promotion information
    - `id` string: Promotion ID
    - `display_id` string: Promotion display ID
    - `name` string: Promotion name
    - `type` string: Promotion type
    - `start_time` string, date-time: Start time
    - `end_time` string, date-time: End time
    - `warehouse_ids` string[]: Warehouse IDs
    - `customer_tags` string[]: Customer tags
    - `order_sources` object[]: Order sources
    - `group_name` string: Promotion group
    - `is_activated` boolean: Is activated
    - `is_variation` boolean: Is variation
    - `is_used` boolean: Is used
    - `is_free_shipping` boolean: Is free shipping
    - `is_discount_in_birthday_customer` boolean: Is discount in birthday customer
    - `coupon_info` object: Coupon information
      - `discount` integer: Discount
      - `is_percent` boolean: Is percent
    - `promo_code_info` object: Promotion code information
      - `discount` integer: Discount
      - `is_percent` boolean: Is percent
      - `max_discount_by_percent` integer: Maximum discount by percent
    - `discount_by_quantity` integer: Discount by quantity
    - `items` object[]: List of promotion items (products/variations the promotion applies to)
      - `id` string: Promotion item ID
      - `promotion_advance_id` string: Promotion ID
      - `shop_id` integer: Shop ID
      - `product_id` string, nullable: Product ID (when promotion is applied by product)
      - `variation_id` string, nullable: Variation ID (when promotion is applied by variation)
      - `category_id` string, nullable: Category ID (when promotion is applied by category)
      - `product` object, nullable: Product information (when promotion is applied by product)
      - `variation` object, nullable: Variation information (when promotion is applied by variation)
      - `level_info` object[]: Discount levels by quantity
        - `discount` number: Discount value
        - `is_percent` boolean: Is percent
        - `from_quantity` integer: From quantity
        - `to_quantity` integer: To quantity
      - `fixed_prices` number: Fixed price
      - `coupon_item_info` object: Coupon information of the item
        - `discount` number: Discount
        - `is_percent` boolean: Is percent
      - `limited_quantity` integer: Limited quantity
      - `limited_quantity_used` integer: Limited quantity used
      - `attachment_product_info` object[]: Attached product information
        - `product_id` string, nullable: Attached product ID
        - `variation_id` string, nullable: Attached variation ID
        - `quantity` integer: Attached product quantity
      - `discount_info_by_attachment_product` object, nullable: Discount by attached product
        - `discount` number: Discount value
        - `is_percent` boolean: Is percent
        - `quantity` integer: Quantity to apply discount
      - `inserted_at` string, date-time: Inserted at
      - `updated_at` string, date-time: Updated at
    - `bonus_items` object[]: Bonus items
    - `total_quantity_bonus` integer: Total quantity bonus
    - `arr_level_promotion` object[]: Level promotion array
    - `level_order_prices` object[]: Level order prices
    - `priority_level` integer: Priority level
    - `type_employee` string: Type employee
    - `post_ids` string[]: Post IDs
    - `shop_id` integer: Shop ID
    - `creator_id` string: Creator ID
    - `inserted_at` string, date-time: Inserted at
    - `updated_at` string, date-time: Updated at

## Response `200`

Success

- object
  - `success` boolean: Success status

---

[API](https://skmtc.dev/pancake/apis/pancake-pos-open-api.md) - [All operations](https://skmtc.dev/pancake/apis/pancake-pos-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pancake/apis/pancake-pos-open-api/revisions/3df28d1fb5dc?raw)