Управление аккаунтом сотрудника в Яндекс 360 через n8n для 1C:ЗУП 3.1

Область применения

n8n — это современная open-source платформа для автоматизации рабочих процессов (workflow automation), которая позволяет легко связывать различные сервисы и приложения через визуальный интерфейс или JSON-конфигурации. Основные преимущества технологии n8n:

• Универсальность: поддерживает интеграцию с сотнями сервисов (включая HTTP-запросы, Telegram, базы данных и т.д.), что делает её универсальным инструментом для автоматизации.
• Гибкость: позволяет быстро адаптировать процессы без необходимости изменения кода 1С или прямой интеграции с каждым новым сервисом.
• Простота масштабирования: добавление новых интеграций сводится к настройке дополнительных рабочих процессов (workflows) в n8n, а не к переработке кода 1С.
• Отказоустойчивость: n8n может обрабатывать ошибки, логировать действия и отправлять уведомления (например, через Telegram), что упрощает мониторинг.

Почему интеграцию 1С лучше делать через n8n, а не напрямую с каждым сервисом?

Прямая интеграция 1С с внешними сервисами требует индивидуальной разработки для каждого API, что увеличивает затраты времени и ресурсов на поддержку. n8n выступает в роли "посредника", позволяя централизовать логику интеграции, минимизировать изменения в 1С и упростить дальнейшее расширение функциональности. Например, для добавления уведомлений в Telegram или интеграции с другим сервисом достаточно изменить настройки n8n, а не переписывать код в 1С.

Технические требования

Работа расширения проверена на конфигурации:

• 1C:Зарплата и управление персоналом, 3.1.30.117
• Код открыт
• Внимание! Расширение не работает на БАЗОВЫХ конфигурациях (в базовых конфигурациях 1С, возможности подключения расширений - отсутствуют
• Возможна адаптация расширения под другие конфигурации 1С/потребности клиента.

Функциональные возможности расширения n8n

1. Автоматическое создание учетных записей:
   • При приеме нового сотрудника в 1С создается учетная запись в Яндекс 360 с уникальным никнеймом, паролем и данными (ФИО, email, телефон, должность).
2. Обновление данных:
   • При изменении данных сотрудника (например, ФИО или должности) информация синхронизируется с Яндекс 360.
3. Блокировка учетных записей:
   • При увольнении сотрудника его учетная запись в Яндекс 360 отключается.
4. Сопоставление существующих данных:
   • Возможность ручного сопоставления сотрудников 1С с пользователями Яндекс 360 через обработку.
5. Логирование и мониторинг:
   • Успешные операции и ошибки фиксируются в журнале регистрации 1С.
   • Уведомления об операциях отправляются в Telegram через n8n.

Преимущества для администратора

1. Автоматизация рутинных задач:
   • Исключение ручного создания и блокировки учетных записей в Яндекс 360.
2. Снижение ошибок:
   • Автоматическое формирование никнеймов и синхронизация данных минимизируют человеческий фактор.
3. Гибкость и масштабируемость:
   • Благодаря n8n можно легко добавить новые интеграции (например, уведомления в мессенджеры или синхронизацию с другими сервисами) без изменения кода 1С.
4. Удобство мониторинга:
   • Уведомления в Telegram и логи в 1С позволяют быстро реагировать на проблемы.
5. Экономия времени:
   • Администратору не нужно вручную поддерживать соответствие данных между 1С и Яндекс 360.

Подходы к разработке расширения

1. Минимальное вмешательство в базовую конфигурацию: Расширение использует механизмы подписок на события и добавляет собственные объекты, не изменяя стандартные объекты 1С:ЗУП.
2. Модульность: Логика разделена на области (API, регистрация событий, обработка событий, сервисные функции) для удобства поддержки и расширения.
3. Асинхронность: Использование независимого сервера n8n позволяет избежать блокировки работы 1С при выполнении внешних запросов.
4. Логирование: Ошибки и успешные операции фиксируются в журнале регистрации 1С для упрощения диагностики.

Ограничения текущей версии

1. Работа только с одной организацией в Яндексе. Т.е. в 1С:ЗУП у вас может быть сколько угодно организаций или сколько угодно баз ЗУП – все будет работать если в Яндексе у вас 1 компания на 1 домен. Это не ограничение Яндекса или 1С – это ограничение текущей версии расширения. Технически нет ограничений реализовать управление несколькими организациями Яндекса.
2. Реализовано только 2 метода для справочника «users»: «Добавить» и «Изменить информацию». Блокировка пользователя выполняется через «Изменить…» путем передачи только 1 ключа «isEnabled» с флагом «false». Разблокировки из 1С нет, только вручную из web-интерфейса Яндекса.

Техническая поддержка и обновления

Бесплатный период техподдержки составляет 1 месяц со дня покупки.

Также после приобретения вы получаете 1 месяц бесплатных обновлений.

По окончании бесплатного периода вы можете приобрести услугу технической поддержки с доступом к обновлениям на платной основе.

Проверить наличие обновлений можно в личном кабинете. Если обновления недоступны - загрузить новую версию можно после покупки обновлений/технической поддержки.

Задать вопрос по программе можно по кнопке "Техподдержка" на странице описания.

При создании тикета необходимо предоставить:

1. Номер заказа
2. Описание вопроса. Если это ошибки - напишите порядок ваших действий с программой, которые к ней привели (приложите видео/скриншоты/отчеты об ошибке)
3. Точную конфигурацию 1С, и версию платформы, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.

К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения

Внимание! Техническая поддержка предоставляется исключительно в рамках переписки по обращению. В некоторых случаях для диагностики ошибок и/или вопросов, связанных с особенностями использования продукта в информационных базах покупателя, может потребоваться дополнительная платная диагностика с организацией удаленного доступа к информационной базе. Стоимость уточняется индивидуально.

Техподдержка