Урожай

Урожай — это простое средство для отслеживания времени, затраченного командой на каждый проект и задачу.

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

Услуга	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)

Контакт
Имя	Microsoft
URL	Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://www.getharvest.com/
Политика конфиденциальности	https://www.getharvest.com/privacy-policy

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

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

Действия

Вывод списка всех клиентов	Извлекает список всех клиентов для учетной записи, прошедшей проверку подлинности.
Вывод списка всех контактов	Извлекает список всех контактов для прошедшего проверку подлинности пользователя.
Добавление нового клиента	Создайте новый клиент.
Добавление нового контакта	Создайте новый контакт.
Добавление нового пользователя	Создайте нового пользователя.
Добавление пользователя в проект	Добавьте существующего пользователя в проект.
Запись времени обновления	Обновите существующую запись времени.
Перечисление задач	Извлекает список всех задач.
Получение записи времени по идентификатору	Получение существующей записи времени по идентификатору.
Получение сведений о пользователе	Получение сведений о пользователе по идентификатору пользователя или электронной почте.
Создание записи времени	Создайте новую запись времени.
Список проектов	Выводит список всех проектов для текущего пользователя.
Удаление записи времени	Удаление существующей записи времени.

Вывод списка всех клиентов

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

Извлекает список всех клиентов для учетной записи, прошедшей проверку подлинности.

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

Товары: ListAllClients_Response

Вывод списка всех контактов

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

Извлекает список всех контактов для прошедшего проверку подлинности пользователя.

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

Товары: ListAllContacts_Response

Добавление нового клиента

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

Создайте новый клиент.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя	name	True	string	Имя клиента
Валюта	currency		string	Валюта, которую вы хотите использовать для клиента.
Символ валюты	currency_symbol		string	Символ, который коррелирует с выбранной валютой.
Сведения	details		string	Дополнительные сведения, обычно используемые для сведений об адресе.

Добавление нового контакта

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

Создайте новый контакт.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор клиента	client_id	True	integer	Уникальный идентификатор клиента.
Имя (первое имя)	first_name	True	string	Имя контакта.
Фамилия	last_name	True	string	Фамилия контакта.
Адрес электронной почты	email		string	Электронная почта контакта.
Рабочий телефон	phone_office		string	Офисный телефон контакта.
Мобильный телефон	phone_mobile		string	Мобильный телефон контакта.
Факс	fax		string	Факс контакта.
Название	title		string	Название контакта.

Добавление нового пользователя

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

Создайте нового пользователя.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адрес электронной почты	email	True	string
Администратор	is_admin		boolean
Имя (первое имя)	first_name	True	string
Фамилия	last_name	True	string
Подрядчик	is_contractor		boolean
Телефон	telephone		string
Почасовая ставка	default_hourly_rate		float	По умолчанию почасовая ставка.
Отдел	department		string
Ставка по стоимости	cost_rate		float

Добавление пользователя в проект

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

Добавьте существующего пользователя в проект.

Параметры

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

Запись времени обновления

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

Обновите существующую запись времени.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор записи времени	DAY_ENTRY_ID	True	string	Идентификатор записи времени
Идентификатор проекта	project_id	True	string	Проект
Идентификатор задачи	task_id	True	string	Задача
Примечания.	notes		string
Начало даты и времени	started_at		string	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Окончание даты и времени	ended_at		string	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Date	spent_at		string	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).

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

Тело: UpdateTimeEntry_Response

Перечисление задач

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

Извлекает список всех задач.

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

Товары: ListTasks_Response

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

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

Получение существующей записи времени по идентификатору.

Параметры

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

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

Тело: UpdateTimeEntry_Response

Получение сведений о пользователе

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

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

Параметры

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

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

Тело: GetUserByID_Response

Создание записи времени

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

Создайте новую запись времени.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
заметки	notes		string
Часов	hours		integer
Идентификатор проекта	project_id	True	string	Проект
Идентификатор задачи	task_id	True	string	Задача
Date	spent_at		string	Потрачено на

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

Тело: UpdateTimeEntry_Response

Список проектов

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

Выводит список всех проектов для текущего пользователя.

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

Товары: ListProjects_Response

Удаление записи времени

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

Удаление существующей записи времени.

Параметры

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

Триггеры

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

При добавлении клиента

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

Активирует при добавлении нового клиента.

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

Имя	Путь	Тип	Описание
Идентификатор клиента	client.id	integer	Уникальный идентификатор клиента.
Имя	client.name	string	Имя клиента.
Валюта	client.currency	string	Валюта, используемая для выставления счетов клиентов.
Обновление даты и времени	client.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Создание даты и времени	client.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Address	client.address	string	Адрес клиента.
Символ валюты	client.currency_symbol	string	Символ, который коррелирует с выбранной валютой.
Сведения	client.details	string	Дополнительные сведения, обычно используемые для сведений об адресе.

При добавлении контакта

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

Активирует при добавлении нового контакта.

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

