Synchra.24
menu_bookDocumentation
Practical guides for setup and development

Find guides for getting started, building workflows and adding your own tools to your company workspace.

folderIntegrations and APIs

Introduction

What are Open APIs and Synchra integrations for?24 and what tasks they help to solve.

Translation is currently unavailable. The original is shown.

Интеграции и Open API нужны для того, чтобы Synchra.24 не оставалась изолированным приложением, а становилась частью вашей рабочей среды. Это особенно важно, если в компании уже есть другие системы, отчеты, сервисы или внутренние процессы, с которыми нужно обмениваться данными.

Для чего нужны интеграции

Интеграции помогают связать Synchra.24 с теми инструментами, которые уже используются в компании. Благодаря этому сотрудники и руководители не дублируют информацию вручную и не тратят время на перенос данных между системами.

Обычно интеграции нужны, чтобы:

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

Для чего нужен Open API

Open API — это способ безопасно и предсказуемо обращаться к данным и действиям платформы из внешних систем.

Если говорить проще, Open API нужен, когда вы хотите:

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

Какие задачи это решает на практике

Вот несколько типовых сценариев:

Синхронизация структуры компании

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

Выгрузка рабочего времени

Компания может забирать данные об отработанном времени и сессиях сотрудников в свои отчеты или учетные системы.

Обмен заявками и статусами

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

Подключение собственных сервисов

Если у вас есть внутренние инструменты, Open API и встраиваемые сервисы позволяют связать их с Synchra.24 и использовать внутри одного рабочего контура.

Автоматизация событий

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

Если данные нужно получать и отправлять по расписанию без отдельного интеграционного сервера, используйте встроенные Автоматизации Synchra24. В них можно описать HTTP-источники и назначения в YAML или JSON, преобразовать XML, CSV и JSON с помощью JavaScript и проверить результат до рабочей отправки.

Когда компании обычно начинают использовать API

Обычно к API и интеграциям приходят в одном из таких случаев:

  • сотрудников стало много, и ручной перенос данных больше не работает;
  • нужно объединить Synchra.24 с уже существующей IT-средой;
  • руководству нужны собственные отчеты и аналитика;
  • в компании есть подрядчик или внутренняя команда разработки, которая поддерживает корпоративные системы.

Чем Open API отличается от встроенных сервисов

Это два похожих, но разных инструмента.

Open API

Подходит, когда нужно:

  • обмениваться данными между системами;
  • строить автоматические сценарии;
  • делать интеграции на уровне backend или корпоративных сервисов.

Встроенные сервисы

Подходят, когда нужно:

  • добавить свой интерфейс внутрь компании;
  • создать собственный экран для сотрудников;
  • встроить внутренний инструмент прямо в Synchra.24.

На практике компании часто используют оба подхода одновременно:

  • через API связывают системы,
  • через встроенные сервисы дают сотрудникам удобный интерфейс внутри приложения.

Что стоит продумать перед началом интеграции

Перед запуском интеграции полезно заранее ответить на несколько вопросов:

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

Если это понятно с самого начала, интеграция запускается заметно быстрее и стабильнее.

С чего лучше начать

Если вы только планируете интеграции, обычно удобнее идти так:

  1. определить один самый полезный сценарий;
  2. понять, какие данные для него нужны;
  3. описать направление обмена данными;
  4. проверить, хватит ли Open API или нужен еще встроенный сервис;
  5. после первого рабочего сценария постепенно расширять интеграцию.

Что дальше

Этот раздел документации нужен как отправная точка. Дальше в нем можно подробно описывать:

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

Если вы только начинаете знакомство с возможностями Synchra.24, лучше воспринимать Open API и интеграции не как “техническую опцию”, а как способ встроить платформу в уже существующие процессы бизнеса.