# Combo

> Base URL: `https://pos.pages.fm/api/v1`. Xác thực bằng tham số truy vấn `api_key`.

## Danh sách combo

`GET /shops/{SHOP_ID}/combo_products`

Lấy danh sách combo

### Tham số

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `SHOP_ID` | path | integer | yes | Mã shop |

### Phản hồi

- `200` Success (object)

```json
{
  "success": true,
  "data": []
}
```

## Tạo combo

`POST /shops/{SHOP_ID}/combo_products`

### Tham số

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `SHOP_ID` | path | integer | yes | Mã shop |

### Nội dung yêu cầu

Thông tin yêu cầu chứa thông tin combo sản phẩm cần tạo

- `combo_product` (object, required): 
  - `name` (string, required): Tên combo
  - `currency` (string): Tiền tệ
  - `start_time` (integer): Thời điểm bắt đầu
  - `end_time` (integer): Thời điểm kết thúc
  - `order_sources` (object[]): Nguồn đơn hàng
  - `order_types` (string[], required): Loại đơn hàng
  - `livestream_manager_ids` (string[]): Danh sách mã quản lý livestream
  - `is_value_combo` (boolean, required): Loại giảm giá (true: giá trị combo / false: giảm giá combo)
  - `value_combo` (integer): Giá trị combo
  - `is_use_percent` (boolean, required): Giảm giá theo phần trăm
  - `discount_amount` (integer): Giá trị giảm giá
  - `discount_by_percent` (integer): Phần trăm giảm giá
  - `max_discount_by_percent` (integer): Giá trị giảm giá tối đa
  - `is_free_shipping` (boolean): Miễn phí vận chuyển
  - `bonus_products` (object[]): Sản phẩm tặng kèm
  - `is_variation` (boolean, required): Áp dụng cho mẫu mã (true) / Áp dụng cho sản phẩm (false)
  - `variations` (object[]): Thông tin mẫu mã áp dụng
  - `is_categories` (boolean): Áp dụng cho danh mục
  - `categories` (object[]): Danh mục áp dụng

```json
{
  "combo_product": {
    "name": "Combo 1",
    "currency": "VND",
    "start_time": 1745946000,
    "end_time": 1746637199,
    "order_sources": [
      {
        "key": "-3",
        "account": null
      },
      {
        "key": "-1",
        "account": "406"
      }
    ],
    "order_types": [
      "all"
    ],
    "is_value_combo": false,
    "value_combo": 0,
    "is_use_percent": false,
    "discount_amount": 100000,
    "discount_by_percent": 5,
    "max_discount_by_percent": 100000,
    "is_free_shipping": false,
    "is_variation": true,
    "variations": [
      {
        "count": 1,
        "product_id": "0cffd0a6-0a06-4471-a139-cf81aa1fcc6f",
        "variation_id": "821e1337-a04b-473a-b07c-805a572c465a"
      }
    ]
  }
}
```

### Phản hồi

- `200` Success (object)

```json
{
  "success": true
}
```