> 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/acs-configuration/konfigurirovanie-integracii-s-skd-perco.md).

# Конфигурирование интеграции с СКД PERCo

**Настройка интеграции PassOffice с PERCo: Пошаговая инструкция**

Данное руководство описывает процесс настройки интеграции между PassOffice и системой контроля доступа PERCo. Выполните следующие шаги под учетной записью администратора PassOffice.

**Предварительные требования:**

**1.** Настройте интеграцию по инструкции к СКД PERCo.

**Настройка PassOffice:**

**1. Запуск сервера PassOffice:** Запустите сервер PassOffice, используя файл `PassOfficeSrv.bat`.

**2. Авторизация в PassOffice:** Откройте браузер, введите адрес сервера PassOffice (например, `localhost:80`) и авторизуйтесь под учетной записью администратора.

**3**. **Переход к настройкам интеграции:** Откройте пункт меню «Администрирование / Настройки интеграции».

**4. Редактирование настроек PERCo:**

• **Вкладка «Основные»:**

* `Логин и пароль оператора PERCo` : укажите логин и пароль оператора `PERCo`, от лица которого будет работать PassOffice. Для обновления пароля:
  * Установите галочку **«Обновить пароль»**
  * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**.
* `URL СКД:`сервиса интеграции PERCo, например, `http://192.168.2.110/api`
* `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных.

• **Вкладка «Дополнительные настройки»:**

**Синхронизация**

* *Отгружать посетителей без пропусков* - при включенной настройке посетитель может быть отгружен без выдачи пропуска после согласования заявки.
* *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители.

**Режимы отгрузки**

* *Отгружать только через заявку -* данные о пользователе и его пропуске передаются в систему СКУД после обработки заявки.
* *Не отгружать* - информация о пользователе и пропуске полностью блокируется для автоматической передачи в систему СКУД при любых действиях в системе - создании заявки, редактировании данных пользователя или пропуска.
* *Всегда отгружать* - данные синхронизируются с системой СКУД при любом изменении, независимо от наличия заявки.

Эти режимы могут быть назначены как глобально для всей системы, так и индивидуально для отдельных категорий пользователей.

**Режимы удаления**

* *Удалять в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice будет удалена соответствующая запись в ПК PERCo.
* *Деактивировать в СКУД при удалении в бюро пропусков -* при удалении посетителя в PassOffice, посетитель в ПК PERCo остается со статусом «неактивен».
* *Не отрабатывать удаление -* при удалении посетителя в PassOffice, посетитель в ПК APACS остается активным.

Эти режимы могут быть назначены как глобально для всей системы, так и индивидуально для отдельных категорий пользователей.

**Пропуск:**

* *При выдаче временного пропуска* - изымать постоянный пропуск, уазанный в заявке*.*
* *Количество бит у кода организации и количество бит у номера пропуска -* укажите количество бит для настройки разрядности. Например, код организации: `8 бит`Номер пропуска: `16 бит`
* *Срок действия бессрочного пропуска:* укажите срок действия, который будет назначен бессрочному пропуску из PassOffice при отгрузке в PERCo. Если в PassOffice создан бессрочный пропуск, то в PERCo пропуск будет отгружен со сроком действия, указанным в «Настройках интеграции».

**События:**

* *Импортировать события доступа начиная с:* определите период времени для синхронизации событий между PassOffice и СКД. Этот параметр определяет, как часто PassOffice будет получать обновления из СКД.
* *Конфигурация размера пакетов для импорта:* оптимизируйте процесс импорта данных из СКД, указав размер пакетов для различных типов объектов: человек, группа доступа, сообщение из СКД, считыватель.

• **Тест соединения:** обязательно проведите тест соединения после ввода параметров.

* **Успешный тест:** активируйте настройки соединения с СКД.
* **Ошибка:** проверьте логи СКД *PERCo* и сервера PassOffice для выявления и устранения проблемы.

• **Соответствие категорий:** укажите соответствие между категориями пользователей в PassOffice и СКД.

{% hint style="info" %}
PassOffice подерживает работу только с посетителями в *PERCo.*
{% endhint %}

• **Настройка полей:**

Сконфигурируйте поля человека, доп.поля человека, пропуска, указав какие поля необходимо отгружать или импортировать из СКД, а также стратегию слияния при импорте:

* *Сторонняя система, очищать -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле в PassOffice будет очищено. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
* *Сторонняя система, дополнять -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле отгрузится из PassOffice. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
* *Бюро пропусков -* при расхождении данных, поля из PassOffice останутся приоритетными. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. И если есть поля в PassOffice, но нет в СКУД - недостающие поля отгружаются в СКУД.

**Поля посетителя, которые синхронизируются с СКД PERCo:**

|      Поля     | Отгрузка в СКД | Импорт из СКД |
| :-----------: | :------------: | :-----------: |
|      ФИО      |        +       |       +       |
| Подразделение |        +       |       +       |
|   Активность  |        +       |       +       |
|      Фото     |        +       |       +       |
|   Категория   |        +       |       +       |
|     Почта     |        +       |       +       |
|  Организация  |        +       |       +       |

**Поля пропуска, которые синхронизируются с СКД PERCo:**

|       Поля      | Отгрузка в СКД | Импорт из СКД |
| :-------------: | :------------: | :-----------: |
|  Номер пропуска |        +       |       +       |
| Код организации |        +       |       +       |

• **Реактивация/Деактивация соединения:** используйте соответствующие кнопки для управления состоянием соединения с СКД.

После выполнения этих шагов интеграция PassOffice с PERCo должна быть настроена. Рекомендуется проверить работоспособность интеграции путем создания тестовой заявки и отслеживания её в системе PERCo.

**Особенности работы с PERCo:**

1. **Обязательное поле «Подразделение»**:
   * Для отгрузки человека в PERCo необходимо указать **Подразделение**. Без этого данные не будут переданы в PERCo.
   * **Настройка импорта подразделения**:
     * Импортируйте подразделение из СКУД.
     * В PassOffice создайте правило для людей:
       * **Человек. Организация**: Присвоить → Выберите организацию из выпадающего списка.
       * **Человек. Подразделение**: Присвоить → Выберите подразделение из выпадающего списка.
2. **Импорт людей**:
   * При импорте посетителей в PassOffice автоматически проставляется **Организация** (существует только в PassOffice).
   * Подразделение в PassOffice создается с обязательной привязкой к организации.
3. **Группа доступа для посетителей**:
   * У посетителей может быть назначена **только одна группа доступа**.
4. **Поддерживаемые типы пропусков**:
   * **Гостевой**: Для временных посетителей.
   * **Замена**: Замена существующего пропуска (старый деактивируется).
   * **Заявка на доступ**: Доступ заменяется, а не добавляется к существующему.
   * **Продление доступа**: Продление срока действия текущего доступа.
   * **Ограничение:** У человека может быть только один пропуск.
5. **Блокировка и разблокировка**:
   * Функции блокировки и разблокировки пропуска **не поддерживаются**.