> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/administration/kanaly-opoveshenii/variables/object.md).

# Основные объекты, используемые в переменных

#### **Общие поля (есть у любого типа)**

|  Атрибут | Тип данных |        Комментарий        |
| :------: | :--------: | :-----------------------: |
|    id    |    Число   |         Id объекта        |
| parentId |    Число   | Id родительского элемента |
|   type   |   Строка   |        Тип объекта        |
|   label  |   Строка   |          Название         |

#### Заявка

|         Атрибут        |                Тип данных                |                                                                                                                                      Комментарии                                                                                                                                     |
| :--------------------: | :--------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|    activateDateTime    |                   Дата                   |                                                                                                                                     Начало визита                                                                                                                                    |
|   deactivateDateTime   |                   Дата                   |                                                                                                                                   Окончание визита                                                                                                                                   |
|     purposeOfVisit     |                  Строка                  |                                                                                                                                      Цель визита                                                                                                                                     |
|        passType        |                   Число                  | Тип пропуска (0 - гостевой пропуск, 1 - временный, 2 - постоянный, 3 - замена пропуска, 4 - VIP-пропуск, 5 - бессрочный, 6 - доступ, 7 - временный доступ, 8 - продление доступа, 9 - автомобильный пропуск, 10 - Пользовательский тип заявки, 11 - Универсальная заявка на пропуск) |
|     replacementPass    |                   Число                  |                                                                                                                                 Id пропуска на замену                                                                                                                                |
|      passStatusId      |                   Число                  |                                                                                                                                  Id статуса пропуска                                                                                                                                 |
|        visitors        |           Масссив типа Человек           |                                                                                                                                      Посетители                                                                                                                                      |
|          cars          |           Масссив типа Человек           |                                                                                                                                      Автомобили                                                                                                                                      |
|      organization      |            Объект Организация            |                                                                                                                                      Организация                                                                                                                                     |
|         inviter        |              Объект Человек              |                                                                                                                                     Приглашающий                                                                                                                                     |
|      meetingPerson     |              Объект Человек              |                                                                                                                                      Встречающий                                                                                                                                     |
|   orderedAccessGroups  |        Массив типа Группа доступа        |                                                                                                                                    Группы доступа                                                                                                                                    |
|          sites         |           Массив типа Площадка           |                                                                                                                                       Площадки                                                                                                                                       |
|      parkingSpaces     |           Массив типа Парковка           |                                                                                                                                       Парковки                                                                                                                                       |
|         addInfo        |                  Строка                  |                                                                                                                               Дополнительная информация                                                                                                                              |
|          state         |                   Число                  |                                                                                   Состояние заявки (1 - черновик, 2 - на согласовании, 3 - согласовано, 4 - отказано, 5 - обработана, 6 - отменена)                                                                                  |
|      need2Confirm      |                Логический                |                                                                                                                               Требуется ли согласование                                                                                                                              |
|      confirmChain      |          Массив типа Согласующие         |                                                                                                                     Согласующие (Операторы или группа операторов)                                                                                                                    |
|         pinCode        |                   Число                  |                                                                                                                                        Пин-код                                                                                                                                       |
|  сonfirmChainComments  | Массив типа Элемент цепочки согласования |                                                                                                                              Комментариии от Согласующих                                                                                                                             |
|  submittedConfirmChain | Массив типа Элемент цепочки согласования |                                                                                                                  Результаты согласований (согласовано или отказано)                                                                                                                  |
|    refuseResponsible   |          Массив типа Согласующие         |                                                                                                                   ФИО отказавшего человека или наименование группы                                                                                                                   |
|      refuseReason      |                  Строка                  |                                                                                                                                    Причина отказа                                                                                                                                    |
|     visitorsFullFio    |                  Строка                  |                                                                                                                             ФИО посетителей через запятую                                                                                                                            |
| visitorsFullFioNewLine |                  Строка                  |                                                                                                                          ФИО посетителей с переносом строки                                                                                                                          |
|     visitorsNewLine    |                  Строка                  |                                                                                                                        Инициалы посетителей с переносом строки                                                                                                                       |

#### Посетитель (Автомобиль)

|        Атрибут        |         Тип данных         |             Комментарий            |
| :-------------------: | :------------------------: | :--------------------------------: |
|        surname        |           Строка           |     Фамилия (Номер автомобиля)     |
|          name         |           Строка           |       Имя (Марка автомобиля)       |
|       middlename      |           Строка           |              Отчество              |
|         email         |           Строка           |                Почта               |
|         phone         |           Строка           |               Телефон              |
|       workPhone       |           Строка           |           Рабочий телефон          |
|         gender        |            Число           |   Пол (0-муж, 1-жен, 2-не указан)  |
|        birthday       |            Дата            |            День рождения           |
|        category       |      Объект Категория      |       Категория пользователя       |
|        position       |      Объект Должность      |              Должность             |
|          room         |           Строка           |               Комната              |
|  orderedAccessGroups  | Массив типа Группа доступа |           Группы доступа           |
|        consent        |       Объект Согласие      | Согласие на обработку перс. данных |
|       documents       |    Массив типа Документ    |              Документы             |
|        address        |        Объект Адрес        |                Адрес               |
|         passes        |     Массив типа Пропуск    |              Пропуска              |
|    isForeignCitizen   |         Логический         |        Иностранный гражданин       |
|      nationality      |      Объект Справочник     |           Национальность           |
|      organization     |     Объект Организация     |             Организация            |
| addField1..addField10 |           Строка           |      Дополнительные поля 1-10      |
|        orgUnit        |    Объект Подразделение    |            Подразделение           |
|     isOrgUnitHead     |         Логический         |     Руководитель подразделения     |
|        fullName       |           Строка           |             Полное ФИО             |
|       shortName       |           Строка           |           Сокращенное ФИО          |
|       validPhone      |           Строка           |               Телефон              |

