Partilhar via

Colheita

O Harvest é uma ferramenta simples para ajudar a controlar o tempo gasto pela sua equipa em cada projeto e tarefa.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - 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
Editora Microsoft
Sítio Web https://www.getharvest.com/
Política de privacidade https://www.getharvest.com/privacy-policy

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos
Frequência das sondagens de desencadeamento 1 60 segundos

Ações

Adicionar novo cliente

Crie um novo cliente.
Adicionar novo contacto

Crie um novo contato.
Adicionar novo utilizador

Crie um novo usuário.
Adicionar usuário a um projeto

Adicione um usuário existente a um projeto.
Criar entrada de tempo

Crie uma nova entrada de tempo.
Entrada de tempo de atualização

Atualize uma entrada de hora existente.
Excluir entrada de tempo

Exclua uma entrada de hora 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 da conta autenticada.
Listar todos os contatos

Recupera uma lista de todos os contatos do usuário autenticado.
Obter entrada de tempo por id

Obtenha uma entrada de hora existente por id.
Obter informações do usuário

Recupere os detalhes de um usuário por ID de usuário ou e-mail.

Adicionar novo cliente

ID da Operação:
AddNewClient

Crie um novo cliente.

Parâmetros

Name Chave Necessá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 contacto

ID da Operação:
AddNewContact

Crie um novo contato.

Parâmetros

Name Chave Necessário Tipo Description
ID do cliente
 client_id True integer

Identificador único do cliente.
Nome próprio
 first_name True string

Nome próprio do contacto.
Apelido
 last_name True string

Apelido do contacto.
Email
 email string

E-mail do contato.
Telefone do escritório
 phone_office string

Telefone do escritório do contato.
Telemóvel
 phone_mobile string

Telemóvel de contacto.
Fax
 fax string

Fax do contato.
Title
 title string

Título do contacto.

Adicionar novo utilizador

ID da Operação:
CreateUser

Crie um novo usuário.

Parâmetros

Name Chave Necessário Tipo Description
Email
 email True string
É administrador
 is_admin boolean
Nome próprio
 first_name True string
Apelido
 last_name True string
É contratante
 is_contractor boolean
Telemóvel
 telephone string
Tarifa horária
 default_hourly_rate float

Taxa horária padrão.
Departamento
 department string
Taxa de custo
 cost_rate float

Adicionar usuário a um projeto

ID da Operação:
AddUserToProject

Adicione um usuário existente a um projeto.

Parâmetros

Name Chave Necessário Tipo Description
ID do projeto
 project_id True string

ID do projeto
ID do Utilizador
 id True integer

User

Criar entrada de tempo

ID da Operação:
CreateTimeEntry

Crie uma nova entrada de tempo.

Parâmetros

Name Chave Necessário Tipo Description
Observações
 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

Passado em

Devoluções

Body
UpdateTimeEntry_Response

Entrada de tempo de atualização

ID da Operação:
UpdateTimeEntry

Atualize uma entrada de hora existente.

Parâmetros

Name Chave Necessário Tipo Description
ID de entrada de tempo
 DAY_ENTRY_ID True string

O id da entrada de tempo
ID do projeto
 project_id True string

Projeto
ID da Tarefa
 task_id True string

Tarefa
Observações
 notes string
Data-hora de início
 started_at string

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora terminada
 ended_at string

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Date
 spent_at string

AAAA-MM-DDThh:mm:ssZ (formato UTC).

Devoluções

Body
UpdateTimeEntry_Response

Excluir entrada de tempo

ID da Operação:
DeleteTimeEntry

Exclua uma entrada de hora existente.

Parâmetros

Name Chave Necessário Tipo Description
ID de entrada de tempo
 DAY_ENTRY_ID True string

O id da entrada de tempo

Listar projetos

ID da Operação:
ListProjects

Lista todos os projetos para o usuário atual.

Devoluções

Itens
ListProjects_Response

Listar tarefas

ID da Operação:
ListTasks

Recupera uma lista de todas as tarefas.

Devoluções

Itens
ListTasks_Response

Listar todos os clientes

ID da Operação:
ListAllClients

Recupera uma lista de todos os clientes da conta autenticada.

Devoluções

Itens
ListAllClients_Response

Listar todos os contatos

ID da Operação:
ListAllContacts

Recupera uma lista de todos os contatos do usuário autenticado.

Devoluções

Itens
ListAllContacts_Response

Obter entrada de tempo por id

ID da Operação:
GetTimeEntry

Obtenha uma entrada de hora existente por id.

Parâmetros

Name Chave Necessário Tipo Description
ID de entrada de tempo
 DAY_ENTRY_ID True string

O id da entrada de tempo

Devoluções

Body
UpdateTimeEntry_Response

Obter informações do usuário

ID da Operação:
GetUser

