Reporte de Actividad por Grupo

Carga de trabajo y rendimiento por grupo de asignación — cantidad de miembros, tareas asignadas vs completadas, tiempo promedio de finalización y cumplimiento de SLA.

GET/apidev/v1/reports/workflow/group-activity

PermisoAPICLI_RPTWF_GRUPOS

Límite de solicitudes10 req/min

Caché300s

Rango máximo92 días

Resumen

Agrega la actividad de tareas de cada grupo de asignación de workflow durante un rango de fechas — cantidad de miembros, tareas asignadas al grupo, tareas que el grupo completó, tiempo promedio de finalización y cumplimiento de SLA. Usalo para balancear la carga de trabajo entre equipos e identificar grupos sobrecargados o subutilizados. Solo se cuentan las tareas asignadas a un grupo; las tareas asignadas directamente a una persona sin grupo quedan excluidas. Se incluyen tanto las tareas activas como las archivadas.

Los resultados se paginan y pueden ordenarse por cualquiera de las columnas de actividad. Filtrá por una o más definiciones de workflow para acotar el reporte a procesos específicos.

El cumplimiento de SLA requiere configuración de SLA

El campo sla_compliance_percent refleja valores reales solo cuando el seguimiento de SLA está habilitado para tu compañía. Cuando el SLA no está configurado, este campo toma 100 por defecto para cada grupo. Contactá a tu equipo de cuenta para habilitar el seguimiento de SLA por paso.

Solicitud

Encabezados de la solicitud

Every request to a protected endpoint requires these headers:

Header	Required	Description
`Authorization`	Yes	Bearer token obtained from the Login endpoint. Format: `Bearer <token>`
`X-API-Key`	Yes	Company integration key provided during onboarding. Format: `gtk_xxx...`
`tenant`	Yes	Your assigned tenant domain (default: `geotareas.com`) — always send your assigned tenant
`Content-Type`	Conditional	`application/json` — required for `POST` and `PUT` requests

Parámetros de consulta

Parámetro	Tipo	Requerido	Por defecto	Descripción
`startdate`	string	Sí	—	Fecha-hora de inicio en ISO 8601 (ej. `2026-03-01T00:00:00`).
`enddate`	string	Sí	—	Fecha-hora de fin en ISO 8601. Rango máximo de 92 días desde `startdate`.
`definition_ids`	string	No	—	IDs de definición de workflow para filtrar, separados por comas. Máximo 100.
`sort_by`	string	No	`assignedTasks`	Columna por la cual ordenar. Una de: `assignedTasks`, `completedTasks`, `avgCompletionSeconds`, `memberCount`, `groupName`, `slaMet`, `slaTotal`.
`sort_dir`	string	No	`desc`	Dirección de ordenamiento: `asc` o `desc`.
`limit`	integer	No	`25`	Cantidad de registros por página (`1`–`100`).
`offset`	integer	No	`0`	Cantidad de registros a omitir para la paginación.

sort_by se valida por reporte

Este reporte acepta exactamente estos valores:

assignedTasks · completedTasks · avgCompletionSeconds · memberCount · groupName · slaMet · slaTotal

Cualquier otro valor devuelve 400 VALIDATION_ERROR, y el mensaje enumera los valores aceptados. Hasta el 2026-08-16 un sort_by no reconocido se ignoraba en silencio y el reporte volvía en su orden por defecto, así que una columna mal escrita parecía haber funcionado.

Ejemplos de código

cURL
JavaScript
Python

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/workflow/group-activity?startdate=2026-03-01T00:00:00&enddate=2026-03-31T23:59:59&limit=25"

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/workflow/group-activity?startdate=2026-03-01T00:00:00&enddate=2026-03-31T23:59:59&limit=25`,
  {
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'X-API-Key': APIKEY,
      'tenant': TENANT,
    },
  }
);
const data = await res.json();

import requests

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/workflow/group-activity",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"startdate": "2026-03-01T00:00:00", "enddate": "2026-03-31T23:59:59", "limit": 25},
)
data = response.json()

Respuesta

Campos de la respuesta

Cada elemento en data representa un grupo de asignación.

Campo	Tipo	Descripción
`groupId`	string	ID del grupo de asignación.
`groupName`	string	Nombre del grupo de asignación.
`memberCount`	number	Cantidad de miembros del grupo.
`assignedTasks`	number	Tareas asignadas al grupo en el período.
`completedTasks`	number	Tareas que el grupo completó.
`slaCompliancePercent`	number	Porcentaje de cumplimiento de SLA (toma `100` por defecto cuando el SLA no está configurado).
`avgCompletionSeconds`	number	Tiempo promedio de finalización (segundos) de las tareas completadas.

Respuesta de ejemplo

{
  "success": true,
  "data": [
    {
      "groupId": "7710045566778899",
      "groupName": "Field Operations",
      "memberCount": 8,
      "assignedTasks": 312,
      "completedTasks": 287,
      "slaCompliancePercent": 88.5,
      "avgCompletionSeconds": 3640.0
    }
  ],
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0
  }
}

Errores

Código	HTTP	Descripción
`VALIDATION_ERROR`	400	Parámetros inválidos: fechas faltantes, valores de enum inválidos, paginación fuera de rango.
`INVALID_DATE_RANGE`	400	Rango de fechas inválido o mayor a 92 días.
`UNAUTHORIZED`	401	tenant / Authorization / X-API-Key faltante, inválido o expirado
`FORBIDDEN`	403	El usuario no tiene el permiso requerido.
`RATE_LIMITED`	429	Se superaron las 10 req/min.
`INTERNAL_ERROR`	500	Error inesperado del servidor.

Resumen​

Solicitud​

Encabezados de la solicitud​

Parámetros de consulta​

Ejemplos de código​

Respuesta​

Campos de la respuesta​

Respuesta de ejemplo​

Errores​

Relacionados​