Reporte de Cantidad de Servicios

Conteo de tareas agregado por dimensiones de agrupación configurables.

GET/apidev/v1/reports/gt/quantity-service

PermisoAPICLI_RPTGT_QS

Límite de solicitudes10 req/min (ventana deslizante)

Caché300s (5 min)

Rango máximo31 días

Resumen

Devuelve conteos de tareas agregados por una única dimensión de agrupación: por dispositivo, conductor, día, ciudad, causa y más. Úsalo para medir la distribución de la carga de trabajo y detectar dónde se concentra el volumen de servicio.

Agrupación — group_by elige la dimensión que representa cada fila (ver los valores más abajo)
Base de fecha — date_field controla si el rango filtra por fecha de creación, programada o de finalización
Filtrado — acota los resultados por dispositivos, conductores, tipos de servicio, proveedores y otros filtros de catálogo

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	Predeterminado	Descripción
`startdate`	string	Sí	—	Fecha-hora de inicio en ISO 8601
`enddate`	string	Sí	—	Fecha-hora de fin en ISO 8601. Rango máximo 31 días
`devices`	string	No	Todos los visibles	IDs de dispositivos separados por coma. Máximo 500
`drivers`	string	No	Todos	IDs de conductores separados por coma. Máximo 500
`service_types`	string	No	Todos	IDs de tipos de servicio separados por coma. Máximo 100
`causes`	string	No	Todas	IDs de causas separados por coma. Máximo 100
`subcauses`	string	No	Todas	IDs de subcausas separados por coma. Máximo 100
`statuses`	string	No	Todos	Códigos de estado separados por coma. Máximo 100
`device_groups`	string	No	Todos	Ids de tipo de dispositivo separados por comas (el catálogo `device_group` que expone Flota / Dispositivos). Acota las tareas a los dispositivos de esos tipos; se combina con `devices` como intersección. Máximo 100
`origins`	string	No	Todos	IDs de orígenes separados por coma. Máximo 100
`providers`	string	No	Todos	IDs de proveedores separados por coma. Máximo 100
`route_ids`	string	No	Todas	IDs de rutas separados por coma. Máximo 100
`operators`	string	No	Todos	IDs de operadores separados por coma. Máximo 100
`client_id`	string	No	—	Filtrar por un cliente específico
`account_id`	string	No	—	Filtrar por una cuenta específica
`shift_id`	string	No	—	Filtrar por un turno específico
`date_field`	enum	No	—	Campo de fecha sobre el cual filtrar: `created`, `scheduled`, `finished`
`group_by`	enum	No	—	Dimensión de agrupación (ver abajo)
`limit`	integer	No	`25`	Registros por página (`1`–`100`)
`offset`	integer	No	`0`	Registros a omitir

Cómo se combina device_groups con devices

device_groups se expande a todos los dispositivos de esos tipos, y si además mandás devices, se quedan solo los dispositivos que están en las dos listas. Si esa intersección queda vacía, el reporte no devuelve filas.

Valores de group_by

date · month · hour · weekday · department · city · zone · provider · device · device_group · driver · shift · cause · subcause · end_code · origin · telephonist · operator

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/gt/quantity-service?startdate=2026-03-01T00:00:00&enddate=2026-03-31T23:59:59&group_by=device&limit=25"

const headers = {
  'Authorization': `Bearer ${TOKEN}`,
  'X-API-Key': APIKEY,
  'tenant': TENANT,
};

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/quantity-service?startdate=2026-03-01T00:00:00&enddate=2026-03-31T23:59:59&group_by=device&limit=25`,
  { headers }
);
const data = await res.json();

import requests

headers = {
    "Authorization": f"Bearer {TOKEN}",
    "X-API-Key": APIKEY,
    "tenant": TENANT,
}

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/gt/quantity-service",
    headers=headers,
    params={
        "startdate": "2026-03-01T00:00:00",
        "enddate": "2026-03-31T23:59:59",
        "group_by": "device",
        "limit": 25,
    },
)
data = response.json()

Campos de la respuesta

Campo	Tipo	Descripción
`group_label`	string	Nombre visible del grupo
`group_id`	string \| null	Identificador del elemento del grupo
`total_tasks`	number	Cantidad total de tareas
`dist_total`	number	Distancia total de todas las tareas (km)
`dist_avg`	number	Distancia promedio por tarea (km)

Respuesta de ejemplo

{
  "success": true,
  "data": [
    {
      "group_label": "Truck A-101",
      "group_id": "104820579301",
      "total_tasks": 47,
      "dist_total": 892.3,
      "dist_avg": 18.98
    },
    {
      "group_label": "Truck B-205",
      "group_id": "104820579402",
      "total_tasks": 32,
      "dist_total": 614.7,
      "dist_avg": 19.21
    }
  ],
  "meta": {
    "total": 2,
    "limit": 25,
    "offset": 0
  }
}

Errores

Código	HTTP	Descripción
`VALIDATION_ERROR`	400	Parámetros inválidos: fechas faltantes, rango > 31 días, group_by inválido
`UNAUTHORIZED`	401	tenant / Authorization / X-API-Key faltante, inválido o expirado
`FORBIDDEN`	403	El usuario carece del permiso requerido
`RATE_LIMITED`	429	Se superaron 10 req/min
`INTERNAL_ERROR`	500	Error inesperado del servidor

Resumen​

Solicitud​

Encabezados de la solicitud​

Parámetros de consulta​

Valores de group_by​

Ejemplos de código​

Campos de la respuesta​

Respuesta de ejemplo​

Errores​

Relacionado​