Recupere os detalhes de um usuário por ID de usuário ou e-mail.

Parâmetros

Name Chave Necessário Tipo Description
ID de utilizador ou e-mail
 USERID True string

ID de utilizador ou e-mail

Devoluções

Body
GetUserByID_Response

Acionadores

Quando um cliente é adicionado

Aciona quando um novo cliente é adicionado.
Quando um contato é adicionado

Aciona quando um novo contato é adicionado.
Quando um projeto é criado

Aciona quando um novo projeto é criado.
Quando um usuário é adicionado

Aciona quando um novo usuário é adicionado.
Quando uma entrada de hora é criada para a data

Aciona quando uma nova entrada de hora é criada para uma data específica.
Quando uma entrada de hora é criada para o dia atual

Aciona quando uma nova entrada de hora é criada para o dia atual.

Quando um cliente é adicionado

ID da Operação:
TrigNewClient

Aciona quando um novo cliente é adicionado.

Devoluções

Name Caminho Tipo Description
ID do cliente
 client.id integer

Identificador único do cliente.
Nome
 client.name string

Nome do cliente.
Moeda
 client.currency string

Moeda a utilizar na faturação do cliente.
Data-hora atualizada
 client.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora criada
 client.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Address
 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

ID da Operação:
TrigNewContact

Aciona quando um novo contato é adicionado.

Devoluções

Name Caminho Tipo Description
ID de contacto
 contact.id integer

Identificador exclusivo do contato.
ID do cliente
 contact.client_id integer

Identificador único do cliente.
Nome próprio
 contact.first_name string

Nome próprio do contacto.
Apelido
 contact.last_name string

Apelido do contacto.
Email
 contact.email string

E-mail do contato.
Telefone do escritório
 contact.phone_office string

Telefone do escritório do contato.
Telemóvel
 contact.phone_mobile string

Telemóvel de contacto.
Fax
 contact.fax string

Fax do contato.
Title
 contact.title string

Título do contacto.
Data-hora criada
 contact.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora atualizada
 contact.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).

Quando um projeto é criado

ID da Operação:
TrigNewProject

Aciona quando um novo projeto é criado.

Devoluções

Name Caminho Tipo Description
Id do projeto
 project.id integer

Identificador único do projeto.
ID do cliente
 project.client_id integer

Id do cliente para o projeto.
Nome
 project.name string

Nome do projeto.
Código
 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.
Projeto de lei por
 project.bill_by string

Método pelo qual o projeto é faturado.
Tarifa horária
 project.hourly_rate float

Taxa de faturação por hora.
Orçamento
 project.budget float

Valor do orçamento para o projeto.
Orçamento por
 project.budget_by string

Método de orçamentação para o projeto.
Data-hora criada
 project.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora atualizada
 project.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data de início
 project.starts_on string

AAAA-MM-DD
Data de fim
 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 registo mais antiga
 project.hint_earliest_record_at string

AAAA-MM-DD
Data do último registo
 project.hint_latest_record_at string

AAAA-MM-DD
Observações
 project.notes string

Notas do projeto.
Orçamento dos custos
 project.cost_budget float

Valor do orçamento para projetos de Taxas de Projeto Totais.
O orçamento de custos inclui despesas
 project.cost_budget_include_expenses boolean

Opção de orçamento de projetos de Taxas de Projeto Totais para incluir despesas controladas.

Quando um usuário é adicionado

ID da Operação:
TrigNewUser

Aciona quando um novo usuário é adicionado.

Devoluções

Body
GetUserByID_Response

Quando uma entrada de hora é criada para a data

ID da Operação:
TrigNewTimeEntry

Aciona quando uma nova entrada de hora é criada para uma data específica.

Parâmetros

Name Chave Necessário Tipo Description
Date
 date True string

AAAAA -MM-DD ou formato ISO datetime
Outro ID de utilizador
 of_user string

O id do usuário para verificar as entradas de tempo.

Devoluções

Body
GetTimeEntriesForDay_Response

Quando uma entrada de hora é criada para o dia atual

ID da Operação:
TrigNewTimeEntryToday

Aciona quando uma nova entrada de hora é criada para o dia atual.

Parâmetros

Name Chave Necessário Tipo Description
Outro ID de utilizador
 of_user string

O id do usuário para verificar as entradas de tempo. O padrão é o seu id.

Devoluções

Body
GetTimeEntriesForDay_Response

Definições

ListAllContacts_Response

Name Caminho Tipo Description
ID de contacto
 contact.id integer

Identificador exclusivo do contato.
ID do cliente
 contact.client_id integer

Identificador único do cliente.
Nome próprio
 contact.first_name string

Nome próprio do contacto.
Apelido
 contact.last_name string

Apelido do contacto.
Email
 contact.email string

E-mail do contato.
Telefone do escritório
 contact.phone_office string