Имя	Путь	Тип	Описание
Идентификатор контакта	contact.id	integer	Уникальный идентификатор контакта.
Идентификатор клиента	contact.client_id	integer	Уникальный идентификатор клиента.
Имя (первое имя)	contact.first_name	string	Имя контакта.
Фамилия	contact.last_name	string	Фамилия контакта.
Адрес электронной почты	contact.email	string	Электронная почта контакта.
Рабочий телефон	contact.phone_office	string	Офисный телефон контакта.
Мобильный телефон	contact.phone_mobile	string	Мобильный телефон контакта.
Факс	contact.fax	string	Факс контакта.
Название	contact.title	string	Название контакта.
Создание даты и времени	contact.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Обновление даты и времени	contact.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).

При добавлении пользователя

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

Активирует при добавлении нового пользователя.

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

Тело: GetUserByID_Response

При создании записи времени для даты

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

Активирует при создании новой записи времени для определенной даты.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Date	date	True	string	YYY-MM-DD или формат ISO datetime
Другой идентификатор пользователя	of_user		string	Идентификатор пользователя для проверки записей времени.

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

Тело: GetTimeEntriesForDay_Response

При создании записи времени на текущий день

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

Активирует при создании новой записи времени в текущий день.

Параметры

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

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

Тело: GetTimeEntriesForDay_Response

При создании проекта

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

Активирует при создании нового проекта.

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

Имя	Путь	Тип	Описание
Идентификатор проекта	project.id	integer	Уникальный идентификатор проекта.
Идентификатор клиента	project.client_id	integer	Идентификатор клиента для проекта.
Имя	project.name	string	Имя проекта.
Code	project.code	string	Код проекта.
Активен	project.active	boolean	Значение true, если проект в настоящее время активен.
Выставление счетов	project.billable	boolean	Значение True, если проект может выставлять счет.
Счет по	project.bill_by	string	Метод, с помощью которого проект выставляется по счету.
Почасовая ставка	project.hourly_rate	float	Тариф выставления счетов по часам.
Бюджет	project.budget	float	Бюджетная стоимость проекта.
Бюджет по	project.budget_by	string	Метод бюджетирования для проекта.
Создание даты и времени	project.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Обновление даты и времени	project.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Начальная дата	project.starts_on	string	ГГГГ-ММ-ДД
Дата окончания	project.ends_on	string	ГГГГ-ММ-ДД
Оценка	project.estimate	float	Оценка проекта.
Оценка по	project.estimate_by	string	Метод оценки для проекта.
Самая ранняя дата записи	project.hint_earliest_record_at	string	ГГГГ-ММ-ДД
Последняя дата записи	project.hint_latest_record_at	string	ГГГГ-ММ-ДД
Примечания.	project.notes	string	Заметки о проекте.
Бюджет затрат	project.cost_budget	float	Стоимость бюджета для проектов общего объема сборов за проекты.
Бюджет затрат включает расходы	project.cost_budget_include_expenses	boolean	Вариант для бюджета проектов итоговых сборов проекта для включения отслеживаемых расходов.

Определения

ListAllContacts_Response

Имя	Путь	Тип	Описание
Идентификатор контакта	contact.id	integer	Уникальный идентификатор контакта.
Идентификатор клиента	contact.client_id	integer	Уникальный идентификатор клиента.
Имя (первое имя)	contact.first_name	string	Имя контакта.
Фамилия	contact.last_name	string	Фамилия контакта.
Адрес электронной почты	contact.email	string	Электронная почта контакта.
Рабочий телефон	contact.phone_office	string	Офисный телефон контакта.
Мобильный телефон	contact.phone_mobile	string	Мобильный телефон контакта.
Факс	contact.fax	string	Факс контакта.
Название	contact.title	string	Название контакта.
Создание даты и времени	contact.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Обновление даты и времени	contact.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).

ListAllClients_Response

Имя	Путь	Тип	Описание
Идентификатор клиента	client.id	integer	Уникальный идентификатор клиента.
Имя	client.name	string	Имя клиента.
Валюта	client.currency	string	Валюта, используемая для выставления счетов клиентов.
Обновление даты и времени	client.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Создание даты и времени	client.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Address	client.address	string	Адрес клиента.
Символ валюты	client.currency_symbol	string	Символ, который коррелирует с выбранной валютой.
Сведения	client.details	string	Дополнительные сведения, обычно используемые для сведений об адресе.

UpdateTimeEntry_Response

Имя	Путь	Тип	Описание
Идентификатор записи времени	id	integer	Уникальный идентификатор записи времени.
Идентификатор пользователя	user_id	integer	Уникальный идентификатор пользователя, создавшего запись времени.
Date	spent_at	string	Дата записи времени.
Создание даты и времени	created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Обновление даты и времени	updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Идентификатор проекта	project_id	string	Идентификатор записи времени проекта связан с.
Идентификатор задачи	task_id	string	Идентификатор записи времени задачи связан с.
Проект	project	string	Имя проекта, с которым связана запись времени.
Задача	task	string	Имя задачи, с которым связана запись времени.
Клиент	client	string	Имя клиента, с которым связана запись времени.
Примечания.	notes	string	Заметки о записи во времени.
Часы без таймера	hours_without_timer	float	Текущее время отслеживания, если таймер не запущен.
Часы	hours	float	Количество часов (десятичное время), отслеживаемое в этой записи времени.

