# PERCo-Web

Журнал проходов PERCo, табель и пропуска новичкам без ручных выгрузок

Журнал проходов, пропуска и учёт рабочего времени

## Как агент работает с PERCo-Web

Агент работает с сервером PERCo-Web через модуль PERCo-WM04 «Интеграция с внешними системами»: это HTTP API на 337 методов, описанное самим вендором. Из него читаются сотрудники, посетители, подразделения и должности, карты доступа, шаблоны доступа и помещения, журнал проходов, события системы, графики работы и отчёты учёта рабочего времени.

Сервер PERCo-Web обычно стоит в локальной сети. Тогда запросы идут через приложение на компьютере, который видит этот сервер, как у 1С: адрес из подключения остаётся внутренним и наружу не публикуется. Если сервер опубликован по https, агент обращается к нему напрямую.

Табель и опоздания агент берёт из отчётов учёта рабочего времени PERCo, если активна лицензия TimeTracking. Без неё он считает первый вход и последний выход по журналу проходов и сверяет их с графиком, а ночные смены относит к дню начала смены.

По умолчанию агент только читает. Завести сотрудника, выдать карту, назначить шаблон доступа он может по вашей просьбе и после подтверждения. Открыть дверь или пропустить человека через турникет агент сам не предлагает: это физический доступ на объект, и такую команду он выполняет только по прямому поручению с названием устройства.

## Сценарии интеграции

### Опоздания и ранние уходы
Агент возьмёт журнал проходов за период, найдёт первый вход и последний выход каждого сотрудника по дням и сравнит их с графиком работы.

### Табель из проходных
Агент соберёт отработанные часы по подразделению за месяц: из отчётов учёта рабочего времени PERCo, а без этой лицензии посчитает их по журналу проходов.

### Пропуск новому сотруднику
Агент заведёт сотрудника в нужное подразделение и должность, выдаст свободную карту и назначит шаблон доступа, предварительно показав, что именно запишет.

### Кто сейчас на объекте
Агент покажет, кто находится в помещениях прямо сейчас и сколько людей внутри, по данным местонахождения PERCo.

### Карты и доступы уволенных
Агент сверит уволенных сотрудников с выданными картами и шаблонами доступа и соберёт список пропусков, которые пора отозвать.

### Состояние оборудования
Агент проверит связь с контроллерами, найдёт устройства с непереданными изменениями и перечислит события оборудования за сутки.

## Как подключить

**Перед подключением**

- Сервер PERCo-Web с активной лицензией PERCo-WM04 (входит в пакет Standard)
- Отдельный оператор PERCo-Web для интеграции, без двухфакторного входа
- Для отчётов учёта рабочего времени: лицензия TimeTracking

### Включите лицензию PERCo-WM04
В PERCo-Web откройте «Администрирование» → «Лицензии» и активируйте модуль PERCo-WM04 «Интеграция с внешними системами»: без него API не отвечает.

### Заведите роль для интеграции
В «Администрирование» → «Роли» создайте роль с правами на чтение сотрудников, подразделений, карт и отчётов. Запись дайте, только если агент будет заводить пропуска.

### Создайте отдельного оператора
Создайте оператора с этой ролью, латинским логином и без двухфакторного входа. Его логин и пароль вы укажете при подключении.

### Проверьте адрес сервера
Откройте адрес PERCo-Web в браузере на компьютере, где запущено приложение: если вход в веб-интерфейс открывается, агент дойдёт до сервера тем же путём.

## Частые вопросы

### Как подключить PERCo-Web?
Тремя полями: адрес веб-интерфейса PERCo-Web, как его открывают в браузере, логин и пароль отдельного оператора. Права агенту задаёт роль этого оператора в разделе «Администрирование».

### Сервер стоит во внутренней сети. Это сработает?
Да. Запросы пойдут через приложение на компьютере, который видит сервер PERCo-Web, наружу его публиковать не нужно.

### Может ли агент открыть дверь?
Только по вашему прямому поручению с названием двери и команды. В сценариях по умолчанию таких действий нет.

### Нужна ли лицензия учёта рабочего времени?
Для готовых отчётов PERCo да. Без неё агент считает табель и опоздания сам, по журналу проходов из базового пакета.

[Открыть PERCo-Web](https://www.perco.ru/products/perco-wm-04-integratsiya-s-vneshnimi-sistemami.php)