---
title: "Create promotion product"
method: POST
path: "/shops/{SHOP_ID}/promotion_advance"
tags: ["Promotion"]
---

# Create promotion product

`POST /shops/{SHOP_ID}/promotion_advance`

Create promotion

## Path parameters

- `SHOP_ID` integer, required

## Request body

- object
  - `promotion_advance` object, required
    - `name` string, required — Promotion name
    - `start_time` integer — Start time
    - `end_time` integer — End time
    - `warehouse_ids` string[] — Warehouse IDs
    - `customer_tags` string[] — Customer tags
    - `order_sources` object[] — Order sources
    - `type` 'discount_by_product' | 'discount_by_order_price' | 'fixed_prices' | 'coupon' | 'double_reward_point' | 'discount_by_coupon_id' | 'discount_by_attachment_products', required — Promotion type
    - `group_name` string — Promotion group
    - `is_activated` boolean — Is activated
    - `is_variation` boolean — Is variation
    - `coupon_info` object — Coupon information
      - `discount` integer — Discount
      - `is_percent` boolean — Is percent
      - `is_categories` boolean — Is categories
      - `category_ids` integer[] — Category IDs
    - `promo_code_info` object — Promotion code information
      - `discount` integer — Discount
      - `is_percent` boolean — Is percent
      - `max_discount_by_percent` integer — Maximum discount by percent
    - `items` object[] — Promotion items
      - `variation_id` string — Variation ID
      - `product_id` string, nullable — Product ID
      - `category_id` string, nullable — Category ID
      - `category` object — Category
      - `level_info` object[] — Level info
        - `from_quantity` integer — From quantity
        - `to_quantity` integer — To quantity
        - `discount` integer — Discount
        - `is_percent` boolean — Is percent
      - `fixed_prices` integer — Fixed prices
      - `coupon_item_info` object — Coupon item info
        - `discount` integer — Discount
        - `is_percent` boolean — Is percent
        - `max_discount_by_percent` integer — Maximum discount by percent
    - `is_free_shipping` boolean — Is free shipping
    - `discount_by_quantity` integer — Discount by quantity
    - `bonus_items` object[] — Bonus items
    - `is_discount_in_birthday_customer` boolean — Is discount in birthday customer
    - `arr_level_promotion` object[] — Level promotion array
    - `total_quantity_bonus` integer — Total quantity bonus
    - `priority_level` integer — Priority level
    - `type_employee` string — Type employee
    - `free_products` object[] — Free products
      - `is_active` boolean — Is active
      - `products_count` integer — Products count
      - `count_free_products` integer — Count free products
      - `type` string — Type

## 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/fd00f35fbf21?raw)