# Thẻ đơn hàng

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

## Danh sách thẻ đơn hàng

`GET /shops/{SHOP_ID}/orders/tags`

Lấy danh sách thẻ đơn hàng

### Tham số

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

### Phản hồi

- `200` Success (object)

```json
{
  "data": [
    {
      "id": 75,
      "name": "thẻ 4",
      "color": "#123123",
      "is_system_tag": false,
      "groups": [
        {
          "id": 13,
          "name": "nhom 1"
        },
        {
          "id": 16,
          "name": "nhom 2"
        }
      ]
    },
    {
      "id": 1,
      "name": "Giao không thành",
      "color": "#f04134",
      "is_system_tag": true,
      "groups": [
        {
          "id": -1,
          "name": "Delivery Group"
        },
        {
          "id": 13,
          "name": "nhom 1"
        }
      ]
    },
    {
      "id": 2,
      "name": "Chờ cọc",
      "color": "#096dd9",
      "is_system_tag": true,
      "groups": []
    }
  ],
  "success": true
}
```

## Tạo thẻ đơn hàng

`POST /shops/{SHOP_ID}/orders/tags`

Tạo mới thẻ đơn hàng

### 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 thẻ đơn hàng cần tạo

- `name` (string, required): Tên thẻ đơn hàng
- `tag_color` (string): Mã màu thẻ
- `groups` (integer[]): Danh sách mã nhóm thẻ. Lấy từ API GET /shops/{SHOP_ID}/orders/tag_groups
- `statuses` (integer[]): Danh sách trạng thái đơn hàng áp dụng thẻ

```json
{
  "name": "test 5.1",
  "tag_color": "#000",
  "groups": [
    1
  ],
  "statuses": [
    1,
    2,
    3
  ]
}
```

### Phản hồi

- `200` Success (object)

```json
{
  "data": {
    "id": 50,
    "name": "test 5.1",
    "tag_color": "#000",
    "groups": [
      1
    ],
    "statuses": [
      1,
      2,
      3
    ]
  },
  "success": true
}
```

## Cập nhật thẻ đơn hàng

`PUT /shops/{SHOP_ID}/orders/tags/{TAG_ID}`

Cập nhật thẻ đơn hàng. Chỉ áp dụng cho các thẻ không phải là thẻ hệ thống (is_system_tag = false)

### Tham số

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `SHOP_ID` | path | integer | yes | Mã shop |
| `TAG_ID` | path | integer | yes | Mã thẻ đơn hàng |

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

Thông tin yêu cầu chứa thông tin thẻ đơn hàng cần cập nhật

- `name` (string, required): Tên thẻ đơn hàng
- `tag_color` (string): Mã màu thẻ
- `groups` (integer[]): Danh sách mã nhóm thẻ. Lấy từ API GET /shops/{SHOP_ID}/orders/tag_groups
- `statuses` (integer[]): Danh sách trạng thái đơn hàng áp dụng thẻ

```json
{
  "name": "test 4.4",
  "tag_color": "#000",
  "groups": [
    1,
    2
  ],
  "statuses": [
    1,
    2,
    3
  ]
}
```

### Phản hồi

- `200` Success (object)

```json
{
  "data": {
    "id": 45,
    "name": "test 4.4",
    "tag_color": "#000",
    "groups": [
      2,
      1
    ],
    "statuses": [
      1,
      2,
      3
    ]
  },
  "success": true
}
```

## Danh sách nhóm thẻ đơn hàng

`GET /shops/{SHOP_ID}/orders/tag_groups`

Lấy danh sách nhóm thẻ đơn hàng

### Tham số

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

### Phản hồi

- `200` Success (object)

```json
{
  "data": [
    {
      "id": 1,
      "name": "nhóm 1",
      "add_multiple_tags": true,
      "tags": [
        41,
        50,
        45
      ]
    }
  ],
  "success": true
}
```