Быстрый старт

В этом разделе описаны минимально необходимые шаги для запуска синхронизации между 1С:ЗУП и Bitrix24.

Шаг 1. Установка модуля в Bitrix24

Модуль устанавливается на коробочную версию Bitrix24.

1. Загрузите ZIP-архив модуля (tss.zup.exchange) в директорию `/local/modules/` на сервере Bitrix24 (через FTP/SFTP, SSH или файловый менеджер Bitrix).
2. Распакуйте архив — в папке `/local/modules/` должна появиться папка `tss.zup.exchange`.
3. Войдите в административную панель Bitrix24: `https://yoursite.com/bitrix/admin/`
4. Перейдите в Marketplace → Установленные решения (или Настройки → Модули).
5. Найдите модуль в списке и нажмите Установить.

Шаг 2. Установка расширения в 1С ЗУП

Расширение устанавливается в информационную базу 1С:ЗУП. Доступны два способа:

Через режим Предприятие (рекомендуется)

1. Запустите 1С:Предприятие и войдите под учётной записью администратора.
2. Перейдите в Администрирование → Печатные формы, отчёты и обработки → Расширения.
3. Нажмите Добавить из файла, выберите файл расширения .cfe и нажмите Открыть.
4. Убедитесь, что флаг Активно установлен напротив добавленного расширения.
5. Выйдите из системы и войдите заново — изменения вступят в силу.

Через Конфигуратор

1. Запустите 1С в режиме Конфигуратор.
2. Перейдите в Конфигурация → Расширения конфигурации....
3. Нажмите Добавить , затем через меню Конфигурация выберите Загрузить конфигурацию из файла... и укажите файл .cfe.
4. После добавления выполните Конфигурация → Обновить конфигурацию базы данных (F7).

Шаг 3. Первичная настройка синхронизации

После установки расширения необходимо настроить подключение к Bitrix24.

1. В 1С:ЗУП откройте раздел Администрирование.
2. В группе См. также выберите пункт Синхронизация с Bitrix24.
3. В блоке Синхронизация установите флажок Синхронизация с Bitrix24.
4. Нажмите ссылку Настройки синхронизации и заполните поля:
   • Адрес расположения api Bitrix24 — URL вида: https://ваш-портал.bitrix24.ru/rest/Идентификатор_пользователя/токен/
   • Количество попыток связи — рекомендуемое значение: 3.
5. Нажмите Записать и закрыть.

Шаг 4. Включение синхронизации структуры компании

1. В форме настроек модуля (Администрирование → Синхронизация с Bitrix24) в блоке Структура компании установите флажок Синхронизация структуры компании.
2. Нажмите ссылку Настройка синхронизации и заполните параметры:
   • Головная организация — выберите организацию, структура которой будет синхронизироваться с Bitrix24.
   • Выгрузка структуры компании — выберите нужный вариант фильтрации подразделений (Все, Только отмеченные или Все, за исключением отмеченных).
   • При определении не синхронизированных элементов — выберите действие (Удалить или Оставить).
   • При изменении наименования в Bitrix24 — выберите поведение (Переименовать или Оставить).
3. Нажмите Записать и закрыть.

Шаг 5. Включение синхронизации сотрудников

1. В форме настроек модуля в блоке Сотрудники установите флажок Сотрудники синхронизация с Bitrix24.
2. Нажмите ссылку Настройка синхронизации и заполните параметры:
   • Расположение данных о логине — укажите, где в 1С хранится логин сотрудника для сопоставления с Bitrix24 (Реквизит сотрудника, Дополнительный реквизит или Дополнительные сведения).
   • При необходимости включите Фильтровать выгрузку и настройте отборы по сотрудникам, должностям, подразделениям или виду занятости.
3. Нажмите Записать и закрыть.

Шаг 6. Включение логирования (опционально)

Логирование позволяет отслеживать все обращения к Bitrix24 и получать оповещения об ошибках.

Логирование в 1С ЗУП

1. В форме настроек модуля в блоке Логирование установите флажок Логирование взаимодействия с модулем.
2. Нажмите кнопку Настроить и выберите уровень логирования:
   • Все — фиксируются все запросы (рекомендуется при первичной настройке).
   • Только ошибки — фиксируются только ошибки (рекомендуется при стабильной работе).
3. Нажмите Записать и закрыть.
4. При необходимости включите Оповещать об ошибках синхронизации и настройте рассылку через кнопку Настроить.

Логирование в Bitrix24

1. В административной панели Bitrix24 перейдите в Сервисы → TSS: ЗУП <-> Битрикс24 → Настройки.
2. На вкладке Логирование установите флаг Включить логирование и выберите уровень логирования.
3. Нажмите Сохранить.

Шаг 7. Выполнение синхронизации через регламентные задания

Для автоматической синхронизации в 1С:ЗУП предусмотрены два регламентных задания:

• Синхронизация структуры компании — выполняет периодическую выгрузку организационной структуры в Bitrix24.
• Синхронизация отсутствий — выполняет периодическую выгрузку отпусков, больничных и других отсутствий в Bitrix24.

Для настройки расписания регламентных заданий:

1. Перейдите в Администрирование → Обслуживание → Регламентные и фоновые задания.
2. Найдите задания Синхронизация структуры компании и Синхронизация отсутствий.
3. Настройте расписание запуска для каждого задания.