Поделиться через

absentify (предварительная версия)

noify — это комплексное решение для управления отсутствием, разработанное для Microsoft 365. Этот соединитель обеспечивает простую интеграцию, позволяя автоматизировать рабочие процессы на основе запросов на отпуск сотрудников, отслеживать состояния утверждения и синхронизировать данные отсутствия в бизнес-системах.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя отсутствие поддержки
URL https://absentify.com/docs
Адрес электронной почты support@absentify.com
Метаданные соединителя
Publisher Решения BrainCore
Веб-сайт https://absentify.com
Политика конфиденциальности https://absentify.com/privacy-policy
Категории Кадровые ресурсы; Управление бизнесом

закрепить

отсутствие — это бесплатное средство, специально предназначенное для среды Microsoft 365 для эффективного управления отсутствием вашей команды или сотрудников. В ней представлен полный обзор всех временных отключений и указанных причин, что устраняет необходимость в глухих листах Excel. при отсутствии предлагает самый простой способ утвердить запросы на отпуск и праздники, полностью интегрированный с Microsoft Teams и Microsoft 365.

Издатель: BrainCore Solutions GmbH

Предпосылки

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

  • Teams: установите отсутствующее приложение Teams, запустите его и примите разрешения и согласие.
  • Веб: откройте отсутствовающее веб-приложение и примите разрешения и согласие.

Кроме того, вам потребуется план Essentials или более поздней версии, чтобы использовать триггеры этого соединителя.

Поддерживаемые операции

Соединитель поддерживает следующие операции:

Triggers

When a leave request is created

Этот триггер активируется при создании нового запроса в вашей компании.

When a leave request status changes

Этот триггер активируется при изменении состояния существующего запроса.

Операции API (требуется план плюса)

Для следующих операций требуется план отсутствий плюс.

Members

  • [Plus] Get all members — получение всех членов с дополнительными фильтрами для отделов, состояний, дат занятости и т. д.
  • [Plus] Invite a member — Пригласите нового участника в рабочую область.
  • [Plus] Get member by ID — получение определенного элемента по уникальному идентификатору.
  • [Plus] Update a member — обновите сведения о существующем члене.
  • [Plus] Delete a member — удаление элемента безвозвратно.
  • [Plus] Get member by Microsoft ID — получение члена по идентификатору пользователя Майкрософт.
  • [Plus] Get member by email — получение участника по адресу электронной почты.
  • [Plus] Get member by custom ID — получение элемента по пользовательскому идентификатору.
  • [Plus] Update member approvers — обновите утверждающих для определенного члена.
  • [Plus] Update member allowance — Обновите пособие члена в течение определенного года.
  • [Plus] Add member schedule — добавьте новое рабочее расписание для члена.

Отделы

  • [Plus] Get all departments — получение всех отделов в рабочей области.
  • [Plus] Create a department — Создайте новый отдел.
  • [Plus] Update a department — обновите существующий отдел.
  • [Plus] Delete a department — Удаление отдела.

Типы выхода

  • [Plus] Get all leave types — получение всех типов отпусков, настроенных в рабочей области.
  • [Plus] Create a leave type — создание нового типа выхода.
  • [Plus] Update a leave type — обновите существующий тип выхода.
  • [Plus] Delete a leave type — Удаление типа выхода.

Запросы

  • [Plus] Get all requests — получение всех запросов о выходе с помощью необязательных фильтров.
  • [Plus] Create a request — создайте новый запрос на отпуск для члена.
  • [Plus] Get request by ID — получение определенного запроса на отпуск по его идентификатору.
  • [Plus] Update a request — обновите состояние запроса на отпуск (утверждение, отклонение или отмена).
  • [Plus] Delete a request — удаление запроса на выход безвозвратно.

Государственные праздники

  • [Plus] Get all public holiday calendars — Получение всех календарей общественного праздника.
  • [Plus] Create a public holiday calendar — Создание нового календаря общественного праздника.
  • [Plus] Get public holiday calendar by ID — Получение определенного календаря со всеми его праздниками.
  • [Plus] Update a public holiday calendar — обновление существующего календаря.
  • [Plus] Delete a public holiday calendar — Удаление календаря.

Workspace

  • [Plus] Get workspace settings — получение параметров и конфигурации рабочей области.

Отсутствия

  • [Plus] Get absences — получение отсутствия для определенного диапазона дат.

Получение учетных данных

Чтобы использовать этот соединитель, вам нужна рабочая, учебная или личная учетная запись Майкрософт, с помощью которой можно войти напрямую.

Начало работы

Установите отсутствие с помощью одного из следующих методов:

  • Teams: установите отсутствующее приложение Teams, запустите его и примите разрешения и согласие.
  • Веб: откройте отсутствовающее веб-приложение и примите разрешения и согласие.

Чтобы полностью настроить учетную запись, следуйте инструкциям из этого краткого руководства. Убедитесь, что вы находитесь в плане Essentials или выше для триггеров или плюс плана для операций API.

Теперь вы готовы приступить к работе.

