Типовые кейсы использования Integration API

Обновлено: 27.04.2026

НазначениеНазначение

Integration API используется для построения интеграций между Timetta и другими корпоративными системами. Его основная задача — не разовое выполнение операций, а автоматизированный обмен данными: создание, обновление и синхронизация сущностей Timetta из внешних сервисов.

В Timetta доступны два API:

• Reporting API предоставляет отчётные данные в виде плоских таблиц.
• Integration API предназначено для работы с отдельными сущностями и их экземплярами.

Integration API следует использовать, когда внешняя система должна не просто получать данные для анализа, а изменять состояние сущностей в Timetta.

Когда использование Integration API оправданоКогда использование Integration API оправдано

Integration API целесообразно использовать, если выполняется хотя бы одно из следующих условий:

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

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

Типовые кейсы использованияТиповые кейсы использования

1. Синхронизация сотрудников и организационной структуры1. Синхронизация сотрудников и организационной структуры

Один из наиболее распространённых сценариев — интеграция с HRM-, HCM- или кадровой системой, где ведётся мастер-список сотрудников.

Такой кейс актуален, если в компании регулярно меняются, например:

• сотрудники;
• подразделения;
• руководители;
• должности;
• статусы занятости;
• контактные данные.

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

С помощью Integration API можно автоматически передавать в Timetta:

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

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

2. Синхронизация клиентов и контрагентов2. Синхронизация клиентов и контрагентов

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

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

Через API можно синхронизировать:

• организации;
• реквизиты;
• ответственных менеджеров;
• контактные данные;
• внешние идентификаторы.

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

3. Создание и обновление проектов из внешнего процесса3. Создание и обновление проектов из внешнего процесса

Integration API целесообразно использовать, если проект в Timetta должен создаваться как результат события во внешней системе.

Например:

• сделка во внешней CRM перешла в статус «Выиграна»;
• заявка на проект утверждена на корпоративном портале;
• инвестиционная инициатива прошла предварительное согласование.

В этом случае внешняя система может создать проект в Timetta и передать основные параметры: наименование, менеджера, даты, валюту, тип учёта, программу, портфель или внешний идентификатор.

В дальнейшем интеграция может обновлять отдельные свойства проекта, такие как:

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

4. Интеграция с финансовой или ERP-системой4. Интеграция с финансовой или ERP-системой

Integration API можно использовать для связи Timetta с финансовой, управленческой или учётной системой.

Такой сценарий оправдан, если финансовый процесс охватывает несколько контуров: проектное планирование и исполнение — в Timetta, а часть учётных, договорных или казначейских операций — во внешней системе.

Примеры задач:

• передача проектных и клиентских данных в ERP;
• синхронизация финансовых справочников;
• обновление признаков, необходимых для закрытия периода;
• передача или сверка статусов счетов, актов, оплат;
• поддержка связей между проектом Timetta и объектами учётной системы.

Важно разделять задачи: если внешней системе нужны только данные для аналитики, чаще подходит Reporting API. Если требуется создавать или изменять объекты — нужен Integration API.

5. Интеграция с системой электронного документооборота5. Интеграция с системой электронного документооборота

Если договоры, акты, дополнительные соглашения и другие документы согласуются во внешней СЭД, Integration API может связывать документооборот с проектными и финансовыми процессами Timetta.

Сценарий оправдан, когда статус документа должен влиять на работу в Timetta. Например:

• после согласования договора проект можно перевести в рабочее состояние;
• после подписания акта — обновить дату или статус;
• данные проекта можно передавать во внешнюю систему для формирования документа.

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

6. Централизованное ведение справочников и классификаторов6. Централизованное ведение справочников и классификаторов

Во многих компаниях часть справочников ведётся централизованно: в ERP, MDM, HRM или другой мастер-системе. Если эти справочники используются в Timetta, Integration API позволяет поддерживать их актуальность.

К таким справочникам относятся:

• подразделения;
• должности;
• юридические лица;
• центры затрат;
• классификаторы проектов;
• категории клиентов;
• финансовые статьи;
• внутренние коды и аналитики.

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

7. Встраивание Timetta в корпоративный портал или self-service процесс7. Встраивание Timetta в корпоративный портал или self-service процесс

Иногда пользователи взаимодействуют с Timetta не напрямую, а через корпоративный портал или внутренний self-service интерфейс. Например, там создаются заявки на:

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

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

Практические рекомендацииПрактические рекомендации

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

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

Также следует придерживаться следующих практик:

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

ИтогИтог

Integration API — это инструмент для устойчивого обмена данными между Timetta и корпоративным ИТ-ландшафтом. Его стоит использовать, когда Timetta должна быть связана с HR, CRM, ERP, СЭД, MDM, корпоративным порталом или другой системой, а данные должны передаваться регулярно и без ручного дублирования.

Для разовых ручных операций API не требуется. Для аналитики чаще подходит Reporting API. Для создания, изменения и синхронизации объектов Timetta — Integration API.