Reporte de Tareas General

Registros individuales de tareas con línea de tiempo de estados y detalles de asignación.

GET/apidev/v1/reports/gt/tasks-general

PermisoAPICLI_RPTGT_TAREAS

Límite de solicitudes10 req/min

Caché300s

Rango máximo31 días

---

Resumen

Devuelve registros individuales de tareas dentro de un rango de fechas, cada uno con su línea de tiempo de estados completa (asignada, aceptada, iniciada, finalizada) más el vehículo y el conductor asignados. Filtrá por dispositivos, conductores, códigos de estado, tipo de servicio o causa, y elegí a qué campo de fecha (created, scheduled o finished) se aplica el rango.

---

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 31 días desde startdate.
devices	string	No	—	IDs de dispositivos separados por comas. Máximo 500.
drivers	string	No	—	IDs de conductores separados por comas. Máximo 500.
statuses	string	No	—	Códigos de estado separados por comas. Máximo 50.
service_type_id	string	No	—	Un solo ID de tipo de servicio.
cause_id	string	No	—	Un solo ID de causa.
date_type	enum	No	created	Campo de fecha por el cual filtrar: created, scheduled, finished.
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.

---

Ejemplos de código

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/gt/tasks-general?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&date_type=created&limit=25"

JavaScript

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

Python

import requests

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

---

Respuesta

Campos de la respuesta

Campo	Tipo	Descripción
task_id	string | null	Identificador de la tarea.
created_at	string | null	Marca de tiempo de creación de la tarea.
scheduled_at	string | null	Marca de tiempo programada.
accepted_at	string | null	Marca de tiempo de aceptación.
started_at	string | null	Marca de tiempo de inicio.
finished_at	string | null	Marca de tiempo de finalización.
device_name	string	Vehículo asignado.
driver_name	string	Conductor asignado.
statuses	array	Entradas del historial de estados.

Ejemplo de respuesta

{
  "success": true,
  "data": [
    {
      "task_id": "104820580001",
      "created_at": "2026-03-05T08:15:00",
      "scheduled_at": "2026-03-05T09:00:00",
      "accepted_at": "2026-03-05T08:22:00",
      "started_at": "2026-03-05T09:05:00",
      "finished_at": "2026-03-05T10:30:00",
      "device_name": "Truck A-101",
      "driver_name": "Carlos Martinez",
      "statuses": [
        {"status": "ASI", "datetime": "2026-03-05T08:15:00"},
        {"status": "ACE", "datetime": "2026-03-05T08:22:00"},
        {"status": "FIN", "datetime": "2026-03-05T10:30:00"}
      ]
    }
  ],
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0
  }
}

---

Errores

Código	HTTP	Descripción
VALIDATION_ERROR	400	Parámetros inválidos: faltan fechas, rango > 31 días, valores de enum inválidos.
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.

---

Relacionados

• Reporte de Tareas Rechazadas
• Paginación