# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.omicall.com/partner/service_package.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.