Известные проблемы и ограничения

  • В плане Essentials можно создать только три триггера. После третьего триггера вы получите сообщение об ошибке и удалите существующий триггер перед созданием нового.
  • Для операций API (помеченных как [Плюс]) требуется отсутствовать план Plus. Если вы пытаетесь использовать эти операции без плана Plus, появится сообщение об ошибке.

Инструкции по развертыванию

Следуйте этим инструкциям , чтобы развернуть этот соединитель в качестве пользовательского соединителя в Microsoft Power Automate и Power Apps.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
Подключение OAuth Подключение OAuth Все регионы Недоступен для совместного использования
По умолчанию [не рекомендуется] Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. Все регионы Недоступен для совместного использования

Подключение OAuth

Идентификатор проверки подлинности: неопределенный

Применимо: все регионы

Подключение OAuth

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

По умолчанию [не рекомендуется]

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

[Плюс] Добавление расписания участников

Добавьте новое рабочее расписание для члена. Требуется отсутствовать план Plus.
[Плюс] Обновление запроса

Обновите состояние запроса на отпуск (утверждение, отклонение или отмена). Требуется отсутствовать план Plus.
[Плюс] Обновление календаря общественного праздника

Обновите существующий календарь общественного праздника. Требуется отсутствовать план Plus.
[Плюс] Обновление отдела

Обновите существующий отдел. Требуется отсутствовать план Plus.
[Плюс] Обновление пособия для членов

Обновите пособие члена для определенного типа пособия и года. Требуется отсутствовать план Plus.
[Плюс] Обновление типа выхода

Обновите существующий тип выхода. Требуется отсутствовать план Plus.
[Плюс] Обновление утверждающих участников

Обновите утверждающих для определенного члена. Поддерживает менеджеров профилей Майкрософт, параметров отдела или пользовательских утверждающих. Требуется отсутствовать план Plus.
[Плюс] Обновление элемента

Обновите сведения о существующем члене. Требуется отсутствовать план Plus.
[Плюс] Получение всех запросов

Извлеките все запросы на выход с дополнительными фильтрами. Требуется отсутствовать план Plus.
[Плюс] Получение всех календарей государственных праздников

Получите все календари общедоступного праздника, настроенные в рабочей области. Требуется отсутствовать план Plus.
[Плюс] Получение всех отделов

Извлеките все отделы в рабочей области. Требуется отсутствовать план Plus.
[Плюс] Получение всех типов отпусков

Получите все типы отпусков, настроенные в рабочей области. Требуется отсутствовать план Plus.
[Плюс] Получение всех членов

Получение всех участников с дополнительными фильтрами для отделов, состояний, дат занятости, состояния администратора, процесса утверждения, утверждающих, типов пособий, имени, месяца рождения и типа руководителя. Требуется отсутствовать план Plus.
[Плюс] Получение запроса по идентификатору

Получение определенного запроса на выход с помощью уникального идентификатора. Требуется отсутствовать план Plus.
[Плюс] Получение календаря общественного праздника по идентификатору

Получение определенного календаря общественного праздника со всеми своими праздниками. Требуется отсутствовать план Plus.
[Плюс] Получение отсутствия

Получение отсутствия для определенного диапазона дат. Возвращает утвержденные запросы на отпуск в течение указанного периода. Требуется отсутствовать план Plus.
[Плюс] Получение параметров рабочей области

Получение параметров и конфигурации рабочей области. Требуется отсутствовать план Plus.
[Плюс] Получение участника по идентификатору

Получение определенного элемента по уникальному идентификатору. Требуется отсутствовать план Plus.
[Плюс] Получение участника по идентификатору Майкрософт

Получение члена по идентификатору пользователя Майкрософт. Требуется отсутствовать план Plus.
[Плюс] Получение участника по пользовательскому идентификатору

Получение элемента по пользовательскому идентификатору. Требуется отсутствовать план Plus.
[Плюс] Получение участника по электронной почте

Получение участника по адресу электронной почты. Требуется отсутствовать план Plus.
[Плюс] Приглашение участника

Пригласите нового участника в рабочую область. Требуется отсутствовать план Plus.
[Плюс] Создание запроса

Создайте новый запрос на выход для члена. Требуется отсутствовать план Plus.
[Плюс] Создание календаря общественного праздника

Создайте календарь общедоступного праздника в рабочей области. Требуется отсутствовать план Plus.
[Плюс] Создание отдела

Создайте новый отдел в рабочей области. Требуется отсутствовать план Plus.
[Плюс] Создание типа выхода

Создайте новый тип выхода в рабочей области. Требуется отсутствовать план Plus.
[Плюс] Удаление запроса

Удалите запрос на выход безвозвратно. Требуется отсутствовать план Plus.
[Плюс] Удаление календаря общественного праздника

Удалите календарь общедоступного праздника из рабочей области. Требуется отсутствовать план Plus.
[Плюс] Удаление отдела

Удалите отдел из рабочей области. Требуется отсутствовать план Plus.
[Плюс] Удаление типа выхода

