Reporte de Tareas Rechazadas

Registros de rechazo de tareas con motivo, momento y detalles del conductor.

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

PermisoAPICLI_RPTGT_RECHAZOTAREA

Límite de solicitudes10 req/min

Caché300s

Rango máximo31 días

---

Resumen

Devuelve los registros de rechazo de tareas dentro de un rango de fechas, cada uno con el motivo del rechazo, el mensaje del conductor, el dispositivo y el conductor involucrados, y el momento del rechazo (antes de la aceptación, después de la aceptación, por tiempo agotado o por falta de confirmación). Filtrá por dispositivos, conductores, momentos de rechazo o IDs de motivo de rechazo específicos.

---

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.
rejection_moments	string	No	—	Códigos de momento separados por comas. Máximo 10. Valores: not_accepted, accepted, timeout, nack.
rejection_reason_ids	string	No	—	IDs de motivos de rechazo separados por comas. Máximo 100.
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/rejected-tasks?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&limit=25"

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/rejected-tasks?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&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/rejected-tasks",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"startdate": "2026-03-01T00:00:00", "enddate": "2026-03-15T23:59:59", "limit": 25},
)
data = response.json()

---

Respuesta

Campos de la respuesta

Campo	Tipo	Descripción
rejection_date	string | null	Marca de tiempo del rechazo.
task_number	string | null	Número de tarea.
device_name	string	Nombre del vehículo.
driver_name	string	Nombre del conductor.
rejection_reason	string	Texto del motivo de rechazo.
not_accepted_message	string	Mensaje de rechazo del conductor.
rejection_moment	string	Código del momento.
rejection_moment_text	string	Descripción del momento.

Ejemplo de respuesta

{
  "success": true,
  "data": [
    {
      "rejection_date": "2026-03-05T08:22:00",
      "task_number": "104820580001",
      "device_name": "Truck A-101",
      "driver_name": "Carlos Martinez",
      "rejection_reason": "Route too far",
      "not_accepted_message": "Cannot reach in time",
      "rejection_moment": "not_accepted",
      "rejection_moment_text": "Not accepted by driver"
    }
  ],
  "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 General
• Paginación