Colheita
O Harvest é uma ferramenta simples para ajudar a acompanhar o tempo gasto por sua equipe em cada projeto e tarefa.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://www.getharvest.com/ |
| Política de privacidade | https://www.getharvest.com/privacy-policy |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
| Frequência das pesquisas de gatilho | 1 | 60 segundos |
Ações
| Adicionar novo cliente |
Crie um novo cliente. |
| Adicionar novo contato |
Crie um novo contato. |
| Adicionar novo usuário |
Crie um novo usuário. |
| Adicionar usuário a um projeto |
Adicione um usuário existente a um projeto. |
| Criar entrada de hora |
Crie uma nova entrada de hora. |
| Entrada de tempo de atualização |
Atualize uma entrada de tempo existente. |
| Excluir entrada de hora |
Exclua uma entrada de tempo existente. |
| Listar projetos |
Lista todos os projetos para o usuário atual. |
| Listar tarefas |
Recupera uma lista de todas as tarefas. |
| Listar todos os clientes |
Recupera uma lista de todos os clientes para a conta autenticada. |
| Listar todos os contatos |
Recupera uma lista de todos os contatos para o usuário autenticado. |
| Obter entrada de tempo por ID |
Obtenha uma entrada de tempo existente por ID. |
| Obter informações do usuário |
Recupere os detalhes de um usuário por ID de usuário ou email. |
Adicionar novo cliente
Crie um novo cliente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
Nome do cliente |
|
Moeda
|
currency | string |
A moeda que você gostaria de usar para o cliente. |
|
|
Símbolo de moeda
|
currency_symbol | string |
Símbolo que se correlaciona com a moeda selecionada. |
|
|
Detalhes
|
details | string |
Detalhes adicionais, normalmente usados para informações de endereço. |
Adicionar novo contato
Crie um novo contato.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do cliente
|
client_id | True | integer |
Identificador exclusivo do cliente. |
|
Nome
|
first_name | True | string |
Nome do contato. |
|
Sobrenome
|
last_name | True | string |
Sobrenome do contato. |
|
Email
|
string |
Email do contato. |
||
|
Telefone comercial
|
phone_office | string |
Telefone do escritório do contato. |
|
|
Telefone celular
|
phone_mobile | string |
Telefone celular do contato. |
|
|
Fac-símile
|
fax | string |
Fax do contato. |
|
|
Title
|
title | string |
Título do contato. |
Adicionar novo usuário
Crie um novo usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Email
|
True | string | ||
|
É administrador
|
is_admin | boolean | ||
|
Nome
|
first_name | True | string | |
|
Sobrenome
|
last_name | True | string | |
|
É contratante
|
is_contractor | boolean | ||
|
Telefone
|
telephone | string | ||
|
Taxa por hora
|
default_hourly_rate | float |
Taxa por hora padrão. |
|
|
Departamento
|
department | string | ||
|
Taxa de custo
|
cost_rate | float |
Adicionar usuário a um projeto
Adicione um usuário existente a um projeto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
project_id | True | string |
ID do projeto |
|
Identificação de usuário
|
id | True | integer |
Utilizador |
Criar entrada de hora
Crie uma nova entrada de hora.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
notas
|
notes | string | ||
|
horas
|
hours | integer | ||
|
ID do projeto
|
project_id | True | string |
Projeto |
|
ID da tarefa
|
task_id | True | string |
Tarefa |
|
Date
|
spent_at | string |
Gasto em |
Retornos
- Corpo
- UpdateTimeEntry_Response
Entrada de tempo de atualização
Atualize uma entrada de tempo existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Entrada de Hora
|
DAY_ENTRY_ID | True | string |
A ID da entrada de hora |
|
ID do projeto
|
project_id | True | string |
Projeto |
|
ID da tarefa
|
task_id | True | string |
Tarefa |
|
Anotações
|
notes | string | ||
|
Data e hora iniciadas
|
started_at | string |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
|
Data e hora encerradas
|
ended_at | string |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
|
Date
|
spent_at | string |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
Retornos
- Corpo
- UpdateTimeEntry_Response
Excluir entrada de hora
Exclua uma entrada de tempo existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Entrada de Hora
|
DAY_ENTRY_ID | True | string |
A ID da entrada de hora |
Listar projetos
Listar tarefas
Listar todos os clientes
Recupera uma lista de todos os clientes para a conta autenticada.
Retornos
- Itens
- ListAllClients_Response
Listar todos os contatos
Recupera uma lista de todos os contatos para o usuário autenticado.
Retornos
- Itens
- ListAllContacts_Response
Obter entrada de tempo por ID
Obtenha uma entrada de tempo existente por ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Entrada de Hora
|
DAY_ENTRY_ID | True | string |
A ID da entrada de hora |
Retornos
- Corpo
- UpdateTimeEntry_Response
Obter informações do usuário
Recupere os detalhes de um usuário por ID de usuário ou email.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do usuário ou email
|
USERID | True | string |
ID do usuário ou email |
Retornos
- Corpo
- GetUserByID_Response
Gatilhos
| Quando um cliente é adicionado |
Dispara quando um novo cliente é adicionado. |
| Quando um contato é adicionado |
Dispara quando um novo contato é adicionado. |
| Quando um projeto é criado |
Dispara quando um novo projeto é criado. |
| Quando um usuário é adicionado |
Dispara quando um novo usuário é adicionado. |
| Quando uma entrada de hora é criada para data |
Dispara quando uma nova entrada de hora é criada para uma data específica. |
| Quando uma entrada de hora é criada para o dia atual |
Dispara quando uma nova entrada de hora é criada para o dia atual. |
Quando um cliente é adicionado
Dispara quando um novo cliente é adicionado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do cliente
|
client.id | integer |
Identificador exclusivo do cliente. |
|
Nome
|
client.name | string |
Nome do cliente. |
|
Moeda
|
client.currency | string |
Moeda a ser usada para cobrança do cliente. |
|
Data/hora atualizada
|
client.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data-hora criada
|
client.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Endereço
|
client.address | string |
Endereço do cliente. |
|
Símbolo de moeda
|
client.currency_symbol | string |
Símbolo que se correlaciona com a moeda selecionada. |
|
Detalhes
|
client.details | string |
Detalhes adicionais, normalmente usados para informações de endereço. |
Quando um contato é adicionado
Dispara quando um novo contato é adicionado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de contato
|
contact.id | integer |
Identificador exclusivo do contato. |
|
ID do cliente
|
contact.client_id | integer |
Identificador exclusivo do cliente. |
|
Nome
|
contact.first_name | string |
Nome do contato. |
|
Sobrenome
|
contact.last_name | string |
Sobrenome do contato. |
|
Email
|
contact.email | string |
Email do contato. |
|
Telefone comercial
|
contact.phone_office | string |
Telefone do escritório do contato. |
|
Telefone celular
|
contact.phone_mobile | string |
Telefone celular do contato. |
|
Fac-símile
|
contact.fax | string |
Fax do contato. |
|
Title
|
contact.title | string |
Título do contato. |
|
Data-hora criada
|
contact.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data/hora atualizada
|
contact.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
Quando um projeto é criado
Dispara quando um novo projeto é criado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do projeto
|
project.id | integer |
Identificador exclusivo do projeto. |
|
ID do cliente
|
project.client_id | integer |
ID do cliente para o projeto. |
|
Nome
|
project.name | string |
Nome do projeto. |
|
Code
|
project.code | string |
Código do projeto. |
|
Está ativo
|
project.active | boolean |
True se o projeto estiver ativo no momento. |
|
É faturável
|
project.billable | boolean |
True se o projeto for faturável. |
|
Cobrança por
|
project.bill_by | string |
Método pelo qual o projeto é faturado. |
|
Taxa por hora
|
project.hourly_rate | float |
Taxa de cobrança por hora. |
|
Orçamento
|
project.budget | float |
Valor do orçamento do projeto. |
|
Orçamento por
|
project.budget_by | string |
Método de orçamento para o projeto. |
|
Data-hora criada
|
project.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data/hora atualizada
|
project.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data de início
|
project.starts_on | string |
AAAA-MM-DD |
|
Data de término
|
project.ends_on | string |
AAAA-MM-DD |
|
Estimativa
|
project.estimate | float |
Estimativa do projeto. |
|
Estimado por
|
project.estimate_by | string |
Método de estimativa para o projeto. |
|
Data de registro mais antiga
|
project.hint_earliest_record_at | string |
AAAA-MM-DD |
|
Data de registro mais recente
|
project.hint_latest_record_at | string |
AAAA-MM-DD |
|
Anotações
|
project.notes | string |
Notas do projeto. |
|
Orçamento de custo
|
project.cost_budget | float |
Valor de orçamento para o total de projetos de Taxas de Projeto. |
|
O orçamento de custo inclui despesas
|
project.cost_budget_include_expenses | boolean |
Opção para o orçamento de projetos totais de taxas de projeto para incluir despesas controladas. |
Quando um usuário é adicionado
Quando uma entrada de hora é criada para data
Dispara quando uma nova entrada de hora é criada para uma data específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Date
|
date | True | string |
YYYY-MM-DD ou datetime de formato ISO |
|
Outra ID de Usuário
|
of_user | string |
A ID do usuário para o qual verificar as entradas de tempo. |
Retornos
Quando uma entrada de hora é criada para o dia atual
Dispara quando uma nova entrada de hora é criada para o dia atual.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Outra ID de Usuário
|
of_user | string |
A ID do usuário para o qual verificar as entradas de tempo. O padrão é a ID. |
Retornos
Definições
ListAllContacts_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de contato
|
contact.id | integer |
Identificador exclusivo do contato. |
|
ID do cliente
|
contact.client_id | integer |
Identificador exclusivo do cliente. |
|
Nome
|
contact.first_name | string |
Nome do contato. |
|
Sobrenome
|
contact.last_name | string |
Sobrenome do contato. |
|
Email
|
contact.email | string |
Email do contato. |
|
Telefone comercial
|
contact.phone_office | string |
Telefone do escritório do contato. |
|
Telefone celular
|
contact.phone_mobile | string |
Telefone celular do contato. |
|
Fac-símile
|
contact.fax | string |
Fax do contato. |
|
Title
|
contact.title | string |
Título do contato. |
|
Data-hora criada
|
contact.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data/hora atualizada
|
contact.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
ListAllClients_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do cliente
|
client.id | integer |
Identificador exclusivo do cliente. |
|
Nome
|
client.name | string |
Nome do cliente. |
|
Moeda
|
client.currency | string |
Moeda a ser usada para cobrança do cliente. |
|
Data/hora atualizada
|
client.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data-hora criada
|
client.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Endereço
|
client.address | string |
Endereço do cliente. |
|
Símbolo de moeda
|
client.currency_symbol | string |
Símbolo que se correlaciona com a moeda selecionada. |
|
Detalhes
|
client.details | string |
Detalhes adicionais, normalmente usados para informações de endereço. |
UpdateTimeEntry_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de entrada de hora
|
id | integer |
Identificador exclusivo da entrada de hora. |
|
ID do usuário
|
user_id | integer |
Identificador exclusivo do usuário que criou a entrada de hora. |
|
Date
|
spent_at | string |
Entrada de data/hora. |
|
Data-hora criada
|
created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data/hora atualizada
|
updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
ID do projeto
|
project_id | string |
A ID da entrada de tempo do projeto está associada. |
|
ID da tarefa
|
task_id | string |
A ID da entrada de tempo de tarefa está associada. |
|
Projeto
|
project | string |
Nome do projeto ao qual a entrada de tempo está associada. |
|
Tarefa
|
task | string |
Nome da tarefa à qual a entrada de tempo está associada. |
|
Cliente
|
client | string |
Nome do cliente ao qual a entrada de hora está associada. |
|
Anotações
|
notes | string |
Notas de entrada de hora. |
|
Horas sem temporizador
|
hours_without_timer | float |
Tempo atual acompanhado, se o temporizador não estiver em execução. |
|
Horas
|
hours | float |
Número de horas (tempo decimais) rastreadas nesta entrada de tempo. |
ListProjects_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do projeto
|
project.id | integer |
Identificador exclusivo do projeto. |
|
ID do cliente
|
project.client_id | integer |
ID do cliente para o projeto. |
|
Nome
|
project.name | string |
Nome do projeto. |
|
Code
|
project.code | string |
Código do projeto. |
|
Está ativo
|
project.active | boolean |
True se o projeto estiver ativo no momento. |
|
É faturável
|
project.billable | boolean |
True se o projeto for faturável. |
|
Cobrança por
|
project.bill_by | string |
Método pelo qual o projeto é faturado. |
|
Taxa por hora
|
project.hourly_rate | float |
Taxa de cobrança por hora. |
|
Orçamento
|
project.budget | float |
Valor do orçamento do projeto. |
|
Orçamento por
|
project.budget_by | string |
Método de orçamento para o projeto. |
|
Data-hora criada
|
project.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data/hora atualizada
|
project.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data de início
|
project.starts_on | string |
AAAA-MM-DD |
|
Data de término
|
project.ends_on | string |
AAAA-MM-DD |
|
Estimativa
|
project.estimate | float |
Estimativa do projeto. |
|
Estimado por
|
project.estimate_by | string |
Método de estimativa para o projeto. |
|
Data de registro mais antiga
|
project.hint_earliest_record_at | string |
AAAA-MM-DD |
|
Data de registro mais recente
|
project.hint_latest_record_at | string |
AAAA-MM-DD |
|
Anotações
|
project.notes | string |
Notas do projeto. |
|
Orçamento de custo
|
project.cost_budget | float |
Valor de orçamento para o total de projetos de Taxas de Projeto. |
|
O orçamento de custo inclui despesas
|
project.cost_budget_include_expenses | boolean |
Opção para o orçamento de projetos totais de taxas de projeto para incluir despesas controladas. |
ListTasks_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da tarefa
|
task.id | integer |
Identificador exclusivo da tarefa. |
|
Nome
|
task.name | string |
Nome da tarefa. |
|
interno
|
task.billable_by_default | boolean | |
|
Data-hora criada
|
task.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC). |
|
Data/hora atualizada
|
task.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (UTC). |
|
Taxa por hora padrão
|
task.default_hourly_rate | float |
Taxa padrão para a tarefa. |
GetUserByID_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do usuário
|
user.id | integer |
Identificador exclusivo do usuário. |
|
Email
|
user.email | string |
Email do usuário. |
|
Data-hora criada
|
user.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
É administrador
|
user.is_admin | boolean |
True se o usuário for um administrador. |
|
Nome
|
user.first_name | string |
Nome do usuário. |
|
Sobrenome
|
user.last_name | string |
Sobrenome do usuário. |
|
É contratante
|
user.is_contractor | boolean |
True se o usuário for um contratante. |
|
Telefone
|
user.telephone | string |
Telefone do usuário. |
|
Está ativo
|
user.is_active | boolean |
True se o usuário estiver ativo no momento. |
|
Taxa por hora
|
user.default_hourly_rate | float |
Taxa por hora do usuário |
|
Departamento
|
user.department | string |
Nome do departamento em que o usuário trabalha. |
|
Assinatura do boletim informativo
|
user.wants_newsletter | boolean |
True se o usuário quiser assinar o boletim informativo. |
|
Taxa de custo
|
user.cost_rate | float |
Taxa de custo do usuário. |
|
Capacidade semanal
|
user.weekly_capacity | integer |
Capacidade semanal do usuário. |
GetTimeEntriesForDay_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
day_entries
|
day_entries | array of object |
day_entries |
|
ID do projeto
|
day_entries.project_id | string |
Identificador exclusivo do porjeto. |
|
Nome do projeto
|
day_entries.project | string |
Nome do projeto. |
|
ID do usuário
|
day_entries.user_id | integer |
Identificador exclusivo do usuário. |
|
Date
|
day_entries.spent_at | string |
AAAA-MM-DD |
|
ID da tarefa
|
day_entries.task_id | string |
Id da tarefa à qual a entrada de tempo está associada. |
|
Tarefa
|
day_entries.task | string |
Nome da tarefa à qual a entrada de tempo está associada. |
|
Cliente
|
day_entries.client | string |
Nome do cliente ao qual a entrada de hora está associada. |
|
ID de entrada de hora
|
day_entries.id | integer |
Identificador exclusivo da entrada de hora. |
|
Anotações
|
day_entries.notes | string |
Notas de entrada de hora. |
|
Data e hora iniciadas
|
day_entries.started_at | string |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data e hora encerradas
|
day_entries.ended_at | string |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data-hora criada
|
day_entries.created_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Data/hora atualizada
|
day_entries.updated_at | date-time |
YYYY-MM-DDThh:mm:ssZ (formato UTC). |
|
Horas sem temporizador
|
day_entries.hours_without_timer | float |
Tempo atual acompanhado, se o temporizador não estiver em execução. |
|
Horas
|
day_entries.hours | float |
Número de horas (tempo decimais) rastreadas nesta entrada de tempo. |