Удалите тип выхода из рабочей области. Требуется отсутствовать план Plus.
[Плюс] Удаление элемента

Удаление элемента. Все данные будут удалены окончательно. Требуется отсутствовать план Plus.

[Плюс] Добавление расписания участников

Идентификатор операции:
AddMemberSchedule

Добавьте новое рабочее расписание для члена. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 id True string

Уникальный идентификатор элемента.
С даты
 from string

Дата начала этого расписания (гггг-MM-DD).
В понедельник включено
 monday_am_enabled boolean

Включена ли в понедельник утро.
В понедельник включено pm
 monday_pm_enabled boolean

Включена ли в понедельник днем.
Вторник включен
 tuesday_am_enabled boolean

Включена ли вторник утром.
Вторник включено
 tuesday_pm_enabled boolean

Включен ли вторник днем.
Среда AM Включено
 wednesday_am_enabled boolean

Включена ли среда утром.
В среду по вечерам включен
 wednesday_pm_enabled boolean

Включена ли среда днем.
Четверг включен
 thursday_am_enabled boolean

Включен ли четверг утром.
Четверг с включенным
 thursday_pm_enabled boolean

Включен ли четверг днем.
В пятницу включено
 friday_am_enabled boolean

Включена ли пятница утром.
В пятницу по вечерам включен
 friday_pm_enabled boolean

Включена ли пятница днем.
Суббота включена
 saturday_am_enabled boolean

Включена ли суббота утром.
В субботу включена премьер-министр
 saturday_pm_enabled boolean

Включена ли суббота днем.
Воскресенье включено
 sunday_am_enabled boolean

Включена ли воскресенье утром.
Воскресенье pm включено
 sunday_pm_enabled boolean

Включен ли воскресенье днем.

Возвращаемое значение

Идентификатор расписания.

response
string

[Плюс] Обновление запроса

Идентификатор операции:
UpdateRequest

Обновите состояние запроса на отпуск (утверждение, отклонение или отмена). Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор запроса
 id True string

Уникальный идентификатор запроса.
Состояние
 status True string

Новое состояние запроса.
Причина
 reason string

Причина изменения состояния.

Возвращаемое значение

Идентификатор обновленного запроса.

response
string

[Плюс] Обновление календаря общественного праздника

Идентификатор операции:
UpdatePublicHoliday

Обновите существующий календарь общественного праздника. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор календаря общедоступного праздника
 id True string

Уникальный идентификатор календаря общественного праздника.
Имя
 name string

Имя календаря общественного праздника.
Страна
 country string

Код страны для государственных праздников.

Возвращаемое значение

Идентификатор обновленного календаря общественного праздника.

response
string

[Плюс] Обновление отдела

Идентификатор операции:
UpdateDepartment

Обновите существующий отдел. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор отдела
 id True string

Уникальный идентификатор отдела.
Имя
 name string

Название отдела.

Возвращаемое значение

Идентификатор обновленного отдела.

response
string

[Плюс] Обновление пособия для членов

Идентификатор операции:
UpdateMemberAllowance

Обновите пособие члена для определенного типа пособия и года. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 id True string

Уникальный идентификатор элемента.
Идентификатор типа пособия
 allowance_type_id True string

Уникальный идентификатор типа пособия.
Год
 year True integer

Год пособия.
Пособие
 allowance True number

Общая сумма пособия.
Компенсирующее время выключения
 compensatory_time_off True number

Добавим компенсирующее время.
Выдвинутый вперед
 brought_forward number

Пособие было выдвинуто с предыдущего года.
Причина
 reason string

Причина обновления пособия.
Перезапись перезаписи перенаправляется
 overwrite_brought_forward boolean

Следует ли перезаписать перезапись возвращаемого значения.
Задать по умолчанию
 set_as_default boolean

Следует ли задать этот тип пособия в качестве значения по умолчанию для члена.
Disabled
 disabled boolean

Следует ли отключить этот тип пособия для члена.

Возвращаемое значение

Идентификатор члена.

response
string

[Плюс] Обновление типа выхода

Идентификатор операции:
UpdateLeaveType

Обновите существующий тип выхода. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Оставьте идентификатор типа
 id True string

Уникальный идентификатор типа выхода.
Имя
 name string

Имя типа выхода.
Оставить единицу
 leave_unit string

Единица для этого типа выхода.
Цвет
 color string

Код цвета для этого типа оставить.
Icon
 icon string

Значок этого типа выхода.

Возвращаемое значение

Идентификатор обновленного типа выхода.

response
string

[Плюс] Обновление утверждающих участников

Идентификатор операции:
UpdateMemberApprovers

Обновите утверждающих для определенного члена. Поддерживает менеджеров профилей Майкрософт, параметров отдела или пользовательских утверждающих. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 id True string

Уникальный идентификатор элемента.
Процесс утверждения
 approval_process True string

Тип процесса утверждения.
Идентификатор члена
 member_id string

Идентификатор члена утверждающего.
Идентификатор диспетчера предшественников
 predecessor_manager_id string

