> ## 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/documents/signing).

## Подписант

*Сторона (клиент или компания), которая подписывает документ. Один подписант закрепляется за парой «компания + клиент» (или самой компанией) и переиспользуется на разных документах.*

| Поле                            | Тип        | Описание                                                                 |
| ------------------------------- | ---------- | ------------------------------------------------------------------------ |
| ID                              | число      | Первичный ключ                                                           |
| Компания-арендодатель           | связь      | Компания, в рамках которой существует подписант                          |
| Тип подписанта                  | список     | См. «Тип подписанта» ниже                                                |
| Имя/название                    | текст      | ФИО клиента или название компании на момент подписания                   |
| Телефон                         | текст      | Используется для отправки SMS-кода подписания                            |
| Email                           | текст      | —                                                                        |
| Внешний ID                      | число      | ID связанной сущности вне модуля документов (например, клиента компании) |
| Доп. данные                     | JSON       | Произвольные атрибуты подписанта                                         |
| Дата создания / Дата обновления | дата/время | —                                                                        |

## Подпись документа

*Запрос на подписание документа конкретным подписантом. На один документ не может быть двух подписей от одного подписанта. Документ считается подписанным, когда все его подписи получили статус «Подписан».*

| Поле                            | Тип          | Описание                                                                                                                                                             |
| ------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                              | число        | Первичный ключ                                                                                                                                                       |
| UUID подписи                    | текст (UUID) | Публичный идентификатор, используется в ссылке для подписания                                                                                                        |
| Документ                        | связь        | Документ, который подписывается                                                                                                                                      |
| Подписант                       | связь        | Сторона, которая должна подписать                                                                                                                                    |
| Способ подписания               | список       | См. «Способ подписания» ниже                                                                                                                                         |
| Разрешённые способы подписания  | список       | Проверяется сервером при отправке SMS, запросе и подтверждении кода и на путях ЕГОВ/ЭЦП; ручное подписание не проверяется. По умолчанию — «ЕГОВ/ЭЦП» и «По SMS-коду» |
| Статус                          | список       | См. «Статус документа/подписи» ниже                                                                                                                                  |
| Дата создания / Дата обновления | дата/время   | —                                                                                                                                                                    |

## Этап подписания

*Запись истории смены статуса подписи (журнал переходов для аудита, не редактируется напрямую).*

| Поле          | Тип        | Описание                                                     |
| ------------- | ---------- | ------------------------------------------------------------ |
| ID            | число      | Первичный ключ                                               |
| Подпись       | связь      | Подпись, к которой относится этап                            |
| Статус до     | список     | Проставляется автоматически реальным предыдущим статусом     |
| Статус после  | список     | Новый статус подписи                                         |
| Доп. данные   | JSON       | Метаданные перехода — IP, ОС, браузер, устройство (см. ниже) |
| Дата создания | дата/время | —                                                            |

**Метаданные, сохраняемые в «Доп. данные»:** IP-адрес клиента, операционная система (детали и семейство), браузер (с версией и семейством), тип устройства (мобильное/планшет/десктоп) — определяются по данным запроса. Исключение — подтверждение через мобильное приложение ЕГОВ: там сохраняются только данные сертификата.

## Проверка остатка пакета подписей

*Общая проверка, встроенная в сценарии подписания: в режиме биллинга «за документ» она отклоняет операцию с ошибкой «Количество подписей исчерпано», если у компании не осталось свободных слотов в пакетах. В режиме «за SMS» проверка ничего не ограничивает. Подключена к отправке SMS сотрудником, запросу и подтверждению кода клиентом и к загрузке файла с ЭЦП; ручное подписание и подтверждение через мобильное приложение ЕГОВ она не покрывает. Отдельное «Разрешение на подписание по квоте документов» (см. глоссарий пакетов) по-прежнему ничего не проверяет.*

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

### Тип подписанта

*Определяет, кем является подписант.*

* Компания
* Клиент

### Способ подписания

*Каким способом подписант подтверждает документ.*

* Вручную
* По SMS-коду
* Через ЕГОВ/ЭЦП

### Статус документа/подписи

*Стадия жизненного цикла одной подписи. Хранится в подписи (не в самом документе); история переходов — в этапах подписания.*

* Черновик
* Готов к подписанию
* Просматривается
* На подтверждении
* Отклонён — определён в системе, но ни один способ подписания фактически в него не переводит
* Подписан