# Сим-карта

```javascript
{
    "id": <int>,
    "iccid": <string>,
    "number": <string>,
    "external_number": <string>,
    "name": <string | null>,
    "balance": <float>,
    "currency": <string>,
    "msu_value": <int | null>,
    "profile": <string>,
    "block": <string>,
    "comment": <string | null>,
    "groups": [
        ... массив объектов типа Группа
    ],
    "limit": {
        "type": <string>,
        "value": <int | null>,
        "used": <int | null>,
        "updated": <int | null>,
        "created": <int | null>
    },
    "tariff": {
        "id": <int>,
        "name": <string>,
        "change_lock": <int | null>,
        "package_auto": <bool>
  },
  "queue_status": <string>
}
```
##### Параметры
| Параметр | Тип | Описание | Примечание |
|-------|----------|---------|---------|
| **id**     | int     | ID сим-карты    |
| **iccid**     | string     | ICCID сим-карты    |
| **number**     | string     | Основной номер сим-карты    |
| **external_number**     | string     | Дополнительный номер сим-карты    |
| **name**     | string, null     | Название сим-карты    |
| **balance**     | float     | Баланс сим-карты    | Для сим профиля TD всегда нулевой
| **currency**     | string     | Валюта сим-карты    |
| **msu_value**     | int, null     | Количество MSU    | Только для профиля TC
| **profile**     | string     | Профиль    |
| **block**     | string     | Тип блокировки    | значения см. ниже
| **comment**     | string, null     | Комментарий системы    |
| **groups**     | array     | Массив групп сим-карты    | см. [Группа](https://kb.novaconnect.kz/books/rukovodstvo-razrabotcika/page/gruppa). Отсутствует в [вэбхук-уведомлениях](https://kb.novaconnect.kz/books/rukovodstvo-razrabotcika/page/uvedomleniia)
| **limit**     | object     | Лимит    |
| **limit.type**     | string     | Тип лимита    | значения см. ниже
| **limit.value**     | int     | Установленное значение лимита    |
| **limit.used**     | float     | Использованный лимит    |
| **limit.updated**     | int (UnixTime)     | Дата обновления поля used    |
| **limit.created**     | int (UnixTime)     | Дата установки лимита    |
| **tariff**     | object     | Инфо о тарифе    |
| **tariff.id**     | int     | ID тарифного плана    |
| **tariff.name**     | string     | Название тарифного плана    |
| **tariff.change_lock**     | bool     | Дата снятия блокировки на смену ТП    |
| **tariff.package_auto**     | bool     | Флаг автоматического подключения пакета при истечении    |
| **queue_status**     | string     | Статус обработки    | Возвращается только в вэб-хуках обработки очереди

##### Значения параметра block
| Значение | Описание |
|-------|----------|
| **n**     | Блокировки нет     |
| **u**     | Добровольная (пользовательская)     |
| **m**     | Блокировка по MSU (только для сим профиля TC)     |
| **p**     | Блокировка по истечения пакета     |
| **f**     | Финансовая блокировка     |
| **g**     | Блокировка оператора/NovaConnect     |

##### Значения параметра limit.type
| Значение | Описание |
|-------|----------|
| **off**     | Лимита нет     |
| **month1**     | Календарный месяц (только для сим профиля TC)    |
| **p_lim**     | Пакет, без автопродления (только для сим профиля TD)     |
| **p_unlim**     | Пакет, с автопродлением (только для сим профиля TD)     |

##### Дополнительная информация
- Параметр **"balance"** используется только в сим-картах профиля TC;
- Параметр **"comment"** содержит в себе комментарий от NovaConnect касательно сим-карты (как правило, там рекомендации по работе сим);
- Параметр **"msu_value"** содержит количество MSU, переданных оператором (только для профиля TC);
- Информация о лимитах передается в мегабайтах;
- Все даты - в формате UnixTime;
- Блокировка типа **"m"** невозвратная - значит, что оператор заблокировал сим-карту за превышение лимита MSU.