Идентификатор диспетчера предшественников (для линейного утверждения).

Возвращаемое значение

Идентификатор члена.

response
string

[Плюс] Обновление элемента

Идентификатор операции:
UpdateMember

Обновите сведения о существующем члене. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 id True string

Уникальный идентификатор элемента.
Является администратором
 is_admin boolean

Должен ли член быть администратором.
Идентификатор отдела
 id string

Идентификатор отдела.
Дата начала работы
 employment_start_date string

Дата начала работы.
Дата окончания занятости
 employment_end_date string

Дата окончания работы.
Идентификатор календаря общедоступного праздника
 public_holiday_id string

Идентификатор назначенного календаря общественного праздника.
День рождения
 birthday string

День рождения члена.
Пользовательский идентификатор
 custom_id string

Пользовательский идентификатор элемента.
Состояние
 status string

Состояние члена.

Возвращаемое значение

Идентификатор обновленного элемента.

response
string

[Плюс] Получение всех запросов

Идентификатор операции:
GetRequests

Извлеките все запросы на выход с дополнительными фильтрами. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 member_id string

Фильтрация по идентификатору члена.
Состояние
 status string

Фильтрация по состоянию запроса.
Начать с
 start_from string

Фильтрация по дате начала (из).
Начало работы
 start_to string

Фильтрация по дате начала (в).
Конец из
 end_from string

Фильтрация по дате окончания (от).
Конец
 end_to string

Фильтрация по дате окончания (до).
Оставьте идентификатор типа
 leave_type_id string

Фильтруйте по идентификатору типа.
Идентификатор отдела
 department_id string

Фильтрация по идентификатору отдела.

Возвращаемое значение

response
array of Request

[Плюс] Получение всех календарей государственных праздников

Идентификатор операции:
GetPublicHolidays

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

Возвращаемое значение

response
array of PublicHolidayCalendar

[Плюс] Получение всех отделов

Идентификатор операции:
GetDepartments

Извлеките все отделы в рабочей области. Требуется отсутствовать план Plus.

Возвращаемое значение

response
array of Department

[Плюс] Получение всех типов отпусков

Идентификатор операции:
GetLeaveTypes

Получите все типы отпусков, настроенные в рабочей области. Требуется отсутствовать план Plus.

Возвращаемое значение

response
array of LeaveType

[Плюс] Получение всех членов

Идентификатор операции:
GetMembers

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификаторы отделов
 department_ids array

Фильтрация по идентификаторам отделов.
Состояние
 status string

Фильтрация по состоянию члена.
Начало работы
 employment_start_date_from string

Фильтрация по дате начала работы (от).
Начало работы
 employment_start_date_to string

Фильтрация по дате начала работы (в).
Окончание занятости из
 employment_end_date_from string

Фильтруйте по дате окончания работы (из).
Окончание занятости
 employment_end_date_to string

Фильтрация по дате окончания работы (до).
Является администратором
 is_admin boolean

Фильтрация по состоянию администратора.
Процесс утверждения
 approval_process string

Фильтрация по типу процесса утверждения.
Имеет утверждающих
 has_approvers boolean

Отфильтруйте, имеет ли член утверждающий.
Идентификатор типа пособия
 allowance_type_id string

Фильтруйте по идентификатору типа пособия.
Имя
 name string

Фильтрация по имени члена.
Месяц рождения
 birthday_month integer

Фильтрация по месяцам рождения (1–12).
Тип диспетчера
 manager_type string

Фильтрация по типу диспетчера.

Возвращаемое значение

response
array of Member

[Плюс] Получение запроса по идентификатору

Идентификатор операции:
GetRequestById

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор запроса
 id True string

Уникальный идентификатор запроса.

Возвращаемое значение

Запрос на выход.

Просьба
Request

[Плюс] Получение календаря общественного праздника по идентификатору

Идентификатор операции:
GetPublicHolidayById

Получение определенного календаря общественного праздника со всеми своими праздниками. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор календаря общедоступного праздника
 id True string

Уникальный идентификатор календаря общественного праздника.

Возвращаемое значение

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

Сведения о календаре общественного праздника
PublicHolidayCalendarDetail

[Плюс] Получение отсутствия

Идентификатор операции:
GetAbsences

Получение отсутствия для определенного диапазона дат. Возвращает утвержденные запросы на отпуск в течение указанного периода. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Дата начала
 start True date

Дата начала запроса на отсутствие (ггГГ-MM-DD).
Дата окончания
 end True date

Дата окончания запроса на отсутствие (YYY-MM-DD).
Идентификатор члена
 member_id string

Фильтрация по идентификатору члена.
Идентификатор отдела
 department_id string

Фильтрация по идентификатору отдела.

Возвращаемое значение

response
array of Absence

[Плюс] Получение параметров рабочей области

Идентификатор операции:
GetWorkspace

Получение параметров и конфигурации рабочей области. Требуется отсутствовать план Plus.

Возвращаемое значение

Параметры и конфигурация рабочей области.

Workspace
Workspace

[Плюс] Получение участника по идентификатору

