Настройка обмена 1С:Зарплата и управление персоналом и Битрикс24
Обмен между 1С:ЗУП и Битрикс24 — это синхронизация HR-данных: структура компании, сотрудники, отпуска, больничные. Цель — устранить двойной ввод данных: кадровые изменения заводятся в 1С:ЗУП (как основную кадровую систему), а в Битрикс24 они отражаются автоматически.
Что синхронизируется
Из 1С:ЗУП в Битрикс24:
- Организационная структура (подразделения → отделы Битрикс24)
- Сотрудники (создание/обновление/увольнение пользователей Битрикс24)
- Должности
- Отпуска и больничные → Отсутствия в Битрикс24
Из Битрикс24 в 1С:ЗУП:
- Заявки на отпуск (согласованные через бизнес-процесс Битрикс24)
- Данные о переработках (из учёта рабочего времени Битрикс24, если используется)
Механизм интеграции
Стандартного CommerceML-протокола для ЗУП нет. Интеграция строится через:
REST API Битрикс24 — для создания и обновления пользователей, отделов, отсутствий. Основные методы:
-
user.add,user.update— управление пользователями -
department.add,department.update— отделы -
timeman.absence.add— добавление отсутствия
HTTP-сервис или внешняя обработка в 1С:ЗУП — инициирует обмен по расписанию или при событии (приём сотрудника, изменение должности, плановый отпуск).
Синхронизация сотрудников
При приёме нового сотрудника в 1С:ЗУП:
- Обработка ЗУП формирует запрос к REST API Битрикс24
user.add. - Создаётся пользователь Битрикс24 с указанием отдела, должности, руководителя.
- Пользователю автоматически высылается приглашение (если настроено в Битрикс24).
При увольнении — user.update с параметром ACTIVE = N (деактивация без удаления, данные сохраняются).
POST https://portal.bitrix24.ru/rest/{userId}/{token}/user.add
{
"NAME": "Иван",
"LAST_NAME": "Петров",
"EMAIL": "[email protected]",
"UF_DEPARTMENT": [departmentId],
"WORK_POSITION": "Менеджер",
"ACTIVE": true
}
Синхронизация отпусков
Отпуска из 1С:ЗУП → Битрикс24:
- Метод
timeman.absence.addдобавляет запись об отсутствии сотруднику - Тип отсутствия (отпуск, больничный, командировка) маппируется из кодов ЗУП на типы Битрикс24
Заявки на отпуск из Битрикс24 → 1С:ЗУП:
- Настраивается бизнес-процесс согласования отпуска в Битрикс24
- При финальном согласовании БП запускает вебхук или действие, отправляющее данные в HTTP-сервис 1С:ЗУП
- В ЗУП автоматически создаётся плановое отсутствие
Маппинг структуры компании
Структура подразделений в 1С:ЗУП и в Битрикс24 может не совпадать. При первоначальной настройке:
- Из 1С:ЗУП выгружаем дерево подразделений
- В Битрикс24 создаём соответствующие отделы через
department.add - Сохраняем соответствие:
[ID в ЗУП] → [ID в Битрикс24]в таблице маппинга (в ЗУП — регистр сведений, в Битрикс24 — user-field или отдельная сущность)
Авторизация
Интеграция работает через OAuth 2.0 или входящий вебхук Битрикс24. Для продакшн-решения — серверное OAuth-приложение: токен обновляется автоматически, нет привязки к конкретному пользователю.
Ограничения
- Битрикс24 не является полноценной HR-системой — данные о зарплатах, налогах и расчётах в Битрикс24 не передаются
- Двусторонняя синхронизация требует настройки логики «источника правды» (в случае конфликта — данные ЗУП приоритетны)