Cosecha
Harvest es una herramienta sencilla para ayudar a realizar un seguimiento del tiempo invertido por el equipo en cada proyecto y tarea.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://www.getharvest.com/ |
| Directiva de privacidad | https://www.getharvest.com/privacy-policy |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
| Frecuencia de sondeos de desencadenador | 1 | 60 segundos |
Acciones
| Agregar nuevo cliente |
Cree un nuevo cliente. |
| Agregar nuevo contacto |
Cree un nuevo contacto. |
| Agregar nuevo usuario |
Cree un nuevo usuario. |
| Agregar usuario a un proyecto |
Agregue un usuario existente a un proyecto. |
| Crear entrada de hora |
Cree una nueva entrada de hora. |
| Eliminar entrada de hora |
Elimine una entrada de hora existente. |
| Entrada de hora de actualización |
Actualice una entrada de hora existente. |
| Enumerar proyectos |
Enumera todos los proyectos para el usuario actual. |
| Enumerar tareas |
Recupera una lista de todas las tareas. |
| Enumerar todos los clientes |
Recupera una lista de todos los clientes de la cuenta autenticada. |
| Enumerar todos los contactos |
Recupera una lista de todos los contactos para el usuario autenticado. |
| Obtención de información de usuario |
Recupere los detalles de un usuario por identificador de usuario o correo electrónico. |
| Obtención de la entrada de hora por identificador |
Obtenga una entrada de hora existente por identificador. |
Agregar nuevo cliente
Cree un nuevo cliente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
name | True | string |
Nombre del cliente |
|
Moneda
|
currency | string |
Moneda que desea usar para el cliente. |
|
|
Símbolo de moneda
|
currency_symbol | string |
Símbolo que se correlaciona con la moneda seleccionada. |
|
|
Detalles
|
details | string |
Detalles adicionales, que normalmente se usan para la información de dirección. |
Agregar nuevo contacto
Cree un nuevo contacto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de cliente
|
client_id | True | integer |
Identificador único del cliente. |
|
Nombre
|
first_name | True | string |
Nombre del contacto. |
|
Apellido
|
last_name | True | string |
Apellidos del contacto. |
|
Correo Electrónico
|
string |
Correo electrónico del contacto. |
||
|
Teléfono de la oficina
|
phone_office | string |
Teléfono de la oficina del contacto. |
|
|
Teléfono móvil
|
phone_mobile | string |
Teléfono móvil del contacto. |
|
|
Fax
|
fax | string |
Fax del contacto. |
|
|
Title
|
title | string |
Título del contacto. |
Agregar nuevo usuario
Cree un nuevo usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Correo Electrónico
|
True | string | ||
|
¿Es administrador?
|
is_admin | boolean | ||
|
Nombre
|
first_name | True | string | |
|
Apellido
|
last_name | True | string | |
|
Es contratista
|
is_contractor | boolean | ||
|
Teléfono
|
telephone | string | ||
|
Tarifa por hora
|
default_hourly_rate | float |
Tarifa por hora predeterminada. |
|
|
Departamento
|
department | string | ||
|
Índice de coste
|
cost_rate | float |
Agregar usuario a un proyecto
Agregue un usuario existente a un proyecto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificación del proyecto
|
project_id | True | string |
Identificación del proyecto |
|
ID de usuario
|
id | True | integer |
Usuario |
Crear entrada de hora
Cree una nueva entrada de hora.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
notas
|
notes | string | ||
|
horas
|
hours | integer | ||
|
Identificación del proyecto
|
project_id | True | string |
Proyecto |
|
Id. de tarea
|
task_id | True | string |
Tarea |
|
Fecha
|
spent_at | string |
Empleado en |
Devoluciones
Eliminar entrada de hora
Elimine una entrada de hora existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de entrada de hora
|
DAY_ENTRY_ID | True | string |
Identificador de la entrada de hora |
Entrada de hora de actualización
Actualice una entrada de hora existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de entrada de hora
|
DAY_ENTRY_ID | True | string |
Identificador de la entrada de hora |
|
Identificación del proyecto
|
project_id | True | string |
Proyecto |
|
Id. de tarea
|
task_id | True | string |
Tarea |
|
Notas
|
notes | string | ||
|
Fecha y hora de inicio
|
started_at | string |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
|
Fecha y hora finalizadas
|
ended_at | string |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
|
Fecha
|
spent_at | string |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
Devoluciones
Enumerar proyectos
Enumerar tareas
Enumerar todos los clientes
Recupera una lista de todos los clientes de la cuenta autenticada.
Devoluciones
- Productos
- ListAllClients_Response
Enumerar todos los contactos
Recupera una lista de todos los contactos para el usuario autenticado.
Devoluciones
- Productos
- ListAllContacts_Response
Obtención de información de usuario
Recupere los detalles de un usuario por identificador de usuario o correo electrónico.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de usuario o correo electrónico
|
USERID | True | string |
Identificador de usuario o correo electrónico |
Devoluciones
- Body
- GetUserByID_Response
Obtención de la entrada de hora por identificador
Obtenga una entrada de hora existente por identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de entrada de hora
|
DAY_ENTRY_ID | True | string |
Identificador de la entrada de hora |
Devoluciones
Desencadenadores
| Cuando se agrega un cliente |
Se desencadena cuando se agrega un nuevo cliente. |
| Cuando se agrega un contacto |
Se desencadena cuando se agrega un nuevo contacto. |
| Cuando se agrega un usuario |
Se desencadena cuando se agrega un nuevo usuario. |
| Cuando se crea un proyecto |
Se desencadena cuando se crea un nuevo proyecto. |
| Cuando se crea una entrada de hora para el día actual |
Se desencadena cuando se crea una nueva entrada de hora para el día actual. |
| Cuando se crea una entrada de hora para la fecha |
Se desencadena cuando se crea una nueva entrada de hora para una fecha específica. |
Cuando se agrega un cliente
Se desencadena cuando se agrega un nuevo cliente.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de cliente
|
client.id | integer |
Identificador único del cliente. |
|
Nombre
|
client.name | string |
Nombre del cliente. |
|
Moneda
|
client.currency | string |
Moneda que se va a usar para la facturación del cliente. |
|
Fecha y hora actualizadas
|
client.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora creada
|
client.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Dirección
|
client.address | string |
Dirección del cliente. |
|
Símbolo de moneda
|
client.currency_symbol | string |
Símbolo que se correlaciona con la moneda seleccionada. |
|
Detalles
|
client.details | string |
Detalles adicionales, que normalmente se usan para la información de dirección. |
Cuando se agrega un contacto
Se desencadena cuando se agrega un nuevo contacto.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de contacto
|
contact.id | integer |
Identificador único del contacto. |
|
Id. de cliente
|
contact.client_id | integer |
Identificador único del cliente. |
|
Nombre
|
contact.first_name | string |
Nombre del contacto. |
|
Apellido
|
contact.last_name | string |
Apellidos del contacto. |
|
Correo Electrónico
|
contact.email | string |
Correo electrónico del contacto. |
|
Teléfono de la oficina
|
contact.phone_office | string |
Teléfono de la oficina del contacto. |
|
Teléfono móvil
|
contact.phone_mobile | string |
Teléfono móvil del contacto. |
|
Fax
|
contact.fax | string |
Fax del contacto. |
|
Title
|
contact.title | string |
Título del contacto. |
|
Fecha y hora creada
|
contact.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora actualizadas
|
contact.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
Cuando se agrega un usuario
Cuando se crea un proyecto
Se desencadena cuando se crea un nuevo proyecto.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de proyecto
|
project.id | integer |
Identificador único del proyecto. |
|
Id. de cliente
|
project.client_id | integer |
Identificador del cliente para el proyecto. |
|
Nombre
|
project.name | string |
Nombre del proyecto. |
|
Código
|
project.code | string |
Código del proyecto. |
|
Está activo
|
project.active | boolean |
True si el proyecto está activo actualmente. |
|
Es facturable
|
project.billable | boolean |
True si el proyecto es facturable. |
|
Facturar por
|
project.bill_by | string |
Método por el que se factura el proyecto. |
|
Tarifa por hora
|
project.hourly_rate | float |
Tasa de facturación por hora. |
|
Presupuesto
|
project.budget | float |
Valor presupuestado del proyecto. |
|
Presupuesto por
|
project.budget_by | string |
Método de presupuesto para el proyecto. |
|
Fecha y hora creada
|
project.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora actualizadas
|
project.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha de inicio
|
project.starts_on | string |
AAAA-MM-DD |
|
Fecha de finalización
|
project.ends_on | string |
AAAA-MM-DD |
|
Estimación
|
project.estimate | float |
Estimación del proyecto. |
|
Estimado por
|
project.estimate_by | string |
Método de estimación del proyecto. |
|
Fecha de registro más antigua
|
project.hint_earliest_record_at | string |
AAAA-MM-DD |
|
Fecha de registro más reciente
|
project.hint_latest_record_at | string |
AAAA-MM-DD |
|
Notas
|
project.notes | string |
Notas del proyecto. |
|
Presupuesto de coste
|
project.cost_budget | float |
Valor presupuestado para proyectos de Cuotas totales de proyectos. |
|
El presupuesto de costos incluye gastos
|
project.cost_budget_include_expenses | boolean |
Opción para el presupuesto de proyectos totales de cuotas de proyecto para incluir gastos de seguimiento. |
Cuando se crea una entrada de hora para el día actual
Se desencadena cuando se crea una nueva entrada de hora para el día actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Otro identificador de usuario
|
of_user | string |
Identificador del usuario para el que se van a comprobar las entradas de hora. El valor predeterminado es el identificador. |
Devoluciones
Cuando se crea una entrada de hora para la fecha
Se desencadena cuando se crea una nueva entrada de hora para una fecha específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Fecha
|
date | True | string |
AAAA:MM-DD o formato ISO datetime |
|
Otro identificador de usuario
|
of_user | string |
Identificador del usuario para el que se van a comprobar las entradas de hora. |
Devoluciones
Definiciones
ListAllContacts_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de contacto
|
contact.id | integer |
Identificador único del contacto. |
|
Id. de cliente
|
contact.client_id | integer |
Identificador único del cliente. |
|
Nombre
|
contact.first_name | string |
Nombre del contacto. |
|
Apellido
|
contact.last_name | string |
Apellidos del contacto. |
|
Correo Electrónico
|
contact.email | string |
Correo electrónico del contacto. |
|
Teléfono de la oficina
|
contact.phone_office | string |
Teléfono de la oficina del contacto. |
|
Teléfono móvil
|
contact.phone_mobile | string |
Teléfono móvil del contacto. |
|
Fax
|
contact.fax | string |
Fax del contacto. |
|
Title
|
contact.title | string |
Título del contacto. |
|
Fecha y hora creada
|
contact.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora actualizadas
|
contact.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
ListAllClients_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de cliente
|
client.id | integer |
Identificador único del cliente. |
|
Nombre
|
client.name | string |
Nombre del cliente. |
|
Moneda
|
client.currency | string |
Moneda que se va a usar para la facturación del cliente. |
|
Fecha y hora actualizadas
|
client.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora creada
|
client.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Dirección
|
client.address | string |
Dirección del cliente. |
|
Símbolo de moneda
|
client.currency_symbol | string |
Símbolo que se correlaciona con la moneda seleccionada. |
|
Detalles
|
client.details | string |
Detalles adicionales, que normalmente se usan para la información de dirección. |
UpdateTimeEntry_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de entrada de hora
|
id | integer |
Identificador único de la entrada de hora. |
|
Id. de usuario
|
user_id | integer |
Identificador único del usuario que creó la entrada de hora. |
|
Fecha
|
spent_at | string |
Fecha de entrada de hora. |
|
Fecha y hora creada
|
created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora actualizadas
|
updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Id. de proyecto
|
project_id | string |
El identificador de la entrada de hora del proyecto está asociado. |
|
Id. de tarea
|
task_id | string |
El identificador de la entrada de hora de la tarea está asociado. |
|
Proyecto
|
project | string |
Nombre del proyecto al que está asociada la entrada de hora. |
|
Tarea
|
task | string |
Nombre de la tarea a la que está asociada la entrada de hora. |
|
Client
|
client | string |
Nombre del cliente al que está asociada la entrada de hora. |
|
Notas
|
notes | string |
Notas de entrada de hora. |
|
Horas sin temporizador
|
hours_without_timer | float |
Cantidad actual de tiempo de seguimiento, si el temporizador no se está ejecutando. |
|
Horas
|
hours | float |
Número de horas (hora decimal) de las que se realiza el seguimiento en esta entrada de hora. |
ListProjects_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de proyecto
|
project.id | integer |
Identificador único del proyecto. |
|
Id. de cliente
|
project.client_id | integer |
Identificador del cliente para el proyecto. |
|
Nombre
|
project.name | string |
Nombre del proyecto. |
|
Código
|
project.code | string |
Código del proyecto. |
|
Está activo
|
project.active | boolean |
True si el proyecto está activo actualmente. |
|
Es facturable
|
project.billable | boolean |
True si el proyecto es facturable. |
|
Facturar por
|
project.bill_by | string |
Método por el que se factura el proyecto. |
|
Tarifa por hora
|
project.hourly_rate | float |
Tasa de facturación por hora. |
|
Presupuesto
|
project.budget | float |
Valor presupuestado del proyecto. |
|
Presupuesto por
|
project.budget_by | string |
Método de presupuesto para el proyecto. |
|
Fecha y hora creada
|
project.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora actualizadas
|
project.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha de inicio
|
project.starts_on | string |
AAAA-MM-DD |
|
Fecha de finalización
|
project.ends_on | string |
AAAA-MM-DD |
|
Estimación
|
project.estimate | float |
Estimación del proyecto. |
|
Estimado por
|
project.estimate_by | string |
Método de estimación del proyecto. |
|
Fecha de registro más antigua
|
project.hint_earliest_record_at | string |
AAAA-MM-DD |
|
Fecha de registro más reciente
|
project.hint_latest_record_at | string |
AAAA-MM-DD |
|
Notas
|
project.notes | string |
Notas del proyecto. |
|
Presupuesto de coste
|
project.cost_budget | float |
Valor presupuestado para proyectos de Cuotas totales de proyectos. |
|
El presupuesto de costos incluye gastos
|
project.cost_budget_include_expenses | boolean |
Opción para el presupuesto de proyectos totales de cuotas de proyecto para incluir gastos de seguimiento. |
ListTasks_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de tarea
|
task.id | integer |
Identificador único de la tarea. |
|
Nombre
|
task.name | string |
Nombre de la tarea. |
|
interno
|
task.billable_by_default | boolean | |
|
Fecha y hora creada
|
task.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (UTC). |
|
Fecha y hora actualizadas
|
task.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (UTC). |
|
Tarifa por hora predeterminada
|
task.default_hourly_rate | float |
Tasa predeterminada para la tarea. |
GetUserByID_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de usuario
|
user.id | integer |
Identificador único del usuario. |
|
Correo Electrónico
|
user.email | string |
Correo electrónico del usuario. |
|
Fecha y hora creada
|
user.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
¿Es administrador?
|
user.is_admin | boolean |
True si el usuario es administrador. |
|
Nombre
|
user.first_name | string |
Nombre del usuario. |
|
Apellido
|
user.last_name | string |
Apellidos del usuario. |
|
Es contratista
|
user.is_contractor | boolean |
True si el usuario es un contratista. |
|
Teléfono
|
user.telephone | string |
Teléfono del usuario. |
|
Está activo
|
user.is_active | boolean |
True si el usuario está activo actualmente. |
|
Tarifa por hora
|
user.default_hourly_rate | float |
Tarifa por hora del usuario |
|
Departamento
|
user.department | string |
Nombre de departamento en el que trabaja el usuario. |
|
Suscripción al boletín
|
user.wants_newsletter | boolean |
True si el usuario quiere suscribirse al boletín. |
|
Índice de coste
|
user.cost_rate | float |
Tasa de costos del usuario. |
|
Capacidad semanal
|
user.weekly_capacity | integer |
Capacidad semanal del usuario. |
GetTimeEntriesForDay_Response
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
day_entries
|
day_entries | array of object |
day_entries |
|
Id. de proyecto
|
day_entries.project_id | string |
Identificador único del porje. |
|
Nombre de proyecto
|
day_entries.project | string |
Nombre del proyecto. |
|
Id. de usuario
|
day_entries.user_id | integer |
Identificador único del usuario. |
|
Fecha
|
day_entries.spent_at | string |
AAAA-MM-DD |
|
Id. de tarea
|
day_entries.task_id | string |
Identificador de la tarea a la que está asociada la entrada de hora. |
|
Tarea
|
day_entries.task | string |
Nombre de la tarea a la que está asociada la entrada de hora. |
|
Client
|
day_entries.client | string |
Nombre del cliente al que está asociada la entrada de hora. |
|
Id. de entrada de hora
|
day_entries.id | integer |
Identificador único de la entrada de hora. |
|
Notas
|
day_entries.notes | string |
Notas de entrada de hora. |
|
Fecha y hora de inicio
|
day_entries.started_at | string |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora finalizadas
|
day_entries.ended_at | string |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora creada
|
day_entries.created_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Fecha y hora actualizadas
|
day_entries.updated_at | date-time |
AAAA-MM-DDThh:mm:ssZ (formato UTC). |
|
Horas sin temporizador
|
day_entries.hours_without_timer | float |
Cantidad actual de tiempo de seguimiento, si el temporizador no se está ejecutando. |
|
Horas
|
day_entries.hours | float |
Número de horas (hora decimal) de las que se realiza el seguimiento en esta entrada de hora. |