Идентификатор операции:
GetMemberById

Получение определенного элемента по уникальному идентификатору. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 id True string

Уникальный идентификатор элемента.

Возвращаемое значение

Подробные сведения о членах, включая расписания.

Сведения о члене
MemberDetail

[Плюс] Получение участника по идентификатору Майкрософт

Идентификатор операции:
GetMemberByMicrosoftId

Получение члена по идентификатору пользователя Майкрософт. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя Майкрософт
 microsoft_user_id True string

Идентификатор пользователя Майкрософт.

Возвращаемое значение

Подробные сведения о членах, включая расписания.

Сведения о члене
MemberDetail

[Плюс] Получение участника по пользовательскому идентификатору

Идентификатор операции:
GetMemberByCustomId

Получение элемента по пользовательскому идентификатору. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Пользовательский идентификатор
 custom_id True string

Пользовательский идентификатор члена.

Возвращаемое значение

Подробные сведения о членах, включая расписания.

Сведения о члене
MemberDetail

[Плюс] Получение участника по электронной почте

Идентификатор операции:
GetMemberByEmail

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

Параметры

Имя Ключ Обязательно Тип Описание
Адрес электронной почты
 email True string

Адрес электронной почты участника.

Возвращаемое значение

Подробные сведения о членах, включая расписания.

Сведения о члене
MemberDetail

[Плюс] Приглашение участника

Идентификатор операции:
InviteMember

Пригласите нового участника в рабочую область. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
 name True string

Имя участника, который нужно пригласить.
Адрес электронной почты
 email string

Адрес электронной почты участника.
Идентификатор отдела
 id string

Идентификатор отдела.
Дата начала работы
 employment_start_date string

Дата начала работы.
Идентификатор календаря общедоступного праздника
 public_holiday_id True string

Идентификатор назначенного календаря общественного праздника.
День рождения
 birthday string

День рождения члена.
Пользовательский идентификатор
 custom_id string

Пользовательский идентификатор элемента.

Возвращаемое значение

Идентификатор приглашенного члена.

response
string

[Плюс] Создание запроса

Идентификатор операции:
CreateRequest

Создайте новый запрос на выход для члена. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 member_id True string

Идентификатор участника, запрашивающего отпуск.
Оставьте идентификатор типа
 leave_type_id True string

Идентификатор типа выхода.
Дата начала
 start True string

Дата начала отпуска (ГГГГ-MM-DD).
Время начала
 start_at string

Время дня, когда начинается отпуск.
Дата окончания
 end True string

Дата окончания отпуска (ГГГГ-MM-DD).
Время окончания
 end_at string

Время дня, когда заканчивается отпуск.
Причина
 reason string

Причина запроса на выход.

Возвращаемое значение

Идентификатор созданного запроса.

response
string

[Плюс] Создание календаря общественного праздника

Идентификатор операции:
CreatePublicHoliday

Создайте календарь общедоступного праздника в рабочей области. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
 name True string

Имя календаря общественного праздника.
Страна
 country string

Код страны для государственных праздников.

Возвращаемое значение

Идентификатор созданного календаря общественного праздника.

response
string

[Плюс] Создание отдела

Идентификатор операции:
CreateDepartment

Создайте новый отдел в рабочей области. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
 name True string

Название отдела.

Возвращаемое значение

Идентификатор созданного отдела.

response
string

[Плюс] Создание типа выхода

Идентификатор операции:
CreateLeaveType

Создайте новый тип выхода в рабочей области. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
 name True string

Имя типа выхода.
Оставить единицу
 leave_unit string

Единица для этого типа выхода.
Цвет
 color string

Код цвета для этого типа оставить.
Icon
 icon string

Значок этого типа выхода.

Возвращаемое значение

Идентификатор созданного типа выхода.

response
string

[Плюс] Удаление запроса

Идентификатор операции:
DeleteRequest

Удалите запрос на выход безвозвратно. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор запроса
 id True string

Уникальный идентификатор запроса.

Возвращаемое значение

Идентификатор удаленного запроса.

response
string

[Плюс] Удаление календаря общественного праздника

Идентификатор операции:
DeletePublicHoliday

Удалите календарь общедоступного праздника из рабочей области. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор календаря общедоступного праздника
 id True string

Уникальный идентификатор календаря общественного праздника.

Возвращаемое значение

Идентификатор удаленного календаря общественного праздника.

response
string

[Плюс] Удаление отдела

Идентификатор операции:
DeleteDepartment

Удалите отдел из рабочей области. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор отдела
 id True string

Уникальный идентификатор отдела.

Возвращаемое значение

Идентификатор удаленного отдела.

response
string

[Плюс] Удаление типа выхода

Идентификатор операции:
DeleteLeaveType

Удалите тип выхода из рабочей области. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Оставьте идентификатор типа
 id True string

Уникальный идентификатор типа выхода.

Возвращаемое значение

Идентификатор удаленного типа выхода.

response
string

[Плюс] Удаление элемента

Идентификатор операции:
DeleteMember