ListProjects_Response

Имя	Путь	Тип	Описание
Идентификатор проекта	project.id	integer	Уникальный идентификатор проекта.
Идентификатор клиента	project.client_id	integer	Идентификатор клиента для проекта.
Имя	project.name	string	Имя проекта.
Code	project.code	string	Код проекта.
Активен	project.active	boolean	Значение true, если проект в настоящее время активен.
Выставление счетов	project.billable	boolean	Значение True, если проект может выставлять счет.
Счет по	project.bill_by	string	Метод, с помощью которого проект выставляется по счету.
Почасовая ставка	project.hourly_rate	float	Тариф выставления счетов по часам.
Бюджет	project.budget	float	Бюджетная стоимость проекта.
Бюджет по	project.budget_by	string	Метод бюджетирования для проекта.
Создание даты и времени	project.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Обновление даты и времени	project.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Начальная дата	project.starts_on	string	ГГГГ-ММ-ДД
Дата окончания	project.ends_on	string	ГГГГ-ММ-ДД
Оценка	project.estimate	float	Оценка проекта.
Оценка по	project.estimate_by	string	Метод оценки для проекта.
Самая ранняя дата записи	project.hint_earliest_record_at	string	ГГГГ-ММ-ДД
Последняя дата записи	project.hint_latest_record_at	string	ГГГГ-ММ-ДД
Примечания.	project.notes	string	Заметки о проекте.
Бюджет затрат	project.cost_budget	float	Стоимость бюджета для проектов общего объема сборов за проекты.
Бюджет затрат включает расходы	project.cost_budget_include_expenses	boolean	Вариант для бюджета проектов итоговых сборов проекта для включения отслеживаемых расходов.

ListTasks_Response

Имя	Путь	Тип	Описание
Идентификатор задачи	task.id	integer	Уникальный идентификатор задачи.
Имя	task.name	string	Имя задачи.
внутренний	task.billable_by_default	boolean
Создание даты и времени	task.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (UTC).
Обновление даты и времени	task.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (UTC).
По умолчанию почасовая ставка	task.default_hourly_rate	float	Частота по умолчанию для задачи.

GetUserByID_Response

Имя	Путь	Тип	Описание
Идентификатор пользователя	user.id	integer	Уникальный идентификатор пользователя.
Адрес электронной почты	user.email	string	Электронная почта пользователя.
Создание даты и времени	user.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Администратор	user.is_admin	boolean	Значение true, если пользователь является администратором.
Имя (первое имя)	user.first_name	string	Имя пользователя.
Фамилия	user.last_name	string	Фамилия пользователя.
Подрядчик	user.is_contractor	boolean	Значение true, если пользователь является подрядчиком.
Телефон	user.telephone	string	Телефон пользователя.
Активен	user.is_active	boolean	Значение true, если пользователь в данный момент активен.
Почасовая ставка	user.default_hourly_rate	float	Почасовая ставка пользователя
Отдел	user.department	string	Имя отдела, в который работает пользователь.
Подписка на информационный бюллетень	user.wants_newsletter	boolean	Значение true, если пользователь хочет подписаться на информационный бюллетень.
Ставка по стоимости	user.cost_rate	float	Стоимость пользователя.
Еженедельная емкость	user.weekly_capacity	integer	Еженедельная емкость пользователя.

GetTimeEntriesForDay_Response

Имя	Путь	Тип	Описание
day_entries	day_entries	array of object	day_entries
Идентификатор проекта	day_entries.project_id	string	Уникальный идентификатор порджекта.
Имя проекта	day_entries.project	string	Имя проекта.
Идентификатор пользователя	day_entries.user_id	integer	Уникальный идентификатор пользователя.
Date	day_entries.spent_at	string	ГГГГ-ММ-ДД
Идентификатор задачи	day_entries.task_id	string	Идентификатор задачи, с которым связана запись времени.
Задача	day_entries.task	string	Имя задачи, с которым связана запись времени.
Клиент	day_entries.client	string	Имя клиента, с которым связана запись времени.
Идентификатор записи времени	day_entries.id	integer	Уникальный идентификатор записи времени.
Примечания.	day_entries.notes	string	Заметки о записи во времени.
Начало даты и времени	day_entries.started_at	string	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Окончание даты и времени	day_entries.ended_at	string	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Создание даты и времени	day_entries.created_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Обновление даты и времени	day_entries.updated_at	date-time	ГГГГ-ММ-DDThh:mm:ssZ (формат UTC).
Часы без таймера	day_entries.hours_without_timer	float	Текущее время отслеживания, если таймер не запущен.
Часы	day_entries.hours	float	Количество часов (десятичное время), отслеживаемое в этой записи времени.