Обзор · Интеграции

Интеграции

«Табель» не живёт сам по себе: штат приходит из кадровой системы, отметки — из СКУД, закрытые часы уходят в расчёт зарплаты. Ниже — что подключается и как.

Расчёт зарплаты и кадры

Система	Как	Что передаётся	Состояние
1С:Зарплата и управление персоналом 3.1	внешняя обработка + веб-сервис	штат, приказы, ЭЛН → часы, переработки, ночные	рабочая
1С:Зарплата и кадры бюджетного учреждения 3.1	внешняя обработка	штат, приказы → часы по кодам Т-13	рабочая
1С:Управление производственным предприятием 1.3	обмен через файл	штат → часы	рабочая
БОСС-Кадровик	обмен через файл по расписанию	штат → часы, отсутствия	рабочая
SAP HCM	веб-сервис, контур «Холдинг»	штат, инфо-типы отсутствий → часы	рабочая
Контур.Персонал	обмен через файл	штат → часы	в работе, 2 кв. 2026

Для 1С:ЗУП 3.1 поставляется внешняя обработка — её ставит наш инженер на внедрении, доработок конфигурации не требуется. Обмен идёт по расписанию раз в час либо по кнопке в закрытом месяце.

Системы контроля доступа

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

Sigur — проходы из базы контроллера, опрос раз в 5 минут.
PERCo-Web — события проходов по подписке.
RusGuard — события из серверной части, опрос раз в 10 минут.
Biosmart — отметки по отпечатку и лицу.

Если СКУД другая

Подойдёт выгрузка событий проходов в CSV или XLSX: нужны табельный номер (или номер карты), дата, время и направление прохода. Файл кладётся в каталог обмена, сервис забирает его по расписанию.

Сопоставление «номер карты — сотрудник» делается один раз на внедрении и потом поддерживается кадровой системой.

Программный интерфейс

Если в компании своё приложение для мастеров или мобильный клиент — отметки можно отдавать напрямую. Интерфейс простой: один адрес для потока отметок, один — для получения графика.

POST /shift/batch HTTP/1.1
Host: tabel.keysgroup.site
Content-Type: application/json
X-Tabel-Key: <ключ подразделения>

{"device":"TB-2214","batch":417,"marks":[
  {"emp":"04418","at":"2026-04-08T07:58:12+03:00","kind":"in"},
  {"emp":"04418","at":"2026-04-08T19:04:40+03:00","kind":"out","over":180}
]}

Поле batch — номер пачки, он же защита от дублей: повторная отправка той же пачки часов не задвоит, сервис ответит 200 и числом принятых отметок. Поле over — минуты сверх графика, они попадут в переработку только после согласования руководителем.

Адрес	Метод	Назначение	Предел
`/shift/batch`	POST	пачка отметок с устройства	500 отметок в пачке
`/shift/plan`	GET	график подразделения на период	62 дня за запрос
`/staff/list`	GET	список сотрудников подразделения	60 запросов в час
`/month/export`	GET	закрытый месяц, XLSX или JSON	только после закрытия

Ключ подразделения выдаётся в кабинете и действует год. Ключ только на запись отметок своего подразделения — прочитать им чужой табель или закрыть месяц нельзя.

Уведомления

Напоминания табельщику и руководителям уходят на почту, а при желании — в корпоративный мессенджер по входящему адресу: поддержаны VK Teams, Mattermost и Rocket.Chat. Уведомления настраиваются по событиям: смена не закрыта к утру, есть несогласованные переработки, до конца месяца три дня.