# Gói dịch vụ

## Gói dịch vụ v1

### Danh sách gói dịch vụ

<mark style="color:blue;">`GET`</mark> `[URL]/api/partner/service_package/list`

Danh sách gói dịch vụ

#### Headers

| Name          | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Authorization | string | Access token: Bearer 'partner token' |

{% tabs %}
{% tab title="200 Danh sách gói dịch vụ" %}

```
{
    "status_code": 9999,
    "instance_id": "stg",
    "payload": [
        {
            "code_name": "trial", // Mã
            "service_name": "Trial", // Tên
            "staff_num": 5, // Số lượng nhân viên
            "customer_num": 100, // Số lượng khách hàng
            "note": "5 người dùng \n100 khách hàng \n500MB dữ liệu" // Mô tả
            "fee_setups" [ // Phí cài đặt VND
                
            ],
            "fee_holds" : [ // Phí duy trì VND
                
            ]
        },
        {
            "code_name": "omi_start",
            "service_name": "Omi Start",
            "staff_num": 5, // Số lượng nhân viên
            "customer_num": 0, // Không giới hạn
            "note": "5 người dùng \nKhông giới hạn khách hàng \n10GB dữ liệu"
            "fee_setups" [ // Phí cài đặt VND
                {
                    "currency": "VND",
                    "price": 300000
                }
                ....
            ],
            "fee_holds" : [ // Phí duy trì VND
                {
                    "currency": "VND",
                    "price": 350000
                },
                ....
            ]
        },
        {
            "code_name": "omi_business",
            "service_name": "Omi Business",
            "staff_num": 10,
            "customer_num": 0,
            "note": "5 người dùng \nKhông giới hạn khách hàng \n50GB dữ liệu"
        },
        {
            "code_name": "omi_advance",
            "service_name": "Omi Advance",
            "staff_num": 20,
            "customer_num": 0,
            "note": "20 người dùng \nKhông giới hạn khách hàng \n100GB dữ liệu"
        },
        {
            "code_name": "omi_pro",
            "service_name": "Omi Pro",
            "staff_num": 30,
            "customer_num": 0,
            "note": "30 người dùng \nKhông giới hạn khách hàng \n100GB dữ liệu"
        },
        {
            "code_name": "customize",
            "service_name": "Omi Enterprise",
            "staff_num": 35,
            "customer_num": 0,
            "note": "50 người dùng \nKhông giới hạn khách hàng \n1000GB dữ liệu"
        }
    ],
    "key_enabled": false
}
```

{% endtab %}
{% endtabs %}

### Nâng cấp gói dịch vụ

<mark style="color:green;">`POST`</mark> `[URL]/api/partner/service_package/upgrade`

Nâng cấp gói dịch vụ\
**Số tiền nâng cấp** = **Phí thiết lập** + **Phí duy trì \* số tháng**

#### Path Parameters

| Name          | Type   | Description                           |
| ------------- | ------ | ------------------------------------- |
| Authorization | string | Access Token : Bearer 'partner token' |

#### Request Body

<table><thead><tr><th>Name</th><th width="249">Type</th><th>Description</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>Email chủ doanh nghiệp</td></tr><tr><td>code_name</td><td>string</td><td>Mã gói dịch vụ</td></tr><tr><td>month_num</td><td>number</td><td>Số tháng (Ít nhất là 6 tháng)</td></tr><tr><td>note</td><td>string</td><td>Ghi chú (Lớn hơn 10 ký tự)</td></tr></tbody></table>

{% tabs %}
{% tab title="200 Nâng cấp gói dịch vụ thành công" %}

```
```

{% endtab %}
{% endtabs %}

### Gia hạn gói dịch vụ

<mark style="color:green;">`POST`</mark> `[URL]/api/partner/service_package/extend`

Gia hạn gói dịch vụ\
**Số tiền gia hạn = Phí duy trì \* Số tháng**

#### Headers

| Name          | Type   | Description                            |
| ------------- | ------ | -------------------------------------- |
| Authorization | string | Access Token : Bearer 'partner token'. |

#### Request Body

| Name       | Type    | Description                          |
| ---------- | ------- | ------------------------------------ |
| month\_num | integer | Số tháng gia hạn (Tối thiểu 6 tháng) |
| note       | string  | Ghi chú (Tối thiểu 10 ký tự)         |
| email      | string  | Email chủ doanh nghiệp               |

{% tabs %}
{% tab title="200 Gia hạn gói dịch vụ" %}

```
```

{% endtab %}
{% endtabs %}

## Gói dịch vụ v2

### Danh sách gói dịch vụ của đại lý

<mark style="color:blue;">`GET`</mark> `[URL]/api/partner/service_package_v2/template/list`

Danh sách gói dịch vụ đang bán của đại lý

#### Path Parameters

<table><thead><tr><th width="191">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Access token: Bearer '<strong>partner</strong> token'</td></tr></tbody></table>

#### Response

{% tabs %}
{% tab title="200 Danh sách gói dịch vụ" %}

```
//Thông tin gói dịch vụ của đại lý
```

{% endtab %}
{% endtabs %}

### Nâng cấp gói dịch vụ (gói nhân viên)

<mark style="color:green;">`POST`</mark> `[URL]/api/partner/service_package_v2/user/buy_many`