#### Оператор

| Атрибут      | Тип данных         | Комментарий                  |
| ------------ | ------------------ | ---------------------------- |
| personal     | Объект Человек     | Персональные данные человека |
| login        | Строка             | Логин                        |
| organization | Объект Организация | Организация                  |

#### Организация

|     Атрибут    |  Тип данных  |   Комментарий   |
| :------------: | :----------: | :-------------: |
|     address    | Объект Адрес |      Адрес      |
|      phone     |    Строка    |     Телефон     |
|    workPhone   |    Строка    | Рабочий телефон |
| additionalInfo |    Строка    |   Комментарий   |

#### Парковка

|   Атрибут   |         Тип данных        |            Комментарий            |
| :---------: | :-----------------------: | :-------------------------------: |
|    total    |           Число           | Общее количество мест на парковке |
| checkPoints | Массив типа Точка прохода |           Точки прохода           |

#### Элемент цепочки согласования

|    Атрибут    |   Тип данных  |                                 Комментарий                                |
| :-----------: | :-----------: | :------------------------------------------------------------------------: |
| responsibleId |     Число     |             id ответственного (Оператор или Группа операторов)             |
| confirmResult |     Число     | Результат согласования(1 - на согласовании, 2 - согласовано, 3 - отказано) |
|    addInfo    |     Строка    |                                 Комментарий                                |
|    request    | Объект Заявка |                                   Заявка                                   |

#### Категория пользователя

|     Атрибут     | Тип данных |                                    Комментарий                                    |
| :-------------: | :--------: | :-------------------------------------------------------------------------------: |
|    categoryId   |    Число   | Тип категории (1 - Сотрудник, 2 - Посетитель, 3 - VIP-Посетитель, 4 - Автомобиль) |
| isConsentNeeded | Логический |                    Нужно ли согласие на обработку перс. данных                    |
|     colorHex    |   Строка   |                                        Цвет                                       |

#### Согласие на обработку персональных данных

|       Атрибут      | Тип данных |                            Комментарий                            |
| :----------------: | :--------: | :---------------------------------------------------------------: |
| keepPersonDataFrom |    Дата    |   Дата начала действия согласия на обработку персональных данных  |
|  keepPersonDataTo  |    Дата    | Дата окончания действия согласия на обработку персональных данных |
| isPersonDataSigned | Логический |       Подписано ли согласие на обработку персональных данных      |

#### Адрес

|     Атрибут    |   Тип данных   |        Комментарий        |
| :------------: | :------------: | :-----------------------: |
|     region     |     Строка     |           Регион          |
|    district    |     Строка     |           Район           |
|      city      |     Строка     |   Город/населенный пункт  |
|     street     |     Строка     |           Улица           |
|      house     |     Строка     |            Дом            |
|      corp      |      Число     |           Корпус          |
|      flat      |      Число     |          Квартира         |
|   addressType  | Тип Справочник |         Тип адреса        |
| additionalInfo |     Строка     | Дополнительная информация |

#### Пропуск

| Атрибут               | Тип данных        | Комментарий                                                                                                               |
| --------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------- |
| passNumber            | Строка            | Номер пропуска                                                                                                            |
| addInfo               | Строка            | Дополнительная информация                                                                                                 |
| passType              | Число             | Тип пропуска (0 - гостевой, 1 - временный, 2 - постоянный, 3 - замена, 4 - VIP-пропуск, 5 - бессрочный, 6- автомобильный) |
| fc                    | Число             | Код организации                                                                                                           |
| passStatus            | Объект Справочник | Статус пропуска                                                                                                           |
| person                | Объект Человек    | Владелец пропуска                                                                                                         |
| permanentPassesIds    | Строка            | Список id постоянных пропусков через запятую                                                                              |
| addField1..addField10 | Строка            | Дополнительные поля 1-10                                                                                                  |

#### Элемент словаря

|  Атрибут  | Тип данных | Комментарий |
| :-------: | :--------: | :---------: |
| shortInfo |   Строка   |   Описание  |
|  subType  |   Строка   |    Подтип   |

#### Точка прохода

|    Атрибут    |        Тип данных       |      Комментарий     |
| :-----------: | :---------------------: | :------------------: |
|  inputReaders | Массив типа Считыватель |  Входные считыватели |
| outputReaders | Массив типа Считыватель | Выходные считыватели |

#### Тип документа

|   Атрибут   | Тип данных |                                                      Комментарий                                                     |
| :---------: | :--------: | :------------------------------------------------------------------------------------------------------------------: |
| countryCode |   Строка   |                                                      Код страны                                                      |
|   docType   |    Число   | Тип документа (0 - другой тип, 1 - паспорт, 2 - биометрич. паспорт, 3 - водительские права, 4 - иностранный паспорт) |

#### Считыватель

|           Атрибут          | Тип данных |                           Комментарий                           |
| :------------------------: | :--------: | :-------------------------------------------------------------: |
|            path            |   Строка   |                               Путь                              |
|          isVirtual         | Логический |                     Виртуальный считыватель                     |
|        isCardReader        | Логический |                          Картоприемник                          |
|        withdrawInAcs       | Логический |                           Изъять в СКД                          |
| activatePermOnWithdrawTemp | Логический | Активировать постоянный пропуск при изъятии временного пропуска |
