> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yume.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Глоссарий: Доступ и настройки

> Справочник моделей, адресов, форматов и справочников подписки сотрудников на уведомления по каналам и темам.

Справочник к странице [«Доступ к уведомлениям: каналы, темы и подписки»](/ru/logic/notifications/access-settings).

## Понятия

| Понятие                      | Значение                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Доступ к уведомлениям        | Матрица подписки сотрудника на тему по конкретному каналу — определяет, кому и куда доставлять уведомление.         |
| Список и обновление доступов | адрес API: отдаёт матрицу доступов текущего сотрудника и лениво досоздаёт недостающие строки по умолчанию.          |
| Формат доступа (чтение)      | Отдаёт запись доступа без служебных полей компании и пользователя.                                                  |
| Элемент массового обновления | Одна строка входных данных массового обновления: канал, тема и флаг включения.                                      |
| Массовое обновление доступов | Принимает список настроек и upsert-ит их: создаёт отсутствующие и обновляет флаг у существующих в одной транзакции. |
| Канал доставки               | Три канала веерной рассылки уведомлений.                                                                            |
| Тема уведомления             | Классификатор события для фильтрации, группировки и управления доступом.                                            |

## Модели и поля

### Доступ к уведомлениям

*Матрица подписки сотрудника на тему по конкретному каналу — определяет, кому и куда доставлять. При веерной рассылке используется для отбора web-получателей по теме.*

**Связи**

| Поле      | Тип   | Описание                         |
| --------- | ----- | -------------------------------- |
| Компания  | связь | Ссылка на компанию.              |
| Сотрудник | связь | Ссылка на сотрудника-получателя. |

**Ключ**

| Поле  | Тип          | Описание                                     |
| ----- | ------------ | -------------------------------------------- |
| Канал | перечисление | Канал доставки; по умолчанию мобильный push. |
| Тема  | перечисление | Тема события; по умолчанию «По умолчанию».   |

**Состояние**

| Поле     | Тип  | Описание                                                            |
| -------- | ---- | ------------------------------------------------------------------- |
| Включено | флаг | Подписка активна; в рассылке учитываются только включённые доступы. |

### Список и обновление доступов

*адрес API: отдаёт матрицу доступов текущего сотрудника и лениво досоздаёт недостающие строки по умолчанию.*

Чтение возвращает список доступов; массовое обновление применяет переданные настройки. При неполной матрице все недостающие пары канал×тема досоздаются со значением «включено».

### Формат доступа (чтение)

*Отдаёт запись доступа без служебных полей компании и пользователя.*

Из ответа исключаются поля компании и сотрудника.

### Элемент массового обновления

*Одна строка входных данных массового обновления: канал, тема и флаг включения.*

| Поле     | Тип          | Описание              |
| -------- | ------------ | --------------------- |
| Канал    | перечисление | Канал доставки.       |
| Тема     | перечисление | Тема события.         |
| Включено | флаг         | Новое значение флага. |

### Массовое обновление доступов

*Принимает список настроек и upsert-ит их: создаёт отсутствующие и обновляет флаг у существующих в одной транзакции.*

| Поле            | Тип    | Описание                                                                                                           |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------ |
| Список доступов | список | Набор настроек канал×тема×флаг для upsert: недостающие пары создаются, существующие обновляются по значению флага. |

## Статусы и справочники

### Канал доставки

* Веб (Ably)
* Мобильный push (Expo)
* Telegram

### Тема уведомления

* По умолчанию
* Заявка забронирована
* Заявка завершена
* Просрочка по заявке
* Смена статуса оплаты заявки
* Операция создана
* Возврат по операции
* Операция удалена
* Превышен лимит долга клиента
* Клиент добавлен в чёрный список
* Документ создан
* Документ подписан
* Инвентаризация создана
* Чек-лист инвентаризации
* Доставка назначена
* Смена статуса доставки
* Доставка завершена
* Доставка отменена
* Подходит срок ТО
* ТО назначено
* ТО завершено
* Инвентарь сломан
* Низкий баланс SMS
* Ошибка SMS
* Возврат SMS
* Штраф создан (сервис автомобильных штрафов)
* Получено сообщение Wazzup