Pista toggl (publicador independiente) (versión preliminar)
El único software de seguimiento de tiempo que crea informes personalizados a partir de los datos de tiempo de su equipo para maximizar la productividad y los ingresos. Nuestra solución de seguimiento de tiempo registra una escala de tiempo del calendario de todas sus actividades de trabajo durante todo el día.
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 | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| Correo Electrónico | ttaylor@hitachisolutions.com |
| Metadatos del conector | |
|---|---|
| Publicador | troystaylor |
| Sitio web | https://toggl.com/track/automated-time-tracker/ |
| Directiva de privacidad | https://toggl.com/legal/track/privacy/ |
| Categorías | Productividad |
Pista de toggl
El único software de seguimiento de tiempo que crea informes personalizados a partir de los datos de tiempo de su equipo para maximizar la productividad y los ingresos. Nuestra solución de seguimiento de tiempo registra una escala de tiempo del calendario de todas sus actividades de trabajo durante todo el día.
Editor: Troy Taylor, Hitachi Solutions
Prerrequisitos
Debe registrarse para obtener una cuenta con Toggl.
Obtención de credenciales
Este conector usa la autenticación básica con la dirección de correo electrónico y la contraseña.
Operaciones admitidas
Obtención del usuario actual
Devuelve los detalles del usuario actual.
Actualización del usuario actual
Actualiza los detalles del usuario actual.
Obtención de clientes de usuario
Obtener clientes para el usuario actual.
Obtención de características de usuario
Obtenga características disponibles para el usuario actual.
Obtención de la ubicación del usuario
Devuelve la ubicación basada en IP del cliente. Si no hay datos presentes, se producirá una respuesta vacía.
Comprobación de la autenticación
Se usa para comprobar si la autenticación funciona.
Obtención de organizaciones de usuarios
Obtiene todas las organizaciones de las que forma parte un usuario determinado.
Obtención de proyectos de usuario
Obtenga proyectos para el usuario actual.
Obtención de proyectos de usuario paginados
Obtenga proyectos paginados para el usuario actual.
Obtención de etiquetas de usuario
Devuelve etiquetas para el usuario actual.
Obtención de tareas de usuario
Devuelve tareas de proyectos en los que participa el usuario.
Obtener recordatorios de seguimiento
Devuelve una lista de recordatorios de seguimiento.
Obtener temporizador web
Obtiene la configuración del temporizador web.
Obtención de áreas de trabajo de usuario
Enumera las áreas de trabajo para un usuario determinado.
Obtener entradas de hora
Enumera las entradas de hora más recientes.
Obtener la entrada de hora actual
Carga de la entrada de tiempo de ejecución para el identificador de usuario.
Obtención de la entrada de hora por identificador
Entrada de tiempo de carga por identificador al que puede acceder el usuario actual.
Obtener usuarios del área de trabajo (nivel de organización)
Devuelve los usuarios que pertenecen al área de trabajo directamente o a través de al menos un grupo.
Obtención de usuarios del área de trabajo
Enumerar todos los usuarios de un área de trabajo determinada.
Obtener usuarios del proyecto del área de trabajo
Enumerar todos los usuarios de proyectos para un área de trabajo determinada.
Obtención de clientes de usuario
Obtener clientes para el usuario actual.
Obtención de organizaciones de usuarios
Obtiene todas las organizaciones de las que forma parte un usuario determinado.
Obtener usuarios del área de trabajo (nivel de organización)
Devuelve los usuarios que pertenecen al área de trabajo directamente o a través de al menos un grupo.
Obtención de proyectos de usuario
Obtenga proyectos para el usuario actual.
Obtención de proyectos de usuario paginados
Obtenga proyectos paginados para el usuario actual.
Obtener usuarios del proyecto del área de trabajo
Enumerar todos los usuarios de proyectos para un área de trabajo determinada.
Obtener proyectos de área de trabajo
Obtener proyectos para un área de trabajo determinada.
Obtención del proyecto del área de trabajo
Obtenga el proyecto para un área de trabajo determinada.
Obtención de etiquetas de usuario
Devuelve etiquetas para el usuario actual.
Obtención de tareas de usuario
Devuelve tareas de proyectos en los que participa el usuario.
Obtención de áreas de trabajo de usuario
Enumera las áreas de trabajo para un usuario determinado.
Crear entrada de hora
Crea una nueva entrada de hora del área de trabajo.
Eliminar entrada de hora
Elimina una entrada de hora del área de trabajo.
Entrada de hora de actualización
Actualiza una entrada de hora del área de trabajo.
Entradas de tiempo de edición masiva
Entradas de tiempo de edición masiva. La revisión se ejecutará parcialmente cuando haya errores con algunos registros. Sin transacción, sin reversión.
Entrada de hora de detención
Detiene una entrada de tiempo del área de trabajo.
Obtener usuarios del área de trabajo (nivel de organización)
Devuelve los usuarios que pertenecen al área de trabajo directamente o a través de al menos un grupo.
Obtención de un único área de trabajo
Obtenga información de una sola área de trabajo.
Obtener la lista de tarifas
Obtiene las tarifas por nivel (área de trabajo|proyecto|tarea|usuario).
Obtener estadísticas del área de trabajo
Devuelve la lista de administradores del área de trabajo, el recuento de miembros y el recuento de grupos.
Obtención de restricciones de entrada de hora del área de trabajo
Obtenga las restricciones de entrada de hora de un área de trabajo determinada.
Obtención de recordatorios de seguimiento del área de trabajo
Devuelve una lista de recordatorios de seguimiento.
Obtención de usuarios del área de trabajo
Enumerar todos los usuarios de un área de trabajo determinada.
Obtener usuarios del proyecto del área de trabajo
Enumerar todos los usuarios de proyectos para un área de trabajo determinada.
Obtener proyectos de área de trabajo
Obtener proyectos para un área de trabajo determinada.
Obtención del proyecto del área de trabajo
Obtenga el proyecto para un área de trabajo determinada.
Obtener entradas de hora
Enumera las entradas de hora más recientes.
Obtener la entrada de hora actual
Carga de la entrada de tiempo de ejecución para el identificador de usuario.
Obtención de la entrada de hora por identificador
Entrada de tiempo de carga por identificador al que puede acceder el usuario actual.
Cuando se crea una entrada de hora
Se desencadena cuando se crea una nueva entrada de hora en el área de trabajo.
Cuando se actualiza una entrada de hora
Se desencadena cuando se modifica una entrada de hora existente en el área de trabajo.
Cuando se elimina una entrada de hora
Se desencadena cuando se elimina una entrada de hora del área de trabajo.
Cuando se inicia una entrada de hora
Se desencadena cuando se inicia una entrada de hora (comienza el temporizador) en el área de trabajo.
Cuando se detiene una entrada de hora
Se desencadena cuando se detiene una entrada en tiempo de ejecución en el área de trabajo.
Problemas conocidos y limitaciones
No hay problemas conocidos en este momento.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Nombre de usuario | securestring | El nombre de usuario de esta API | Cierto |
| Contraseña | securestring | La contraseña de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualización del usuario actual |
Actualiza los detalles del usuario actual. |
| Comprobación de la autenticación |
Se usa para comprobar si la autenticación funciona. |
| Crear entrada de hora |
Crea una nueva área de trabajo TimeEntry. |
| Eliminar entrada de hora |
Elimina una entrada de hora del área de trabajo. |
| Entrada de hora de actualización |
Actualiza una entrada de hora del área de trabajo. |
| Entrada de hora de detención |
Detiene una entrada de tiempo del área de trabajo. |
| Entradas de tiempo de edición masiva |
Entradas de tiempo de edición masiva. La revisión se ejecutará parcialmente cuando haya errores con algunos registros. Sin transacción, sin reversión. |
| Obtención de características de usuario |
Obtenga características disponibles para el usuario actual. |
| Obtención de clientes de usuario |
Obtener clientes para el usuario actual. |
| Obtención de etiquetas de usuario |
Devuelve etiquetas para el usuario actual. |
| Obtención de la entrada de hora por identificador |
Entrada de tiempo de carga por identificador al que puede acceder el usuario actual. |
| Obtención de la ubicación del usuario |
Devuelve la ubicación basada en IP del cliente. Si no hay datos presentes, se producirá una respuesta vacía. |
| Obtención de organizaciones de usuarios |
Obtiene todas las organizaciones de las que forma parte un usuario determinado. |
| Obtención de proyectos de usuario |
Obtenga proyectos para el usuario actual. |
| Obtención de proyectos de usuario paginados |
Obtenga proyectos paginados para el usuario actual. |
| Obtención de recordatorios de seguimiento del área de trabajo |
Devuelve una lista de recordatorios de seguimiento. |
| Obtención de restricciones de entrada de hora del área de trabajo |
Obtenga las restricciones de entrada de hora de un área de trabajo determinada. |
| Obtención de tareas de usuario |
Devuelve tareas de proyectos en los que participa el usuario. |
| Obtención de un único área de trabajo |
Obtenga información de una sola área de trabajo. |
| Obtención de usuarios del área de trabajo |
Enumerar todos los usuarios de un área de trabajo determinada. |
| Obtención de áreas de trabajo de usuario |
Enumera las áreas de trabajo para un usuario determinado. |
| Obtención del proyecto del área de trabajo |
Obtenga el proyecto para un área de trabajo determinada. |
| Obtención del usuario actual |
Devuelve los detalles del usuario actual. |
| Obtener entradas de hora |
Enumera las entradas de hora más recientes. |
| Obtener estadísticas del área de trabajo |
Devuelve la lista de administradores del área de trabajo, el recuento de miembros y el recuento de grupos. |
| Obtener la entrada de hora actual |
Carga de la entrada de tiempo de ejecución para el identificador de usuario. |
| Obtener la lista de tarifas |
Obtiene las tarifas por nivel (área de trabajo|proyecto|tarea|usuario). |
| Obtener proyectos de área de trabajo |
Obtener proyectos para un área de trabajo determinada. |
| Obtener recordatorios de seguimiento |
Devuelve una lista de recordatorios de seguimiento. |
| Obtener temporizador web |
Obtiene la configuración del temporizador web. |
| Obtener usuarios del proyecto del área de trabajo |
Enumerar todos los usuarios de proyectos para un área de trabajo determinada. |
| Obtener usuarios del área de trabajo (nivel de organización) |
Devuelve los usuarios que pertenecen al área de trabajo directamente o a través de al menos un grupo. |
Actualización del usuario actual
Actualiza los detalles del usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Comienzo de la semana
|
beginning_of_week | integer |
Primer día de la semana del usuario. Domingo: 0, lunes: 1, etc. |
|
|
Id. de país
|
country_id | integer |
Identificador de país del usuario. |
|
|
Contraseña actual
|
current_password | string |
Contraseña actual del usuario (usada para cambiar la contraseña actual). |
|
|
Identificador de área de trabajo predeterminado
|
default_workspace_id | integer |
Identificador de área de trabajo predeterminado del usuario. |
|
|
Correo Electrónico
|
string |
Dirección de correo electrónico del usuario. |
||
|
Nombre completo
|
fullname | string |
Nombre completo del usuario. |
|
|
Nueva contraseña
|
password | string |
Nueva contraseña del usuario (también se debe proporcionar la actual). |
|
|
Timezone
|
timezone | string |
Zona horaria del usuario. |
Devoluciones
- Body
- UserBasicResponse
Comprobación de la autenticación
Se usa para comprobar si la autenticación funciona.
Crear entrada de hora
Crea una nueva área de trabajo TimeEntry.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Incluir metadatos
|
meta | boolean |
Si la respuesta contiene datos para las entidades meta. |
|
|
Facturable
|
billable | boolean |
Indica si la entrada de hora está marcada como facturable, opcional y predeterminada false. |
|
|
Creado con
|
created_with | string |
Debe proporcionarse al crear una entrada de hora e identificar el servicio o la aplicación que se usa para crearla. |
|
|
Description
|
description | string |
Descripción de la entrada de hora, opcional. |
|
|
Duración
|
duration | integer |
Duración de la entrada de hora. Para las entradas en ejecución debe ser negativa, preferiblemente -1. |
|
|
Solo duración
|
duronly | boolean |
En desuso: se usa para crear una entrada de hora con una duración, pero sin tiempo de detención. Este parámetro se puede omitir. |
|
|
Característica de origen
|
origin_feature | string |
Nombre de la característica de origen. |
|
|
Recuento de objetivos visibles
|
visible_goals_count | integer |
Número de objetivos visibles. |
|
|
Identificadores de gastos
|
expense_ids | array of integer |
Gastos de trabajo asociados a la entrada de hora. |
|
|
Id. de proyecto (heredado)
|
pid | integer |
Identificador de proyecto, campo heredado. |
|
|
Id. de proyecto
|
project_id | integer |
Identificador de proyecto, opcional. |
|
|
Compartido con identificadores de usuario
|
shared_with_user_ids | array of integer |
Lista de identificadores de usuario con los que compartir esta entrada de hora. |
|
|
Hora de comienzo
|
start | string |
Hora de inicio en UTC, necesaria para la creación. Formato: 2006-01-02T15:04:05Z. |
|
|
Fecha de inicio
|
start_date | string |
Si se proporciona durante la creación, la parte de fecha tendrá prioridad sobre la parte de fecha de "inicio". Formato: 2006-11-07. |
|
|
Tiempo de detención
|
stop | string |
Se puede omitir la hora de detención en UTC si todavía se está ejecutando o se crea con "duración". Si se proporcionan 'stop' y 'duration', los valores deben ser coherentes (start + duration == stop). |
|
|
Acción de etiqueta
|
tag_action | string |
Puede ser "add" o "delete". Se usa al actualizar una entrada de hora existente. |
|
|
Identificadores de etiqueta
|
tag_ids | array of integer |
Identificadores de etiquetas que se van a agregar o quitar. |
|
|
Etiquetas
|
tags | array of string |
Nombres de etiquetas que se van a agregar o quitar. Si el nombre no existe como etiqueta, se creará automáticamente uno. |
|
|
Id. de la tarea
|
task_id | integer |
Id. de tarea, opcional. |
|
|
Id. de tarea (heredado)
|
tid | integer |
Id. de tarea, campo heredado. |
|
|
Id. de usuario (heredado)
|
uid | integer |
Id. de creador de entrada de hora, campo heredado. |
|
|
Id. de usuario
|
user_id | integer |
Id. de creador de entrada de hora, si se omite, usará el identificador de usuario del solicitante. |
|
|
Id. del área de trabajo (heredado)
|
wid | integer |
Identificador del área de trabajo, campo heredado. |
|
|
ID del espacio de trabajo
|
workspace_id | integer |
Identificador del área de trabajo, obligatorio. |
Devoluciones
- Body
- TimeEntry
Eliminar entrada de hora
Elimina una entrada de hora del área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Id. de entrada de hora
|
time_entry_id | True | integer |
Id. de TimeEntry. |
Entrada de hora de actualización
Actualiza una entrada de hora del área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Id. de entrada de hora
|
time_entry_id | True | integer |
Id. de TimeEntry. |
|
Incluir metadatos
|
meta | boolean |
Si la respuesta contiene datos para las entidades meta. |
|
|
Incluir uso compartido
|
include_sharing | boolean |
Incluya los detalles de uso compartido en la respuesta. |
|
|
Facturable
|
billable | boolean |
Indica si la entrada de hora está marcada como facturable, opcional y predeterminada false. |
|
|
Creado con
|
created_with | string |
Debe proporcionarse al crear una entrada de hora e identificar el servicio o la aplicación que se usa para crearla. |
|
|
Description
|
description | string |
Descripción de la entrada de hora, opcional. |
|
|
Duración
|
duration | integer |
Duración de la entrada de hora. Para las entradas en ejecución debe ser negativa, preferiblemente -1. |
|
|
Solo duración
|
duronly | boolean |
En desuso: se usa para crear una entrada de hora con una duración, pero sin tiempo de detención. Este parámetro se puede omitir. |
|
|
Característica de origen
|
origin_feature | string |
Nombre de la característica de origen. |
|
|
Recuento de objetivos visibles
|
visible_goals_count | integer |
Número de objetivos visibles. |
|
|
Identificadores de gastos
|
expense_ids | array of integer |
Gastos de trabajo asociados a la entrada de hora. |
|
|
Id. de proyecto (heredado)
|
pid | integer |
Identificador de proyecto, campo heredado. |
|
|
Id. de proyecto
|
project_id | integer |
Identificador de proyecto, opcional. |
|
|
Compartido con identificadores de usuario
|
shared_with_user_ids | array of integer |
Lista de identificadores de usuario con los que compartir esta entrada de hora. |
|
|
Hora de comienzo
|
start | string |
Hora de inicio en UTC, necesaria para la creación. Formato: 2006-01-02T15:04:05Z. |
|
|
Fecha de inicio
|
start_date | string |
Si se proporciona durante la creación, la parte de fecha tendrá prioridad sobre la parte de fecha de "inicio". Formato: 2006-11-07. |
|
|
Tiempo de detención
|
stop | string |
Se puede omitir la hora de detención en UTC si todavía se está ejecutando o se crea con "duración". Si se proporcionan 'stop' y 'duration', los valores deben ser coherentes (start + duration == stop). |
|
|
Acción de etiqueta
|
tag_action | string |
Puede ser "add" o "delete". Se usa al actualizar una entrada de hora existente. |
|
|
Identificadores de etiqueta
|
tag_ids | array of integer |
Identificadores de etiquetas que se van a agregar o quitar. |
|
|
Etiquetas
|
tags | array of string |
Nombres de etiquetas que se van a agregar o quitar. Si el nombre no existe como etiqueta, se creará automáticamente uno. |
|
|
Id. de la tarea
|
task_id | integer |
Id. de tarea, opcional. |
|
|
Id. de tarea (heredado)
|
tid | integer |
Id. de tarea, campo heredado. |
|
|
Id. de usuario (heredado)
|
uid | integer |
Id. de creador de entrada de hora, campo heredado. |
|
|
Id. de usuario
|
user_id | integer |
Id. de creador de entrada de hora, si se omite, usará el identificador de usuario del solicitante. |
|
|
Id. del área de trabajo (heredado)
|
wid | integer |
Identificador del área de trabajo, campo heredado. |
|
|
ID del espacio de trabajo
|
workspace_id | integer |
Identificador del área de trabajo, obligatorio. |
Devoluciones
- Body
- TimeEntry
Entrada de hora de detención
Detiene una entrada de tiempo del área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Id. de entrada de hora
|
time_entry_id | True | integer |
Id. de TimeEntry. |
Devoluciones
- Body
- TimeEntry
Entradas de tiempo de edición masiva
Entradas de tiempo de edición masiva. La revisión se ejecutará parcialmente cuando haya errores con algunos registros. Sin transacción, sin reversión.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Identificadores de entrada de hora
|
time_entry_ids | True | string |
Identificadores numéricos de time_entries, separados por comas. Por ejemplo: 204301830,202700150,202687559. El límite es de 100 identificadores por solicitud. |
|
Incluir metadatos
|
meta | boolean |
Si la respuesta contiene datos para las entidades meta. |
|
|
Operation
|
op | True | string |
Operación (agregar, quitar o reemplazar). |
|
Ruta
|
path | True | string |
Ruta de acceso a la entidad que se va a aplicar a la revisión (por ejemplo, /description). |
|
Importancia
|
value | object |
Nuevo valor de la entidad en la ruta de acceso. |
Devoluciones
- Body
- BulkEditResponse
Obtención de características de usuario
Obtenga características disponibles para el usuario actual.
Devoluciones
- response
- array of WorkspaceFeatures
Obtención de clientes de usuario
Obtener clientes para el usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
Devoluciones
- response
- array of Client
Obtención de etiquetas de usuario
Devuelve etiquetas para el usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
Devoluciones
- response
- array of Tag
Obtención de la entrada de hora por identificador
Entrada de tiempo de carga por identificador al que puede acceder el usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de entrada de hora
|
time_entry_id | True | integer |
Id. de TimeEntry. |
|
Incluir metadatos
|
meta | boolean |
Si la respuesta contiene datos para las entidades meta. |
|
|
Incluir uso compartido
|
include_sharing | boolean |
Incluya los detalles de uso compartido en la respuesta. |
Devoluciones
- Body
- TimeEntry
Obtención de la ubicación del usuario
Devuelve la ubicación basada en IP del cliente. Si no hay datos presentes, se producirá una respuesta vacía.
Devoluciones
- Body
- LocationResponse
Obtención de organizaciones de usuarios
Obtiene todas las organizaciones de las que forma parte un usuario determinado.
Devoluciones
- response
- array of Organization
Obtención de proyectos de usuario
Obtenga proyectos para el usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incluir archivado
|
include_archived | string |
Incluir proyectos archivados. |
|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
Devoluciones
- response
- array of Project
Obtención de proyectos de usuario paginados
Obtenga proyectos paginados para el usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Iniciar el id. de proyecto
|
start_project_id | integer |
Id. de proyecto desde el que reanudar la siguiente paginación. |
|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
|
|
Elementos por página
|
per_page | integer |
Número de elementos por página, valor predeterminado 201. |
Devoluciones
- response
- array of Project
Obtención de recordatorios de seguimiento del área de trabajo
Devuelve una lista de recordatorios de seguimiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
Devoluciones
Obtención de restricciones de entrada de hora del área de trabajo
Obtenga las restricciones de entrada de hora de un área de trabajo determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
Devoluciones
- Body
- TimeEntryConstraints
Obtención de tareas de usuario
Devuelve tareas de proyectos en los que participa el usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incluir metadatos
|
meta | boolean |
Si la respuesta contiene datos para las entidades meta. |
|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
|
|
Incluir tareas inactivas
|
include_not_active | string |
Incluya las tareas marcadas como finalizadas. |
|
|
Desplazamiento de paginación
|
offset | integer |
Desplazamiento para reanudar la siguiente paginación desde. |
|
|
Elementos por página
|
per_page | integer |
Número de elementos por página, valor predeterminado 201. |
Devoluciones
- response
- array of Task
Obtención de un único área de trabajo
Obtenga información de una sola área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
Devoluciones
- Body
- Workspace
Obtención de usuarios del área de trabajo
Enumerar todos los usuarios de un área de trabajo determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Excluir eliminado
|
exclude_deleted | boolean |
Excluya los registros eliminados en la respuesta. |
Devoluciones
- response
- array of WorkspaceUserSimple
Obtención de áreas de trabajo de usuario
Enumera las áreas de trabajo para un usuario determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
Devoluciones
- response
- array of Workspace
Obtención del proyecto del área de trabajo
Obtenga el proyecto para un área de trabajo determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Id. de proyecto
|
project_id | True | integer |
Identificador numérico del proyecto. |
Devoluciones
- Body
- Project
Obtención del usuario actual
Devuelve los detalles del usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incluir datos relacionados
|
with_related_data | boolean |
Recuperar datos relacionados con el usuario (clientes, proyectos, tareas, etiquetas, áreas de trabajo, entradas de tiempo, etc.). |
Devoluciones
- Body
- UserResponse
Obtener entradas de hora
Enumera las entradas de hora más recientes.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incluir metadatos
|
meta | boolean |
Si la respuesta contiene datos para las entidades meta. |
|
|
Incluir uso compartido
|
include_sharing | boolean |
Incluya los detalles de uso compartido en la respuesta. |
|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
|
|
Fecha anterior
|
before | string |
Obtenga entradas con la hora de inicio, antes de la fecha especificada (AAAA-MM-DD) o con la hora en formato RFC3339. |
|
|
Fecha de inicio
|
start_date | string |
Obtenga entradas con hora de inicio, desde start_date aaaa-MM-DD o con hora en formato RFC3339. Para usarse con end_date. |
|
|
Fecha de finalización
|
end_date | string |
Obtenga entradas con hora de inicio, hasta end_date YYYY-MM-DD o con hora en formato de RFC3339. Para usarse con start_date. |
Devoluciones
- response
- array of TimeEntry
Obtener estadísticas del área de trabajo
Devuelve la lista de administradores del área de trabajo, el recuento de miembros y el recuento de grupos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
Devoluciones
- Body
- WorkspaceStatistics
Obtener la entrada de hora actual
Carga de la entrada de tiempo de ejecución para el identificador de usuario.
Devoluciones
- Body
- TimeEntry
Obtener la lista de tarifas
Obtiene las tarifas por nivel (área de trabajo|proyecto|tarea|usuario).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Level
|
level | True | string |
Nivel de tarifas: área de trabajo, proyecto, tarea o usuario. |
|
Id. de nivel
|
level_id | True | integer |
Identificador numérico del nivel de entidad. |
|
Tipo de velocidad
|
type | string |
Tipo de valores de velocidad que se van a devolver: billable_rates o labor_costs. El valor predeterminado es billable_rates. |
Devoluciones
- response
- array of Rate
Obtener proyectos de área de trabajo
Obtener proyectos para un área de trabajo determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Ordenar anclado
|
sort_pinned | True | boolean |
Coloque los proyectos anclados en la parte superior de la respuesta. |
|
Solo usuarios activos
|
active | boolean |
Devuelve solo usuarios activos. |
|
|
Desde fecha
|
since | integer |
Recupere elementos creados, modificados o eliminados desde esta fecha mediante la marca de tiempo de UNIX. |
|
|
Facturable
|
billable | boolean |
Filtre por estado facturable. |
|
|
Seudónimos
|
user_ids | array |
Identificadores de usuario por los que se va a filtrar. |
|
|
Identificadores de cliente
|
client_ids | array |
Identificadores de cliente por los que se va a filtrar. |
|
|
Identificadores de grupo
|
group_ids | array |
Identificadores de grupo por los que filtrar. |
|
|
Identificadores de proyecto
|
project_ids | string |
Identificadores numéricos de proyectos, separados por comas. |
|
|
Estados
|
statuses | array |
Estados del proyecto por los que se va a filtrar. |
|
|
Filtro de nombre
|
name | string |
Nombre de usuario del área de trabajo por la que se va a filtrar. |
|
|
Número de página
|
page | integer |
Número de página. |
|
|
Ordenar campo
|
sort_field | True | string |
Campo por el que se va a ordenar. |
|
Criterio de ordenación
|
sort_order | True | string |
Criterio de ordenación (asc/desc). |
|
Solo plantillas
|
only_templates | True | boolean |
Devuelve solo plantillas de proyecto. |
|
Solo mis proyectos
|
only_me | boolean |
Obtenga solo los proyectos asignados al usuario actual. |
|
|
Elementos por página
|
per_page | integer |
Número de elementos por página, valor predeterminado 201. |
Devoluciones
- response
- array of Project
Obtener recordatorios de seguimiento
Obtener temporizador web
Obtiene la configuración del temporizador web.
Obtener usuarios del proyecto del área de trabajo
Enumerar todos los usuarios de proyectos para un área de trabajo determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Identificadores de proyecto
|
project_ids | string |
Identificadores numéricos de proyectos, separados por comas. |
|
|
Id. de usuario
|
user_id | string |
Identificador numérico del usuario, si se pasa devuelve solo los usuarios del proyecto para los proyectos de este usuario. |
|
|
Incluir miembros del grupo
|
with_group_members | boolean |
Incluir miembros del grupo. |
Devoluciones
- response
- array of ProjectUser
Obtener usuarios del área de trabajo (nivel de organización)
Devuelve los usuarios que pertenecen al área de trabajo directamente o a través de al menos un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de organización
|
organization_id | True | integer |
Identificador numérico de la organización. |
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Número de página
|
page | integer |
Número de página. |
|
|
Elementos por página
|
per_page | integer |
Número de elementos por página, valor predeterminado 201. |
|
|
Filtro de tarifas personalizadas
|
custom_rates | boolean |
Devuelve solo los usuarios con o sin una tarifa por hora personalizada, respectivamente. |
|
|
Solo usuarios activos
|
active | boolean |
Devuelve solo usuarios activos. |
|
|
Filtro de nombre
|
name | string |
Nombre de usuario del área de trabajo por la que se va a filtrar. |
|
|
Filtro de búsqueda
|
search | string |
Filtro del área de trabajo por nombre o correo electrónico. |
Devoluciones
- response
- array of WorkspaceUser
Desencadenadores
| Cuando se actualiza una entrada de hora |
Se desencadena cuando se modifica una entrada de hora existente en el área de trabajo. |
| Cuando se crea una entrada de hora |
Se desencadena cuando se crea una nueva entrada de hora en el área de trabajo. |
| Cuando se detiene una entrada de hora |
Se desencadena cuando se detiene una entrada en tiempo de ejecución en el área de trabajo. |
| Cuando se elimina una entrada de hora |
Se desencadena cuando se elimina una entrada de hora del área de trabajo. |
| Cuando se inicia una entrada de hora |
Se desencadena cuando se inicia una entrada de hora (comienza el temporizador) en el área de trabajo. |
Cuando se actualiza una entrada de hora
Se desencadena cuando se modifica una entrada de hora existente en el área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Entidad
|
entity | string |
Toggl Track business entity to filter (Seguimiento de la entidad empresarial para filtrar). |
|
|
Acción
|
action | string |
Tipo de modificación aplicada a la entidad. |
Devoluciones
Cuando se crea una entrada de hora
Se desencadena cuando se crea una nueva entrada de hora en el área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Entidad
|
entity | string |
Toggl Track business entity to filter (Seguimiento de la entidad empresarial para filtrar). |
|
|
Acción
|
action | string |
Tipo de modificación aplicada a la entidad. |
Devoluciones
Cuando se detiene una entrada de hora
Se desencadena cuando se detiene una entrada en tiempo de ejecución en el área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Entidad
|
entity | string |
Toggl Track business entity to filter (Seguimiento de la entidad empresarial para filtrar). |
|
|
Acción
|
action | string |
Tipo de modificación aplicada a la entidad. |
Devoluciones
Cuando se elimina una entrada de hora
Se desencadena cuando se elimina una entrada de hora del área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Entidad
|
entity | string |
Toggl Track business entity to filter (Seguimiento de la entidad empresarial para filtrar). |
|
|
Acción
|
action | string |
Tipo de modificación aplicada a la entidad. |
Devoluciones
Cuando se inicia una entrada de hora
Se desencadena cuando se inicia una entrada de hora (comienza el temporizador) en el área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID del espacio de trabajo
|
workspace_id | True | integer |
Identificador numérico del área de trabajo. |
|
Entidad
|
entity | string |
Toggl Track business entity to filter (Seguimiento de la entidad empresarial para filtrar). |
|
|
Acción
|
action | string |
Tipo de modificación aplicada a la entidad. |
Devoluciones
Definiciones
UserResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
2FA habilitado
|
2fa_enabled | boolean |
Estado habilitado para la autenticación en dos fases. |
|
Token API
|
api_token | string |
El token de API se omitirá si está vacío. |
|
Última actualización
|
at | string |
Marca de tiempo de la última actualización. |
|
Autorización actualizada
|
authorization_updated_at | string |
Marca de tiempo en la que se actualizó por última vez el objeto de sesión de usuario de autorización. |
|
Comienzo de la semana
|
beginning_of_week | integer |
Primer día de la semana del usuario (0=domingo, 1=lunes, etc.). |
|
Clients
|
clients | array of Client |
Clientes, null si with_related_data no se estableció en true. |
|
Id. de país
|
country_id | integer |
Identificador de país del usuario. |
|
Creado en
|
created_at | string |
Marca de tiempo de creación de usuarios. |
|
Identificador de área de trabajo predeterminado
|
default_workspace_id | integer |
Identificador de área de trabajo predeterminado del usuario. |
|
Correo Electrónico
|
string |
Dirección de correo electrónico del usuario. |
|
|
Nombre completo
|
fullname | string |
Nombre completo del usuario. |
|
Tiene contraseña
|
has_password | boolean |
Si el usuario tiene una contraseña establecida. |
|
Id. de usuario
|
id | integer |
Id. de usuario |
|
URL de imagen
|
image_url | string |
Dirección URL de la imagen de perfil del usuario. |
|
Intercom Hash
|
intercom_hash | string |
Se omitirá el hash de intercom si está vacío. |
|
Proveedores de OAuth
|
oauth_providers | array of string |
Proveedores de OAuth disponibles para el usuario. |
|
Correo electrónico de OpenID
|
openid_email | string |
Dirección de correo electrónico de OpenID. |
|
OpenID habilitado
|
openid_enabled | boolean |
Estado habilitado para la autenticación openID. |
|
Options
|
options | object |
Las opciones de usuario se omitirán si están vacías. |
|
Proyectos
|
projects | array of Project |
Proyectos, null si with_related_data no se estableció en true. |
|
Etiquetas
|
tags | array of Tag |
Etiquetas, null si with_related_data no se estableció en true. |
|
Tasks
|
tasks | array of Task |
Tasks, null si with_related_data no se estableció en true. |
|
Entradas de hora
|
time_entries | array of TimeEntry |
Entradas de hora, null si with_related_data no se estableció en true. |
|
Timezone
|
timezone | string |
Zona horaria del usuario. |
|
Actualizado en
|
updated_at | string |
Marca de tiempo de la última actualización del usuario. |
|
Áreas de trabajo
|
workspaces | array of Workspace |
Áreas de trabajo, null si with_related_data no se estableció en true. |
UserBasicResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
2FA habilitado
|
2fa_enabled | boolean |
Estado habilitado para la autenticación en dos fases. |
|
Token API
|
api_token | string |
El token de API se omitirá si está vacío. |
|
Última actualización
|
at | string |
Marca de tiempo de la última actualización. |
|
Comienzo de la semana
|
beginning_of_week | integer |
Primer día de la semana del usuario. |
|
Id. de país
|
country_id | integer |
Identificador de país del usuario. |
|
Creado en
|
created_at | string |
Marca de tiempo de creación de usuarios. |
|
Identificador de área de trabajo predeterminado
|
default_workspace_id | integer |
Identificador de área de trabajo predeterminado del usuario. |
|
Correo Electrónico
|
string |
Dirección de correo electrónico del usuario. |
|
|
Nombre completo
|
fullname | string |
Nombre completo del usuario. |
|
Tiene contraseña
|
has_password | boolean |
Si el usuario tiene una contraseña establecida. |
|
Id. de usuario
|
id | integer |
Id. de usuario |
|
URL de imagen
|
image_url | string |
Dirección URL de la imagen de perfil del usuario. |
|
Correo electrónico de OpenID
|
openid_email | string |
Dirección de correo electrónico de OpenID. |
|
OpenID habilitado
|
openid_enabled | boolean |
Estado habilitado para la autenticación openID. |
|
Options
|
options | object |
Las opciones de usuario se omitirán si están vacías. |
|
Timezone
|
timezone | string |
Zona horaria del usuario. |
|
Actualizado en
|
updated_at | string |
Marca de tiempo de la última actualización del usuario. |
Client
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Archivado
|
archived | boolean |
Es true si el cliente está archivado. |
|
Última actualización
|
at | string |
Cuándo fue la última actualización. |
|
Id. de creador
|
creator_id | integer |
Identificador del usuario que creó el cliente. |
|
Referencia externa
|
external_reference | string |
Referencia externa a la entidad Track Client. |
|
Id. de cliente
|
id | integer |
Id. de cliente. |
|
Id. externo de integración
|
integration_ext_id | string |
Identificador externo de la entidad vinculada en el sistema externo. |
|
Tipo externo de integración
|
integration_ext_type | string |
Tipo externo de la entidad vinculada en el sistema externo. |
|
Proveedor de integración
|
integration_provider | object |
Proveedor que tiene una entidad vinculada a esta entidad Toggl Track. |
|
Nombre de cliente
|
name | string |
Nombre del cliente. |
|
Notas
|
notes | string |
Notas del cliente. |
|
Permissions
|
permissions | array of string |
Lista de permisos de autorización para este cliente. |
|
Recuento total
|
total_count | integer |
Campo total para almacenar el recuento total. |
|
ID del espacio de trabajo
|
wid | integer |
Id. del área de trabajo. |
Proyecto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Active
|
active | boolean |
Indica si el proyecto está activo o archivado. |
|
Horas reales
|
actual_hours | integer |
Horas reales dedicadas al proyecto. |
|
Segundos reales
|
actual_seconds | integer |
Segundos reales invertidos en el proyecto. |
|
Última actualización
|
at | string |
Fecha de última actualización. |
|
Estimaciones automáticas
|
auto_estimates | boolean |
Estimaciones automáticas habilitadas. |
|
Facturable
|
billable | boolean |
Indica si el proyecto es facturable. |
|
Puede realizar un seguimiento del tiempo
|
can_track_time | boolean |
Si se puede realizar un seguimiento del tiempo en este proyecto. |
|
Id. de cliente (heredado)
|
cid | integer |
Campo heredado id. de cliente. |
|
Id. de cliente
|
client_id | integer |
Id. de cliente. |
|
Nombre de cliente
|
client_name | string |
Nombre de cliente. |
|
Color
|
color | string |
Color del proyecto. |
|
Creado en
|
created_at | string |
Fecha de creación. |
|
Moneda
|
currency | string |
Moneda del proyecto. |
|
Período actual
|
current_period | object |
Período de proyecto actual, característica premium. |
|
Fecha de finalización
|
end_date | string |
Fecha de finalización del proyecto. |
|
Horas estimadas
|
estimated_hours | integer |
Horas estimadas para el proyecto. |
|
Segundos estimados
|
estimated_seconds | integer |
Segundos estimados para el proyecto. |
|
Referencia externa
|
external_reference | string |
Referencia externa a la entidad Track Project. |
|
Cuota fija
|
fixed_fee | double |
Tarifa fija, característica premium. |
|
Id. de proyecto
|
id | integer |
Id. de proyecto. |
|
Id. externo de integración
|
integration_ext_id | string |
Identificador externo de la entidad vinculada en el sistema externo. |
|
Tipo externo de integración
|
integration_ext_type | string |
Tipo externo de la entidad vinculada en el sistema externo. |
|
Proveedor de integración
|
integration_provider | object |
Proveedor que tiene una entidad vinculada a esta entidad Toggl Track. |
|
Es privado
|
is_private | boolean |
Si el proyecto es privado. |
|
Nombre del proyecto
|
name | string |
Nombre del proyecto. |
|
Permissions
|
permissions | array of string |
Permisos de proyecto. |
|
Anclado
|
pinned | boolean |
Indica si el proyecto está anclado. |
|
Tarifa por hora
|
rate | double |
Tarifa por hora para el proyecto. |
|
Tasa actualizada por última vez
|
rate_last_updated | string |
Cuándo se actualizó por última vez la tasa. |
|
Periódico
|
recurring | boolean |
Si el proyecto es periódico, característica Premium. |
|
Parámetros periódicos
|
recurring_parameters | array of RecurringParameter |
Parámetros periódicos del proyecto, característica Premium. |
|
Fecha de inicio
|
start_date | string |
Fecha de inicio del proyecto. |
|
Estado
|
status | string |
Estado del proyecto (próximo, activo, finalizado, archivado, eliminado). |
|
Template
|
template | boolean |
Si el proyecto es una plantilla. |
|
Identificador de plantilla
|
template_id | integer |
Identificador de plantilla si el proyecto se basa en la plantilla. |
|
Recuento total
|
total_count | integer |
Número total de proyectos encontrados. |
|
Id. del área de trabajo (heredado)
|
wid | integer |
Campo heredado id. de área de trabajo. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
RecurringParameter
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Período personalizado
|
custom_period | integer |
Período personalizado, que se usa cuando el campo de período es "personalizado". |
|
Segundos estimados
|
estimated_seconds | integer |
Segundos estimados. |
|
Fecha de finalización del parámetro
|
parameter_end_date | string |
Fecha de finalización del parámetro. |
|
Fecha de inicio del parámetro
|
parameter_start_date | string |
Fecha de inicio periódica. |
|
Período
|
period | string |
Período periódico. |
|
Fecha de inicio del proyecto
|
project_start_date | string |
Fecha de inicio del proyecto. |
Etiqueta
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Última modificación
|
at | string |
Cuando se creó o modificó por última vez. |
|
Id. de creador
|
creator_id | integer |
Identificador del usuario que creó la etiqueta. |
|
Eliminado en
|
deleted_at | string |
Cuándo se eliminó. |
|
Identificador de etiqueta
|
id | integer |
Identificador de etiqueta. |
|
Id. externo de integración
|
integration_ext_id | string |
Identificador externo de la entidad vinculada en el sistema externo. |
|
Tipo externo de integración
|
integration_ext_type | string |
Tipo externo de la entidad vinculada en el sistema externo. |
|
Proveedor de integración
|
integration_provider | object |
Proveedor que tiene una entidad vinculada a esta entidad Toggl Track. |
|
Nombre de etiqueta
|
name | string |
Nombre de etiqueta. |
|
Permissions
|
permissions | array of string |
Permisos de etiqueta. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
Tarea
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Active
|
active | boolean |
False cuando se ha realizado la tarea. |
|
Última modificación
|
at | string |
Cuando se creó o modificó la tarea por última vez. |
|
Avatar URL
|
avatar_url | string |
Dirección URL del avatar. |
|
Nombre de cliente
|
client_name | string |
Nombre de cliente. |
|
Segundos estimados
|
estimated_seconds | integer |
Segundos estimados para la tarea. |
|
Id. de la tarea
|
id | integer |
Id. de tarea. |
|
Id. externo de integración
|
integration_ext_id | string |
Identificador externo de la entidad vinculada en el sistema externo. |
|
Tipo externo de integración
|
integration_ext_type | string |
Tipo externo de la entidad vinculada en el sistema externo. |
|
Proveedor de integración
|
integration_provider | object |
Proveedor que tiene una entidad vinculada a esta entidad Toggl Track. |
|
Nombre de tarea
|
name | string |
Nombre de la tarea. |
|
Permissions
|
permissions | array of string |
Permisos de tarea. |
|
Facturable del proyecto
|
project_billable | boolean |
Indica si el proyecto es facturable. |
|
Color del proyecto
|
project_color | string |
Metadatos de color del proyecto. |
|
Id. de proyecto
|
project_id | integer |
Id. de proyecto. |
|
El proyecto es privado
|
project_is_private | boolean |
Si el proyecto es privado. |
|
Nombre del proyecto
|
project_name | string |
Nombre del proyecto. |
|
Tasa
|
rate | double |
Tasa de esta tarea. |
|
Tasa actualizada por última vez
|
rate_last_updated | string |
Cuándo se actualizó por última vez la tasa. |
|
Periódico
|
recurring | boolean |
Si se trata de una tarea periódica. |
|
Id. de cuentas de alternancia
|
toggl_accounts_id | string |
Id. de cuentas de alternancia. |
|
Segundos de seguimiento
|
tracked_seconds | integer |
El valor tracked_seconds está en milisegundos, no en segundos. |
|
Id. de usuario
|
user_id | integer |
Id. de usuario |
|
Nombre de usuario
|
user_name | string |
Nombre de usuario. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
TimeEntry
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Última actualización
|
at | string |
Cuando se actualizó por última vez, sigue el formato ISO 8601. |
|
Facturable
|
billable | boolean |
Indica si la entrada de hora está marcada como facturable. |
|
Nombre de cliente
|
client_name | string |
Campos meta de entidades relacionadas. |
|
Description
|
description | string |
Descripción de la entrada de hora. |
|
Duración
|
duration | integer |
Duración de la entrada de hora. Para las entradas en ejecución debe ser negativa, preferiblemente -1. |
|
Solo duración
|
duronly | boolean |
Se usa para crear un TE con una duración, pero sin tiempo de detención. |
|
Identificadores de gastos
|
expense_ids | array of integer |
Gastos de trabajo. |
|
Id. de entrada de hora
|
id | integer |
Id. de entrada de hora. |
|
Permissions
|
permissions | array of string |
Lista de permisos. |
|
Id. de proyecto (heredado)
|
pid | integer |
Identificador de proyecto, campo heredado. |
|
Project Active
|
project_active | boolean |
Indica si el proyecto está activo. |
|
Facturable del proyecto
|
project_billable | boolean |
Indica si el proyecto es facturable. |
|
Color del proyecto
|
project_color | string |
Color del proyecto. |
|
Id. de proyecto
|
project_id | integer |
Id. de proyecto. |
|
Nombre del proyecto
|
project_name | string |
Nombre del proyecto. |
|
Compartido con
|
shared_with | array of SharedWith |
Indica con quién se ha compartido la entrada de hora. |
|
Hora de comienzo
|
start | string |
Hora de inicio en UTC. |
|
Tiempo de detención
|
stop | string |
La hora de detención en UTC puede ser NULL si todavía se está ejecutando. |
|
Identificadores de etiqueta
|
tag_ids | array of integer |
Identificadores de etiqueta, null si no se proporcionaron etiquetas o se eliminaron posteriormente. |
|
Etiquetas
|
tags | array of string |
Nombres de etiqueta, null si no se proporcionaron etiquetas o se eliminaron más adelante. |
|
Id. de la tarea
|
task_id | integer |
Id. de tarea. |
|
Nombre de tarea
|
task_name | string |
Nombre de la tarea. |
|
Id. de tarea (heredado)
|
tid | integer |
Id. de tarea, campo heredado. |
|
Id. de usuario (heredado)
|
uid | integer |
Id. de creador de entrada de hora, campo heredado. |
|
Dirección URL del avatar de usuario
|
user_avatar_url | string |
Dirección URL del avatar del usuario. |
|
Id. de usuario
|
user_id | integer |
Id. de creador de entrada de hora. |
|
Nombre de usuario
|
user_name | string |
Nombre de usuario. |
|
Id. del área de trabajo (heredado)
|
wid | integer |
Identificador del área de trabajo, campo heredado. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
SharedWith
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Aceptado
|
accepted | boolean |
Si se aceptó el recurso compartido. |
|
Id. de usuario
|
user_id | integer |
Identificador de usuario de la persona con la que se ha compartido. |
|
Nombre de usuario
|
user_name | string |
Nombre de usuario de la persona con la que se ha compartido. |
Workspace
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento de proyectos activos
|
active_project_count | integer |
Número de proyectos activos. |
|
Admin
|
admin | boolean |
El usuario actual es el administrador del área de trabajo (en desuso). |
|
Token API
|
api_token | string |
Token de API (en desuso). |
|
Última modificación
|
at | string |
Marca de tiempo del último cambio de área de trabajo. |
|
Área de trabajo empresarial
|
business_ws | boolean |
Área de trabajo en la suscripción Premium. |
|
Carga de CSV
|
csv_upload | object |
Carga de datos csv. |
|
Moneda predeterminada
|
default_currency | string |
Moneda predeterminada, característica Premium. |
|
Tarifa por hora predeterminada
|
default_hourly_rate | double |
La tarifa por hora predeterminada, característica Premium. |
|
Deshabilitar aprobaciones
|
disable_approvals | boolean |
Deshabilite las aprobaciones en el área de trabajo. |
|
Deshabilitar la vista parte de horas
|
disable_timesheet_view | boolean |
Deshabilite la vista del parte de horas en el área de trabajo. |
|
Ocultar horas de finalización de inicio
|
hide_start_end_times | boolean |
Ocultar las horas de inicio y finalización. |
|
iCal habilitado
|
ical_enabled | boolean |
Integración del calendario habilitada. |
|
Dirección URL de iCal
|
ical_url | string |
Dirección URL del calendario. |
|
ID del espacio de trabajo
|
id | integer |
Identificador del área de trabajo. |
|
Última modificación
|
last_modified | string |
Última modificación de los datos del área de trabajo. |
|
Limitar los datos del proyecto público
|
limit_public_project_data | boolean |
Limite los datos de los proyectos públicos en los informes a los administradores. |
|
Dirección URL del logotipo
|
logo_url | string |
Dirección URL del logotipo del área de trabajo. |
|
Máximo de días de retención de datos
|
max_data_retention_days | object |
Hasta qué punto las áreas de trabajo libres pueden acceder a los datos. |
|
Nombre del área de trabajo
|
name | string |
Nombre del área de trabajo. |
|
Solo los administradores pueden crear proyectos
|
only_admins_may_create_projects | boolean |
Solo los administradores podrán crear proyectos. |
|
Solo los administradores pueden crear etiquetas
|
only_admins_may_create_tags | boolean |
Solo los administradores podrán crear etiquetas. |
|
Solo los administradores ven panel de equipo
|
only_admins_see_team_dashboard | boolean |
Solo los administradores podrán ver el panel del equipo. |
|
Id. de organización
|
organization_id | integer |
Identificador de la organización. |
|
Permissions
|
permissions | array of string |
Lista de permisos. |
|
Premium
|
premium | boolean |
Área de trabajo en la suscripción de Starter. |
|
Proyectos facturables de forma predeterminada
|
projects_billable_by_default | boolean |
Los nuevos proyectos facturables de forma predeterminada. |
|
Proyectos ejecutables facturables
|
projects_enforce_billable | boolean |
Si el seguimiento del tiempo de los proyectos aplicará la configuración facturable que se respetará. |
|
Proyectos privados de forma predeterminada
|
projects_private_by_default | boolean |
Configuración del área de trabajo para la visibilidad predeterminada del proyecto. |
|
Tasa actualizada por última vez
|
rate_last_updated | string |
Marca de tiempo de la última actualización de velocidad del área de trabajo. |
|
Contraer informes
|
reports_collapse | boolean |
Si los informes deben contraerse de forma predeterminada. |
|
Rol
|
role | string |
Rol del usuario actual en el área de trabajo. |
|
Redondeo
|
rounding | integer |
Redondeo predeterminado, característica Premium. 0 - más cercano, 1 - redondeo, -1 - redondeo hacia abajo. |
|
Redondeo de minutos
|
rounding_minutes | integer |
Redondeo predeterminado en minutos, característica Premium. |
|
Subscription
|
subscription | object |
Detalles de la suscripción (en desuso). |
|
Suspendido en
|
suspended_at | string |
Marca de tiempo de suspensión. |
|
Restricciones de entrada de hora
|
te_constraints | object |
Configuración de restricciones de entrada de hora. |
|
Horario laboral en minutos
|
working_hours_in_minutes | integer |
Horas de trabajo en cuestión de minutos. |
Característica
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Enabled
|
enabled | boolean |
Si la característica está habilitada. |
|
Id. de la característica
|
feature_id | integer |
Id. de característica. |
|
Nombre de la característica
|
name | string |
Nombre de la característica. |
WorkspaceFeatures
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Características
|
features | array of Feature |
Lista de características. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
LocationResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
City
|
city | string |
Nombre de la ciudad. |
|
Coordenadas de la ciudad
|
city_lat_long | string |
Latitud y longitud de la ciudad. |
|
Código de país
|
country_code | string |
Código de país. |
|
Nombre del país
|
country_name | string |
Nombre del país. |
|
Estado
|
state | string |
Estado o región. |
Organización
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Admin
|
admin | boolean |
Si el solicitante es un administrador de la organización. |
|
Última modificación
|
at | string |
Fecha de última modificación de la organización. |
|
Creado en
|
created_at | string |
Fecha de creación de la organización. |
|
Id. de organización
|
id | integer |
Id. de organización. |
|
Varias áreas de trabajo habilitadas
|
is_multi_workspace_enabled | boolean |
Es true cuando se establece la opción de organización is_multi_workspace_enabled. |
|
Es unificado
|
is_unified | boolean |
Es una organización unificada. |
|
Máximo de días de retención de datos
|
max_data_retention_days | object |
Hasta qué punto las áreas de trabajo libres de esta organización pueden acceder a los datos. |
|
Número máximo de áreas de trabajo
|
max_workspaces | integer |
Número máximo de áreas de trabajo permitidas para la organización. |
|
Nombre de la organización
|
name | string |
Nombre de la organización. |
|
Propietario
|
owner | boolean |
Si el solicitante es el propietario de la organización. |
|
Permissions
|
permissions | array of string |
Permisos de la organización. |
|
Plan de precios Enterprise
|
pricing_plan_enterprise | boolean |
El plan de suscripción es un plan empresarial. |
|
Id. del plan de precios
|
pricing_plan_id | integer |
Identificador del plan de la organización. |
|
Nombre del plan de precios
|
pricing_plan_name | string |
El nombre del plan de suscripción en el que está actualmente la organización. |
|
Suspendido en
|
suspended_at | string |
Si la organización está suspendida actualmente. |
|
trial_info
|
trial_info | TrialInfo | |
|
Recuento de usuarios
|
user_count | integer |
Número de usuarios de la organización. |
TrialInfo
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Puede tener una versión de prueba
|
can_have_trial | boolean |
Es cierto si ni la organización ni el propietario nunca han tenido una prueba antes. |
|
Último identificador del plan de precios
|
last_pricing_plan_id | integer |
Último identificador del plan de precios. |
|
Fecha de pago siguiente
|
next_payment_date | string |
Fecha de pago siguiente. |
|
Prueba
|
trial | boolean |
Si la suscripción de la organización está actualmente en prueba. |
|
Prueba disponible
|
trial_available | boolean |
Cuando hay una versión de prueba disponible para esta organización (en desuso). |
|
Fecha de finalización de la prueba
|
trial_end_date | string |
Fecha de finalización de la prueba. |
|
Identificador del plan de prueba
|
trial_plan_id | integer |
Identificador del plan de prueba. |
TrackReminder
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Creado en
|
created_at | string |
Hora de creación del recordatorio. |
|
Frecuencia
|
frequency | integer |
La frecuencia del aviso en días debe ser 1 o 7. |
|
Identificadores de grupo
|
group_ids | array of integer |
Agrupa los identificadores a los que enviar el aviso. |
|
Id. de recordatorio
|
reminder_id | integer |
Id. de recordatorio. |
|
Umbral
|
threshold | integer |
Umbral es el número de horas después de las cuales se enviará el aviso. |
|
Seudónimos
|
user_ids | array of integer |
Identificadores de usuario para enviar el aviso. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
TrackRemindersResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Seguimiento de recordatorios
|
items | array of TrackReminder |
Devuelve una lista de recordatorios de seguimiento. |
BulkEditResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Fallas
|
failure | array of BulkEditFailure |
Lista de operaciones con errores. |
|
Identificadores correctos
|
success | array of integer |
Identificadores para los que la revisión se realizó correctamente. |
BulkEditFailure
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de error
|
id | integer |
Identificador para el que se produjo un error en la operación de revisión. |
|
Mensaje de error
|
message | string |
Motivo del error de la operación. |
WorkspaceUser
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
2FA habilitado
|
2fa_enabled | boolean |
Marca que indica si el uso tiene habilitado 2FA o no. |
|
Active
|
active | boolean |
Marca que indica si el usuario aceptó la invitación. |
|
Admin
|
admin | boolean |
Marca que indica si el usuario es administrador. |
|
Última actualización
|
at | string |
Marca de tiempo de la última actualización. |
|
Avatar URL
|
avatar_file_name | string |
Dirección URL del avatar. |
|
Correo Electrónico
|
string |
Correo electrónico del usuario. |
|
|
Identificadores de grupo
|
group_ids | array of integer |
Lista de grupos a los que pertenece el usuario. |
|
Identificador del área de trabajo de usuario
|
id | integer |
Identificador del área de trabajo de usuario. |
|
Inactivo
|
inactive | boolean |
Marca que indica si el administrador del área de trabajo ha desactivado el usuario. |
|
Código de invitación
|
invitation_code | string |
Código de invitación interno. |
|
Dirección URL de invitación
|
invite_url | string |
Dirección URL de invitación interna. |
|
Es miembro directo
|
is_direct | boolean |
Marca que indica si el usuario es miembro directo del área de trabajo (no se asigna al área de trabajo mediante el grupo). |
|
Costo laboral
|
labor_cost | double |
Costo laboral asignado al usuario. |
|
Costo laboral actualizado por última vez
|
labor_cost_last_updated | string |
Marca de tiempo de la última actualización del costo laboral. |
|
Nombre
|
name | string |
Nombre del usuario. |
|
Administrador de la organización
|
organization_admin | boolean |
Marca que indica si el usuario es administrador dentro de la organización. |
|
Tasa
|
rate | double |
Tasa asignada al usuario. |
|
Tasa actualizada por última vez
|
rate_last_updated | string |
Marca de tiempo de la última actualización de velocidad. |
|
Rol
|
role | string |
Rol del usuario. |
|
Id. de rol
|
role_id | integer |
Id. de rol. |
|
Timezone
|
timezone | string |
Zona horaria del usuario. |
|
Identificador de usuario global
|
uid | integer |
Identificador de usuario global. |
|
Id. de usuario
|
user_id | integer |
Campo JSON alternativo userID, que solo usa get-organization-workspaces-workspaceusers. |
|
Ver tarifas facturables editables
|
view_edit_billable_rates | boolean |
Marcas de permisos de velocidad pormenorizadas. Solo surte efecto en los roles con permisos de frecuencia condicional. |
|
Ver editar costos laborales
|
view_edit_labor_costs | boolean |
Ver el permiso editar costos laborales. |
|
ID del espacio de trabajo
|
wid | integer |
Identificador del área de trabajo. |
|
Horario laboral en minutos
|
working_hours_in_minutes | integer |
Valor de horas laborables en minutos. |
|
Administrador del área de trabajo
|
workspace_admin | boolean |
Marca que indica si el usuario es administrador dentro del área de trabajo. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Campo JSON alternativo userID, que solo usa get-organization-workspaces-workspaceusers. |
Tasa
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Importe
|
amount | double |
Cantidad de la tarifa. |
|
Creado en
|
created_at | string |
Fecha de creación de la tasa. |
|
Id. de creador
|
creator_id | integer |
Id. de creador. |
|
Eliminado en
|
deleted_at | string |
Fecha de eliminación de la tasa, en caso de que sea null, significa que las tasas están activas. |
|
Fecha de finalización
|
end | string |
Fecha de finalización de la tasa. |
|
Id. de velocidad
|
id | integer |
Identificador de la tasa. |
|
Id. de tarea planeada
|
planned_task_id | integer |
Identificador de tarea planeado que se aplica la tasa. |
|
Id. de proyecto
|
project_id | integer |
Id. de proyecto que se aplica la tasa. |
|
Identificador de usuario del proyecto
|
project_user_id | integer |
Identificador de usuario del proyecto que se aplica la tasa. |
|
Modo de cambio de frecuencia
|
rate_change_mode | string |
Modo de cambio de frecuencia. |
|
Fecha de inicio
|
start | string |
Fecha de inicio de la tarifa. |
|
Tipo
|
type | string |
Tipo de velocidad. |
|
Actualizado en
|
updated_at | string |
Fecha de última actualización de la tasa. |
|
ID del espacio de trabajo
|
workspace_id | integer |
Identificador del área de trabajo que se aplica la tasa. |
|
Id. de usuario del área de trabajo
|
workspace_user_id | integer |
Identificador de usuario del área de trabajo que se aplica la tasa. |
WorkspaceStatistics
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Administradores
|
admins | array of WorkspaceAdmin |
Lista de administradores del área de trabajo. |
|
Recuento de grupos
|
groups_count | integer |
Número de grupos en el área de trabajo. |
|
Recuento de miembros
|
members_count | integer |
Número de miembros del área de trabajo. |
WorkspaceAdmin
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
name | string |
Nombre del administrador. |
|
Id. de usuario
|
user_id | integer |
Id. de usuario administrador. |
TimeEntryConstraints
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Descripción requerida
|
description_present | boolean |
La descripción es necesaria para las entradas de tiempo. |
|
Proyecto requerido
|
project_present | boolean |
El proyecto es necesario para las entradas de tiempo. |
|
Etiqueta necesaria
|
tag_present | boolean |
La etiqueta es necesaria para las entradas de tiempo. |
|
Tarea requerida
|
task_present | boolean |
La tarea es necesaria para las entradas de tiempo. |
|
Restricciones habilitadas
|
time_entry_constraints_enabled | boolean |
Las restricciones de entrada de hora están habilitadas. |
WorkspaceUserSimple
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Correo Electrónico
|
string |
Correo electrónico del usuario. |
|
|
Nombre completo
|
fullname | string |
Nombre del usuario. |
|
Id. de usuario
|
id | integer |
Identificador de usuario global. |
|
Inactivo
|
inactive | boolean |
Inactivo indica si el usuario está desactivado o no en el área de trabajo. |
|
Está activo
|
is_active | boolean |
IsActive indica si el usuario se ha unido al área de trabajo. |
|
Es administrador (en desuso)
|
is_admin | boolean |
Marca que indica si el usuario es administrador (en desuso). |
|
Rol
|
role | string |
Rol del usuario. |
ProjectUser
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Última modificación
|
at | string |
Cuándo se modificó por última vez. |
|
Id. de grupo (heredado)
|
gid | integer |
Id. de grupo, campo heredado. |
|
Identificador de grupo
|
group_id | integer |
Id. de grupo. |
|
Identificador de usuario del proyecto
|
id | integer |
Id. de usuario del proyecto. |
|
Costo laboral
|
labor_cost | double |
Costo de mano de obra para este usuario del proyecto. |
|
Costo laboral actualizado por última vez
|
labor_cost_last_updated | string |
Fecha de la última actualización del costo laboral. |
|
Administrador
|
manager | boolean |
Si el usuario es el administrador del proyecto. |
|
Id. de proyecto
|
project_id | integer |
Id. de proyecto. |
|
Tasa
|
rate | double |
Tasa para este usuario del proyecto. |
|
Tasa actualizada por última vez
|
rate_last_updated | string |
Fecha de la tasa actualizada por última vez. |
|
Id. de usuario
|
user_id | integer |
Id. de usuario |
|
ID del espacio de trabajo
|
workspace_id | integer |
Id. del área de trabajo. |
TimeEntryWebhookEvent
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. del evento
|
event_id | integer |
Identificador único del evento de webhook. |
|
Id. de suscripción
|
subscription_id | integer |
Identificador de la suscripción de webhook que desencadenó este evento. |
|
Evento creado en
|
created_at | string |
Cuando se creó el evento. |
|
Marca de tiempo del evento
|
timestamp | string |
Cuando se envió el evento. |
|
Id. de creador
|
creator_id | integer |
Identificador del usuario que desencadenó el evento. |
|
Dirección URL de devolución de llamadas
|
url_callback | string |
Dirección URL de devolución de llamada para este evento. |
|
Tipo de solicitud
|
metadata.request_type | string |
Tipo de solicitud que desencadenó el evento. |
|
Id. de usuario del evento
|
metadata.event_user_id | integer |
Identificador del usuario asociado al evento. |
|
Acción
|
metadata.action | string |
Acción que se realizó (creada, actualizada, eliminada, iniciada, detenida). |
|
payload
|
payload | TimeEntry |