Интеграция СКУД с 1С:ЗУП и ERP для учета рабочего времени (УРВ)
- События проходов фиксируются в СКУД, но не выгружаются в документ «Табель учета рабочего времени» (форма Т-13) в 1С:ЗУП.
- Ошибки авторизации REST API / SOAP web-services:
HTTP 401 UnauthorizedилиHTTP 500 Internal Server Errorпри обращении 1С к шлюзу СКУД. - Дублирование табельных номеров или задвоение физических лиц при автосинхронизации кадровых изменений.
- Некорректный подсчет сверхурочных, опозданий и межтерриториальных перемещений сотрудников между филиалами.
1. Архитектура интеграции и выбор протокола
Интеграция СКУД и 1С реализуется по двум моделям: прямая интеграция на уровне СУБД (MS SQL / PostgreSQL staging table) или через регламентные фоновые задания 1С с обращением к REST API / SOAP веб-сервису контроллера СКУД.
2. Настройка HTTP-сервиса обмена и прав доступа
// Пример HTTP-запроса на получение событий проходов из 1С
HTTPСоединение = Новый HTTPСоединение("skud-server.corp.local", 8443, "api_user", "SecurePass123",,, Новый ЗащищенноеСоединениеOpenSSL());
HTTPЗапрос = Новый HTTPЗапрос("/api/v2/events?from=" + Формат(ДатаНачала, "ДФ=yyyy-MM-ddTHH:mm:ss") + "&to=" + Формат(ДатаКонца, "ДФ=yyyy-MM-ddTHH:mm:ss"));
HTTPОтвет = HTTPСоединение.Получить(HTTPЗапрос);
Если HTTPОтвет.КодСостояния = 200 Тогда
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(HTTPОтвет.ПолучитьТелоКакСтроку());
ДанныеСобытий = ПрочитатьJSON(ЧтениеJSON);
КонецЕсли;3. Сопоставление идентификаторов (GUID и табельный номер)
Для предотвращения коллизий при переименовании отделов или смене ФИО привязка карточек СКУД должна выполняться строго по уникальному идентификатору Employee_GUID или уникальному неизменяемому Табельному номеру, а не по ФИО.
4. Настройка алгоритмов расчета рабочего времени в 1С:ЗУП
- Первый вход — последний выход: используется при наличии турникетов на внешнем периметре предприятия.
- Суммированный учет по зонам: для предприятий с внутренними режимными помещениями и технологическими перерывами.
- Игнорирование транзитных проходов: отсечение повторных считываний карты в течение таймаута (anti-passback suppression, фильтр 60–180 сек).
5. Настройка регламентных заданий и отказоустойчивости
# Проверка статуса службы интеграционного шлюза на сервере СКУД
systemctl status skud-1c-sync-service
# Проверка сетевой доступности порта API со стороны сервера 1С:Предприятие
nc -zvw3 skud-server.corp.local 8443 Частые вопросы (FAQ)
Как обрабатывать проходы сотрудников, работающих в ночные смены (переход через полночь)?
В настройках профиля учета рабочего времени в СКУД и 1С:ЗУП активируется режим 'Смена с переходом через сутки'. Событие входа привязывается к дате начала смены по утвержденному индивидуальному графику сотрудника, предотвращая разрыв смены на два отдельных дня.
Почему при синхронизации блокируются активные карты сотрудников?
Это происходит, если в 1С проведен кадровый документ 'Увольнение' или 'Отстранение от работы' будущей датой, а интеграционный модуль не проверяет флаг даты фактического вступления приказа в силу, мгновенно отправляя команду деактивации карты в контроллер.
Как избежать перегрузки сервера СКУД при синхронизации сотен тысяч проходов?
Используйте пакетную выгрузку (пагинацию по limit/offset) событиями не более 500-1000 записей за один HTTP-запрос и настройте инкрементальный сбор данных через регламентное задание 1С каждые 5-15 минут вместо одного массивного ночного запроса.
Что делать, если сотрудник забыл карту и прошел по гостевому или дежурному пропуску?
В СКУД оформляется временная привязка дублирующего пропуска к табельному номеру сотрудника с обязательным указанием временного интервала действия, чтобы события прохода корректно попали в его личную карточку Т-13 в 1С.