Telefone do escritório do contato.
Telemóvel
 contact.phone_mobile string

Telemóvel de contacto.
Fax
 contact.fax string

Fax do contato.
Title
 contact.title string

Título do contacto.
Data-hora criada
 contact.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora atualizada
 contact.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).

ListAllClients_Response

Name Caminho Tipo Description
ID do cliente
 client.id integer

Identificador único do cliente.
Nome
 client.name string

Nome do cliente.
Moeda
 client.currency string

Moeda a utilizar na faturação do cliente.
Data-hora atualizada
 client.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora criada
 client.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Address
 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

Name Caminho Tipo Description
ID de entrada de tempo
 id integer

Identificador exclusivo da entrada de tempo.
ID do utilizador
 user_id integer

Identificador exclusivo do usuário que criou a entrada de hora.
Date
 spent_at string

Data de entrada da hora.
Data-hora criada
 created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora atualizada
 updated_at date-time

AAAA-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 da 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.
Client
 client string

Nome do cliente ao qual a entrada de hora está associada.
Observações
 notes string

Notas de entrada de tempo.
Horas sem temporizador
 hours_without_timer float

Quantidade atual de tempo controlado, se o temporizador não estiver em execução.
Horário
 hours float

Número de horas (tempo decimal) controladas nesta entrada de tempo.

ListProjects_Response

Name Caminho Tipo Description
Id do projeto
 project.id integer

Identificador único do projeto.
ID do cliente
 project.client_id integer

Id do cliente para o projeto.
Nome
 project.name string

Nome do projeto.
Código
 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.
Projeto de lei por
 project.bill_by string

Método pelo qual o projeto é faturado.
Tarifa horária
 project.hourly_rate float

Taxa de faturação por hora.
Orçamento
 project.budget float

Valor do orçamento para o projeto.
Orçamento por
 project.budget_by string

Método de orçamentação para o projeto.
Data-hora criada
 project.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora atualizada
 project.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data de início
 project.starts_on string

AAAA-MM-DD
Data de fim
 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 registo mais antiga
 project.hint_earliest_record_at string

AAAA-MM-DD
Data do último registo
 project.hint_latest_record_at string

AAAA-MM-DD
Observações
 project.notes string

Notas do projeto.
Orçamento dos custos
 project.cost_budget float

Valor do orçamento para projetos de Taxas de Projeto Totais.
O orçamento de custos inclui despesas
 project.cost_budget_include_expenses boolean

Opção de orçamento de projetos de Taxas de Projeto Totais para incluir despesas controladas.

ListTasks_Response

Name 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

AAAA-MM-DDThh:mm:ssZ (UTC).
Data-hora atualizada
 task.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (UTC).
Taxa horária padrão
 task.default_hourly_rate float

Taxa padrão para a tarefa.

GetUserByID_Response

Name Caminho Tipo Description
ID do utilizador
 user.id integer

Identificador exclusivo do usuário.
Email
 user.email string

E-mail do usuário.
Data-hora criada
 user.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
É administrador
 user.is_admin boolean

True se o usuário for um administrador.
Nome próprio
 user.first_name string

Nome do usuário.
Apelido
 user.last_name string

Apelido do utilizador.
É contratante
 user.is_contractor boolean

True se o usuário for um contratante.
Telemóvel
 user.telephone string

Telefone do usuário.
Está ativo
 user.is_active boolean

True se o usuário estiver ativo no momento.
Tarifa horária
 user.default_hourly_rate float

Taxa horária do utilizador
Departamento
 user.department string

Nome do departamento em que o usuário trabalha.
Subscrição da newsletter
 user.wants_newsletter boolean

True se o utilizador quiser subscrever a newsletter.
Taxa de custo
 user.cost_rate float

Taxa de custo do utilizador.
Capacidade semanal
 user.weekly_capacity integer

Capacidade semanal do utilizador.

GetTimeEntriesForDay_Response

Name Caminho Tipo Description
day_entries
 day_entries array of object

day_entries
Id do projeto
 day_entries.project_id string

Identificador único do porjecto.
Nome do projeto
 day_entries.project string

Nome do projeto.
ID do utilizador
 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.
Client
 day_entries.client string

Nome do cliente ao qual a entrada de hora está associada.
ID de entrada de tempo
 day_entries.id integer

Identificador exclusivo da entrada de tempo.
Observações
 day_entries.notes string

Notas de entrada de tempo.
Data-hora de início
 day_entries.started_at string

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora terminada
 day_entries.ended_at string

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora criada
 day_entries.created_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Data-hora atualizada
 day_entries.updated_at date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC).
Horas sem temporizador
 day_entries.hours_without_timer float

Quantidade atual de tempo controlado, se o temporizador não estiver em execução.
Horário
 day_entries.hours float

Número de horas (tempo decimal) controladas nesta entrada de tempo.