Удаление элемента. Все данные будут удалены окончательно. Требуется отсутствовать план Plus.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор члена
 id True string

Уникальный идентификатор элемента.

Возвращаемое значение

Идентификатор удаленного элемента.

response
string

Триггеры

Обновлено состояние запроса

Этот триггер выполняется, если состояние существующего запроса изменяется.
Созданный запрос

Этот триггер выполняется при создании нового запроса в вашей компании.

Обновлено состояние запроса

Идентификатор операции:
TriggerRequestStatusChanged

Этот триггер выполняется, если состояние существующего запроса изменяется.

Возвращаемое значение

Тело
RequestWebhookPayloadV1

Созданный запрос

Идентификатор операции:
TriggerRequestCreated

Этот триггер выполняется при создании нового запроса в вашей компании.

Возвращаемое значение

Тело
RequestWebhookPayloadV1

Определения

RequestWebhookPayloadV1

Имя Путь Тип Описание
id
 id string

id
запрос, созданный по адресу
 createdAt string

запрос, созданный по адресу
запрос обновлен по адресу
 updatedAt string

запрос обновлен по адресу
Дата начала запроса
 start string

Дата начала запроса
Начало запроса
 start_at string

Начало запроса
Дата окончания запроса
 end string

Дата окончания запроса
Конец запроса
 end_at string

Конец запроса
Продолжительность запроса вычитается
 duration float

Продолжительность запроса вычитается
Год запроса
 year integer

Год запроса
Статус запроса
 details.status string

Статус запроса
Запрос, вычитаемый из пособия пользователя
 details.deducted float

Запрос, вычитаемый из пособия пользователя
Причина запроса
 details.reason string

Причина запроса
Процесс утверждения
 details.approval_process string

Процесс утверждения
Утверждающие запросы
 details.request_approvers array of object

Утверждающие запросы
Внутренний uuid
 details.request_approvers.uuid string

Внутренний uuid
Состояние
 details.request_approvers.status string

Состояние
Изменено по электронной почте
 details.request_approvers.status_changed_by_member.email string

Изменено по электронной почте
Изменено по имени
 details.request_approvers.status_changed_by_member.name string

Изменено по имени
Изменение по идентификатору
 details.request_approvers.status_changed_by_member.id string

Изменение по идентификатору
Изменен настраиваемым идентификатором
 details.request_approvers.status_changed_by_member.custom_id string

Изменен настраиваемым идентификатором
Дата изменения состояния
 details.request_approvers.status_change_date date-time

Дата изменения состояния
Идентификатор утверждающего участника запроса предшественника
 details.request_approvers.predecessor_request_member_approver_id string

Существует ли предшественник, который должен утвердить ранее?
Причина
 details.request_approvers.reason string

Причина
Электронная почта запрашивающего средства запроса
 details.requester_member.email string

Электронная почта запрашивающего средства запроса
Имя запрашивающего запроса
 details.requester_member.name string

Имя запрашивающего запроса
Идентификатор запрашивающего объекта
 details.requester_member.id string

Идентификатор запрашивающего объекта
Пользовательский идентификатор запрашивающего пользователя
 details.requester_member.custom_id string

Пользовательский идентификатор запрашивающего пользователя
Пособия
 details.requester_member.allowances array of object

Пособия
Пособие
 details.requester_member.allowances.allowance number

Пособие
Перенос
 details.requester_member.allowances.brought_forward number

Перенос
Компенсаторное время выключения
 details.requester_member.allowances.compensatory_time_off number

Компенсаторное время выключения
Остальной
 details.requester_member.allowances.remaining number

Остальной
Взятый
 details.requester_member.allowances.taken number

Взятый
Год
 details.requester_member.allowances.year number

Год
Дата утверждения запроса (не рекомендуется)
 details.approved_date string

Дата утверждения запроса (не рекомендуется)
Причина отмены запроса
 details.cancel_reason string

Причина отмены запроса
Дата отмены запроса
 details.canceld_date string

Дата отмены запроса
Дата отклонения запроса (не рекомендуется)
 details.declined_date string

Дата отклонения запроса (не рекомендуется)
Причина отклонения запроса (не рекомендуется)
 details.decline_reason string

Причина отклонения запроса (не рекомендуется)
Сообщение электронной почты утверждающего запроса (не рекомендуется)
 details.approver_member.email string

Сообщение электронной почты утверждающего запроса (не рекомендуется)
Имя утверждающего запроса (не рекомендуется)
 details.approver_member.name string

Имя утверждающего запроса (не рекомендуется)
Идентификатор утверждающего запроса (не рекомендуется)
 details.approver_member.id string

Идентификатор утверждающего запроса (не рекомендуется)
Настраиваемый идентификатор утверждающего запроса (не рекомендуется)
 details.approver_member.custom_id string

Настраиваемый идентификатор утверждающего запроса (не рекомендуется)
Запрос отменен по электронной почте
 details.canceld_by_member.email string

Запрос отменен по электронной почте
Запрос отменен по имени
 details.canceld_by_member.name string

