Synchra.24
arrow_backВсе новости
newspaperНовости Synchra24

Интеграционный движок автоматизаций в Synchra24

Интеграционный движок Synchra24 получает данные из 1С и других систем, преобразует их, загружает в рабочие сервисы и передаёт наружу по расписанию или событиям.

В Synchra24 появился интеграционный движок автоматизаций. Он помогает связать рабочие процессы компании с 1С, учётными системами и другими корпоративными сервисами без отдельного сервера для каждого сценария обмена.

Автоматизация может получить данные из внешнего API или внутреннего события, проверить условия, преобразовать информацию и отправить результат в одну или несколько систем, включая сервисы Synchra24 через Open API. Настройка, проверка и история запусков собраны в панели администратора.

Обмен данными в обе стороны

Движок работает не только на выгрузку. В одном сценарии Synchra24 может быть источником данных, а в другом — системой, которая их получает.

Например, автоматизация может:

  • получить из 1С или ERP данные о сотрудниках, графиках или заданиях, привести их к нужной структуре и загрузить в поддерживаемый сервис Synchra24 через Open API;
  • после завершения смены передать фактическое рабочее время в учётную систему;
  • регулярно сверять данные во внешнем справочнике и обновлять связанные записи;
  • собрать информацию из нескольких API, объединить её и отправить результат сразу в несколько систем.

Для двусторонней синхронизации создаются отдельные понятные сценарии для каждого направления. Так проще контролировать расписание, правила преобразования, доступы и историю обмена.

Три способа запуска

Для разных задач доступны три режима:

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

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

События авторизации и корпоративного чата в интеграционный контур не входят. Движок работает с бизнес-действиями внутри компании и передаёт только данные, необходимые для выбранного сценария.

Как устроена автоматизация

Каждый сценарий состоит из нескольких понятных частей:

  1. Триггер определяет момент запуска.
  2. Источник получает данные из внешнего HTTP API, если они нужны сценарию.
  3. Условия отсеивают события, которые не требуют обработки.
  4. JavaScript-обработчик приводит данные к нужной структуре.
  5. Назначение передаёт результат во внешний API или в нужный сервис Synchra24.

Одна автоматизация может обращаться к нескольким источникам и отправлять результат в несколько назначений. Движок поддерживает JSON, XML, CSV, TSV и обычный текст, поэтому подходит как для современных API, так и для привычных форматов обмена.

Например, компания может регулярно получать данные из одной системы, объединять их со справочником сотрудников и передавать подготовленный результат в учётный контур или обратно в рабочие сервисы. Другой сценарий может запускаться после завершения смены и отправлять фактическое рабочее время для дальнейшего расчёта.

Редактор интеграционной автоматизации с конфигурацией pipeline в Synchra24
В редакторе задаются триггер, источники, преобразование данных и назначения

JavaScript-обработчики с помощью AI-агента

Логику преобразования можно написать вручную на JavaScript или подготовить с помощью встроенного AI-агента. Достаточно описать обычным языком, какие данные нужно выбрать, проверить, переименовать или собрать в итоговую структуру. Агент учтёт конфигурацию сценария и пример входных данных, а затем предложит готовую функцию transform(input, context).

Такой подход позволяет собирать обработчики в формате вайб-кодинга, даже если пользователь не пишет JavaScript каждый день. Предложенный код остаётся доступным для просмотра и редактирования: его можно доработать вместе с агентом, проверить на тестовых данных и только затем вставить в автоматизацию.

Секретные переменные — токены, API-ключи и пароли — AI-агенту не передаются.

Рабочие события как основа интеграций

Автоматизации могут реагировать на события из основных сервисов Synchra24: учёта времени, задач, заявок, документов, отчётов, кассы, отпусков, квалификаций, нарядов, графиков, биржи смен, выездных работ и других рабочих разделов.

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

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

Проверка, история и защита данных

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

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

Для событий предусмотрена защита от повторного запуска по одному идентификатору. Асинхронная обработка не задерживает основное действие пользователя: задача, заявка или изменение графика сохраняются независимо от ответа внешнего сервиса.

AI-помощник для подготовки JavaScript-обработчика автоматизации
AI-помощник помогает подготовить преобразование данных
Результаты проверочного запуска интеграционной автоматизации
Проверочный запуск показывает входные данные, результат и логи

Где настроить

Интеграционный движок доступен в Web-интерфейсе в разделе Администратор → Автоматизации. Там можно создать сценарий, добавить секретные переменные, проверить обработчик, включить расписание или выбрать рабочее событие.

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