Saltar al contenido principal

Reporte de Revisitas

Detecta visitas repetidas a la misma cuenta dentro de una ventana configurable — tasa de revisitas y tasa de resolución en la primera visita por grupo.

GET/apidev/v1/reports/gt/revisits
PermisoAPICLI_RPTGT_REVISITAS
Límite de tasa10 req/min
Caché300s
Rango máximo92 días

Resumen​

Identifica cuándo se visitó la misma cuenta más de una vez dentro de un período corto — una señal de que la primera visita no resolvió el problema. Para cada tarea finalizada, el reporte mira la tarea finalizada anterior en la misma cuenta; si la diferencia está dentro de la ventana de revisita, la tarea se cuenta como revisita, de lo contrario como primera visita. Los resultados se agrupan por grupo con la tasa de revisitas, la tasa de resolución en la primera visita y el promedio de días entre visitas consecutivas.

Ajustá la ventana con revisit_window_days (valor por defecto 30, rango 1–365): dos visitas a la misma cuenta dentro de esa cantidad de días cuentan como una revisita. Elegí cómo se agrupan las filas con group_by (por defecto es prestador).

Solicitud​

Encabezados de la solicitud​

Every request to a protected endpoint requires these headers:

HeaderRequiredDescription
AuthorizationYesBearer token obtained from the Login endpoint. Format: Bearer <token>
X-API-KeyYesCompany integration key provided during onboarding. Format: gtk_xxx...
tenantYesYour assigned tenant domain (default: geotareas.com) — always send your assigned tenant
Content-TypeConditionalapplication/json — required for POST and PUT requests

Parámetros de consulta​

ParámetroTipoRequeridoPor defectoDescripción
startdatestringSí—Fecha-hora de inicio en ISO 8601 (ej. 2026-03-01T00:00:00).
enddatestringSí—Fecha-hora de fin en ISO 8601. Rango máximo de 92 días desde startdate.
revisit_window_daysintegerNo30Días dentro de los cuales una segunda visita a la misma cuenta cuenta como una revisita (1–365).
group_bystringNoproviderCómo se agrupan las filas. Uno de: provider, device, driver, cause, subcause, service_type, product, origin, shift, end_code, comm_media, route, country, department, city, zone, client, telephonist, operator, resource_type, date, month, weekday, hour.
devicesstringNo—IDs de dispositivos separados por coma. Máx 500.
driversstringNo—IDs de conductores separados por coma. Máx 500.
providersstringNo—IDs de prestadores separados por coma. Máx 100.
service_typesstringNo—IDs de tipos de servicio separados por coma. Máx 100.
causesstringNo—IDs de causas separados por coma. Máx 100.
subcausesstringNo—IDs de subcausas separados por coma. Máx 100.
statusesstringNo—Códigos de estado de tarea separados por coma. Máx 100.
device_groupsstringNoTodosIds 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
originsstringNo—IDs de orígenes separados por coma. Máx 100.
route_idsstringNo—IDs de rutas separados por coma. Máx 100.
operatorsstringNo—IDs de operadores separados por coma. Máx 100.
client_idstringNo—ID de un solo cliente.
account_idstringNo—ID de una sola cuenta.
shift_idstringNo—ID de un solo turno.
limitintegerNo25Cantidad de registros por página (1–100).
offsetintegerNo0Cantidad de registros a omitir para la paginación.
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.

Ejemplos de código​

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

Respuesta​

Campos de la respuesta​

CampoTipoDescripción
group_labelstringNombre visible del grupo (ej. conductor, dispositivo, prestador).
group_idstring | nullID interno del grupo, o null cuando no se puede resolver.
totalnumberTotal de tareas finalizadas en el grupo.
revisitasnumberTareas que revisitaron una cuenta dentro de la ventana.
primera_visitanumberTareas que fueron una primera visita (sin visita previa reciente).
dias_entre_visitas_avgnumberPromedio de días entre visitas consecutivas a la misma cuenta.
tasa_revisitas_pctnumberPorcentaje de tasa de revisitas (revisitas / total * 100).
first_time_fix_pctnumberPorcentaje de tasa de resolución en la primera visita ((total − revisitas) / total * 100).

Ejemplo de respuesta​

{
  "success": true,
  "data": [
    {
      "group_label": "Carlos Martinez",
      "group_id": "10293",
      "total": 120,
      "revisitas": 18,
      "primera_visita": 102,
      "dias_entre_visitas_avg": 6.41,
      "tasa_revisitas_pct": 15.0,
      "first_time_fix_pct": 85.0
    }
  ],
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0
  }
}

Errores​

CódigoHTTPDescripción
VALIDATION_ERROR400Parámetros inválidos: fechas faltantes, rango > 92 días, revisit_window_days fuera de 1–365, valores de enum inválidos.
UNAUTHORIZED401tenant / Authorization / X-API-Key faltante, inválido o expirado
FORBIDDEN403El usuario no tiene el permiso requerido.
RATE_LIMITED429Se superó el límite de 10 req/min.
INTERNAL_ERROR500Error inesperado del servidor.