Запрос отменен по имени
Запрос отменен по идентификатору
 details.canceld_by_member.id string

Запрос отменен по идентификатору
Запрос отменен пользовательским идентификатором
 details.canceld_by_member.custom_id string

Запрос отменен пользовательским идентификатором
Запрос отклонен по электронной почте (не рекомендуется)
 details.declined_by_member.email string

Запрос отклонен по электронной почте (не рекомендуется)
Запрос отклонен по имени (не рекомендуется)
 details.declined_by_member.name string

Запрос отклонен по имени (не рекомендуется)
Запрос отклонен по идентификатору (не рекомендуется)
 details.declined_by_member.id string

Запрос отклонен по идентификатору (не рекомендуется)
Запрос отклонен пользовательским идентификатором (не рекомендуется)
 details.declined_by_member.custom_id string

Запрос отклонен пользовательским идентификатором (не рекомендуется)
Оставить идентификатор типа
 details.leave_type.id string

Оставить идентификатор типа
Оставьте имя типа
 details.leave_type.name string

Оставьте имя типа

MemberReference

Ссылка на элемент.

Имя Путь Тип Описание
Идентификатор члена
 id string

Уникальный идентификатор элемента.
Пользовательский идентификатор
 custom_id string

Пользовательский идентификатор элемента.
Имя
 name string

Имя члена.
Адрес электронной почты
 email string

Адрес электронной почты участника.

LeaveTypeV2

Сведения о типе выхода.

Имя Путь Тип Описание
Оставьте идентификатор типа
 id string

Уникальный идентификатор типа выхода.
Оставьте имя типа
 name string

Имя типа выхода.
Оставить единицу
 leave_unit string

Единица типа выхода.

AllowanceTypeV2

Сведения о типе пособия.

Имя Путь Тип Описание
Идентификатор типа пособия
 id string

Уникальный идентификатор типа пособия.
Имя типа пособия
 name string

Имя типа пособия.
Игнорировать ограничение
 ignore_allowance_limit boolean

Следует ли игнорировать предел пособия.
Единица пособия
 allowance_unit string

Единица пособия.

RequestApproverV2

Сведения о утверждающего запросе.

Имя Путь Тип Описание
Состояние утверждающего
 status string

Текущее состояние утверждения.
Причина утверждающего
 reason string

Причина, предоставленная утверждающего.
Дата изменения состояния
 status_changed_date string

Дата изменения состояния утверждения.
Член
 status_changed_by_member MemberReference

Ссылка на элемент.
Член
 approver_member MemberReference

Ссылка на элемент.

Член

Член рабочей области.

Имя Путь Тип Описание
Идентификатор члена
 id string

Уникальный идентификатор элемента.
Пользовательский идентификатор
 custom_id string

Пользовательский идентификатор элемента.
Имя
 name string

Имя члена.
Адрес электронной почты
 email string

Адрес электронной почты участника.
Создано в
 createdAt string

Метка времени создания элемента.
Обновлено в
 updatedAt string

Метка времени последнего обновления элемента.
Состояние
 status string

Текущее состояние члена.
День рождения
 birthday string

День рождения члена.
Дата начала работы
 employment_start_date string

Дата начала работы члена.
Дата окончания занятости
 employment_end_date string

Дата окончания занятости члена.
Является администратором
 is_admin boolean

Является ли участник администратором.
Процесс утверждения
 approval_process string

Тип процесса утверждения для этого члена.
Отделы
 departments array of MemberDepartment

Отделы, к которому принадлежит член.
Пособия
 allowances array of MemberAllowance

Пособия для члена.

MemberDetail

Подробные сведения о членах, включая расписания.

Имя Путь Тип Описание
Идентификатор члена
 id string

Уникальный идентификатор элемента.
Пользовательский идентификатор
 custom_id string

Пользовательский идентификатор элемента.
Имя
 name string

Имя члена.
Адрес электронной почты
 email string

Адрес электронной почты участника.
Создано в
 createdAt string

Метка времени создания элемента.
Обновлено в
 updatedAt string

Метка времени последнего обновления элемента.
Состояние
 status string

Текущее состояние члена.
День рождения
 birthday string

День рождения члена.
Дата начала работы
 employment_start_date string

Дата начала работы члена.
Дата окончания занятости
 employment_end_date string

Дата окончания занятости члена.
Является администратором
 is_admin boolean

Является ли участник администратором.
Процесс утверждения
 approval_process string

Тип процесса утверждения для этого члена.
Отделы
 departments array of MemberDepartment

Отделы, к которому принадлежит член.
Пособия
 allowances array of MemberAllowance

Пособия для члена.
Утверждающие
 has_approvers array of ApproverInfo

Список утверждающих для этого члена.
Schedules
 schedules array of Schedule

Рабочие расписания для члена.

MemberDepartment

Назначение отдела для члена.

Имя Путь Тип Описание
Идентификатор отдела
 id string

Уникальный идентификатор отдела.
Название отдела
 name string

Название отдела.
Тип диспетчера
 manager_type string