Nâng cấp gói dịch vụ

#### Path Parameters

| Name          | Type   | Description                              |
| ------------- | ------ | ---------------------------------------- |
| Authorization | string | Access Token : Bearer '**tenant** token' |

#### Request Body

| Name        | Type   | Description                        |
| ----------- | ------ | ---------------------------------- |
| code        | string | service\_code                      |
| total       | number | Tổng số gói mua                    |
| unit        | string | Đơn vị thời hạn: "month"           |
| value       | number | Số tháng gia hạn (Tối đa 60 tháng) |
| description | string | Ghi chú (Tối thiểu 50 ký tự)       |

{% tabs %}
{% tab title="Body" %}

```postman_json
{
    "packages": [
        {
            "code": "abc",
            "total": "1",
            "duration": {
                "unit": "month",
                "value": "1"
            }
        }
    ],
    "description": "mua 1 goi 1 thang cho 1 nhan vien, co day du tinh nang"
}
```

{% endtab %}
{% endtabs %}

#### Response

{% tabs %}
{% tab title="200 Nâng cấp gói dịch vụ thành công" %}

```
// Thông tin gói đã mua
```

{% endtab %}
{% endtabs %}

### Gia hạn gói dịch vụ (gói nhân viên)

<mark style="color:green;">`POST`</mark> `[URL]/api/partner/service_package_v2/user/extend`

Gia hạn gói dịch vụ

#### Path Parameters

| Name          | Type   | Description                              |
| ------------- | ------ | ---------------------------------------- |
| Authorization | string | Access Token : Bearer '**tenant** token' |

#### Request Body

<table><thead><tr><th width="248">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>note</td><td>string</td><td>Ghi chú</td></tr><tr><td>usp_id</td><td>string</td><td>Id gói nhân viên</td></tr><tr><td>unit</td><td>string</td><td>Đơn vị thời hạn: "month"</td></tr><tr><td>value</td><td>number</td><td>Số tháng gia hạn (Tối đa 60 tháng)</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

<pre class="language-postman_json"><code class="lang-postman_json"><strong>{
</strong>    
    "note": "note ",
    "usp_id": "6640d2389f78763bd5dfdgdg",
    "duration": {
        "unit": "month",
        "value": "1"
    }
}
</code></pre>

{% endtab %}
{% endtabs %}

#### Response

{% tabs %}
{% tab title="200 Nâng cấp gói dịch vụ thành công" %}

```
// Thông tin gói đã gia hạn
```

{% endtab %}
{% endtabs %}

### Danh sách gói dịch vụ đã mua (gói nhân viên)

<mark style="color:blue;">`POST`</mark> `[URL]/api/partner/service_package_v2/user/list`

Danh sách gói nhân viên mà doanh nghiệp đã mua

#### Path Parameters

| Name          | Type   | Description                              |
| ------------- | ------ | ---------------------------------------- |
| Authorization | string | Access Token : Bearer '**tenant** token' |

#### Request Body

<table><thead><tr><th width="248">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>assigned_employee</td><td>Array&#x3C;string></td><td>"assigned"/ "unassigned" / null</td></tr></tbody></table>

#### Response

{% tabs %}
{% tab title="200 Nâng cấp gói dịch vụ thành công" %}

```
// Thông tin tất cả gói nhân viên đã mua
```

{% endtab %}
{% endtabs %}

### Gỡ nhân viên liên kết gói

<mark style="color:blue;">`POST`</mark> `[URL]/api/partner/service_package_v2/user/remove_agent?lng=vi`

Gỡ nhân viên liên kết ra khỏi gói nhân viên

#### Query Parameters

<table><thead><tr><th width="248">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>lng</td><td>string</td><td>vi</td></tr></tbody></table>

#### Path Parameters

| Name          | Type   | Description                              |
| ------------- | ------ | ---------------------------------------- |
| Authorization | string | Access Token : Bearer '**tenant** token' |

#### Request Body

<table><thead><tr><th width="277">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>is_all</td><td>Boolean</td><td>"false": chỉ gỡ những gói được truyền vào list include_ids<br>"true": gỡ toàn bộ gói</td></tr><tr><td>include_ids</td><td>Array</td><td>ID gói (_id)<br>is_all: "true" không cần truyền Parameters</td></tr></tbody></table>

#### Response

{% tabs %}
{% tab title="200 Gỡ gói nhân viên thành công" %}

```
{
    "instance_id": "stg",
    "payload": true,
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}
```

{% endtab %}
{% endtabs %}

### Xoá gói nhân viên

<mark style="color:blue;">`POST`</mark> `[URL]/api/partner/service_package_v2/user/delete?id=&lng=vi`

#### Query Parameters

<table><thead><tr><th width="248">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>string</td><td>ID gói (_id)</td></tr><tr><td>lng</td><td>string</td><td>vi</td></tr></tbody></table>

#### Path Parameters

| Name          | Type   | Description                              |
| ------------- | ------ | ---------------------------------------- |
| Authorization | string | Access Token : Bearer '**tenant** token' |

#### Response

{% tabs %}
{% tab title="200 Xoá gói nhân viên thành công" %}

```
{
    "instance_id": "stg",
    "payload": true,
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}
```

{% endtab %}
{% endtabs %}