Налаштування обміну 1С:Зарплата та управління персоналом та Бітрикс24
Обмін між 1С:ЗУП та Бітрикс24 — це синхронізація HR-даних: структура компанії, працівники, відпустки, лікарні. Мета — усунути подвійний ввід даних: кадрові зміни вводяться у 1С:ЗУП (як основну систему управління кадрами), а у Бітрикс24 вони відображаються автоматично.
Що синхронізується
З 1С:ЗУП у Бітрикс24:
- Організаційна структура (підрозділи → відділи Бітрикса)
- Працівники (створення/оновлення/звільнення користувачів Бітрикса)
- Посади
- Відпустки та лікарні → Відсутності у Бітриксі
З Бітрикса у 1С:ЗУП:
- Заявки на відпустку (узгоджені через бізнес-процес Бітрикса)
- Дані про переробітки (з обліку робочого часу Бітрикса, якщо використовується)
Механізм інтеграції
Стандартного CommerceML-протоколу для ЗУП немає. Інтеграція будується через:
REST API Бітрикс24 — для створення та оновлення користувачів, відділів, відсутностей. Основні методи:
-
user.add,user.update— управління користувачами -
department.add,department.update— відділи -
timeman.absence.add— додавання відсутності
HTTP-сервіс або зовнішня обробка у 1С:ЗУП — ініціює обмін за розписанням або при подіях (прийняття працівника, зміна посади, планова відпустка).
Синхронізація працівників
При прийманні нового працівника у 1С:ЗУП:
- Обробка ЗУП формує запит до REST API Бітрикса
user.add. - Створюється користувач Бітрикса з вказанням відділу, посади, керівника.
- Користувачу автоматично надсилається запрошення (якщо налаштовано у Бітриксі).
При звільненні — 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додає запис про відсутність працівникові - Тип відсутності (відпустка, лікарня, командировка) маппується з кодів ЗУП на типи Бітрикса
Заявки на відпустку з Бітрикса → 1С:ЗУП:
- Налаштовується бізнес-процес узгодження відпустки у Бітриксі
- При фінальному узгодженні БП запускає вебхук або дію, що відправляє дані у HTTP-сервіс 1С:ЗУП
- У ЗУП автоматично створюється планова відсутність
Маппінг структури компанії
Структура підрозділів у 1С:ЗУП та у Бітриксі може не збігатися. При первинному налаштуванні:
- З 1С:ЗУП вивантажуємо дерево підрозділів
- У Бітриксі створюємо відповідні відділи через
department.add - Зберігаємо відповідність:
[ID у ЗУП] → [ID у Бітриксі]у таблиці маппінгу (у ЗУП — регістр відомостей, у Бітриксі — user-field або окрема сутність)
Авторизація
Інтеграція працює через OAuth 2.0 або вхідний вебхук Бітрикса. Для продакшн-рішення — серверне OAuth-додаток: токен оновлюється автоматично, не прив'язується до конкретного користувача.
Обмеження
- Бітрикс24 не є повнофункціональною HR-системою — дані про зарплату, податки та розрахунки не передаються у Бітрикс24
- Двостороння синхронізація вимагає налаштування логіки «джерела істини» (у разі конфлікту — дані ЗУП приоритетні)