Роль члена отдела.

MemberAllowance

Сведения о пособиях для члена.

Имя Путь Тип Описание
Идентификатор пособия
 id string

Уникальный идентификатор записи о пособиях.
Год
 year integer

Год для этого пособия.
Пособие
 allowance number

Общая сумма пособия.
Взятый
 taken number

Сумма пособия уже взята.
Остальной
 remaining number

Оставшаяся сумма пособия.
Выдвинутый вперед
 brought_forward number

Пособие было выдвинуто с предыдущего года.
Компенсирующее время выключения
 compensatory_time_off number

Добавлено компенсирующее время.
Тип пособия
 allowance_type AllowanceTypeV2

Сведения о типе пособия.

УтверждающийInfo

Сведения об утверждающего.

Имя Путь Тип Описание
Член
 member MemberReference

Ссылка на элемент.

Расписание

Расписание работы для члена.

Имя Путь Тип Описание
Идентификатор расписания
 id string

Уникальный идентификатор расписания.
С даты
 from string

Дата начала этого расписания.
Создано в
 createdAt string

Метка времени создания расписания.
Обновлено в
 updatedAt string

Метка времени последнего обновления расписания.

Отдел

Отдел в рабочей области.

Имя Путь Тип Описание
Идентификатор отдела
 id string

Уникальный идентификатор отдела.
Имя
 name string

Название отдела.
Создано в
 createdAt string

Метка времени создания отдела.
Обновлено в
 updatedAt string

Метка времени последнего обновления отдела.

LeaveType

Тип выхода в рабочей области.

Имя Путь Тип Описание
Оставьте идентификатор типа
 id string

Уникальный идентификатор типа выхода.
Имя
 name string

Имя типа выхода.
Оставить единицу
 leave_unit string

Единица для этого типа выхода.
Цвет
 color string

Код цвета для этого типа оставить.
Icon
 icon string

Значок этого типа выхода.
Создано в
 createdAt string

Метка времени при создании типа выхода.
Обновлено в
 updatedAt string

Метка времени последнего обновления типа выхода.

Просьба

Запрос на выход.

Имя Путь Тип Описание
Идентификатор запроса
 id string

Уникальный идентификатор запроса.
Создано в
 createdAt string

Метка времени при создании запроса.
Обновлено в
 updatedAt string

Метка времени последнего обновления запроса.
Дата начала
 start string

Дата начала запроса.
Время начала
 start_at string

Время дня, когда начинается отпуск.
Дата окончания
 end string

Дата окончания запроса.
Время окончания
 end_at string

Время дня, когда заканчивается отпуск.
Состояние
 status string

Текущее состояние запроса.
Причина
 reason string

Причина запроса на выход.
Продолжительность
 duration number

Длительность отпуска.
Длительность workday
 workday_absence_duration number

Длительность в рабочих днях.
Оставить единицу
 leave_unit string

Единица для этого отпуска.
Член
 requester_member MemberReference

Ссылка на элемент.
Тип отпуска
 leave_type LeaveTypeV2

Сведения о типе выхода.
Утверждающие
 request_approvers array of RequestApproverV2

Список утверждающих для этого запроса.

PublicHolidayCalendar

Календарь общественного праздника.

Имя Путь Тип Описание
Идентификатор календаря
 id string

Уникальный идентификатор календаря.
Имя
 name string

Имя календаря общественного праздника.
Страна
 country string

Страна для государственных праздников.
Создано в
 createdAt string

Метка времени создания календаря.
Обновлено в
 updatedAt string

Метка времени последнего обновления календаря.

PublicHolidayCalendarDetail

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

Имя Путь Тип Описание
Идентификатор календаря
 id string

Уникальный идентификатор календаря.
Имя
 name string

Имя календаря общественного праздника.
Страна
 country string

Страна для государственных праздников.
Каникулы
 holidays array of PublicHoliday

Список праздников в этом календаре.

PublicHoliday

Общественный праздник.

Имя Путь Тип Описание
Идентификатор праздника
 id string

Уникальный идентификатор праздника.
Имя
 name string

Имя праздника.
Date
 date string

Дата праздника.
Продолжительность
 duration number

Длительность праздника (0,5 на полдня, 1 на полный день).

Workspace

Параметры и конфигурация рабочей области.

Имя Путь Тип Описание
Идентификатор рабочей области
 id string

Уникальный идентификатор рабочей области.
Имя
 name string

Имя рабочей области.
Создано в
 createdAt string

Метка времени создания рабочей области.
Обновлено в
 updatedAt string

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

Простой

Запись отсутствия.

Имя Путь Тип Описание
Идентификатор отсутствия
 id string

Уникальный идентификатор отсутствия.
Date
 date string

Дата отсутствия.
Продолжительность
 duration number

Длительность отсутствия.
Член
 member MemberReference

Ссылка на элемент.
Тип отпуска
 leave_type LeaveTypeV2

Сведения о типе выхода.
Идентификатор запроса
 request_id string

Идентификатор связанного запроса на выход.

струна

Это базовый тип данных string.