Skip to main content

​
Conceptos Básicos

Esta sección explica la terminología y conceptos fundamentales que necesitas conocer para operar eficientemente el sistema Paso Rápido.

​
Terminología Principal

​
Entidades del Sistema

Definición: Entidad principal que representa a una empresa o grupo empresarial que utiliza el sistema.Características:
  • Cada organización tiene sus propios datos aislados (multi-tenencia)
  • Puede tener múltiples usuarios con diferentes roles
  • Administra su propia flota de vehículos y tags
  • Tiene configuración independiente de APIs y credenciales
Ejemplo: “Transportes ABC S.A.” sería una organización que gestiona 50 vehículos.
Definición: Unidad de transporte equipada con dispositivo GPS que genera datos de telemetría.Lista de vehículos en el sistemaInformación incluye:
  • Número de vehículo: Identificador interno de la flota
  • Placa: Matrícula oficial del vehículo
  • Categoría: Tipo de vehículo (Auto, Camioneta, Bus, Camión, etc.)
  • Device ID: Identificador del dispositivo GPS instalado
  • Proyecto: Agrupación lógica dentro de la organización
Ejemplo: Vehículo #1001, placa “ABC123”, categoría 2 (Camioneta), con GPS device ID 789456.
Definición: Dispositivo electrónico que permite el paso automático por estaciones de peaje.Gestión de tags en el sistemaPropiedades:
  • Número de Tag: Identificador único de 6 dígitos
  • Estado: Válido o Inhabilitado
  • Categoría: Nivel tarifario asignado (1-5)
  • Tipo: Corporativo o Prepago
  • Fechas: Emisión y expiración
Ejemplo: Tag #123456, categoría 2, estado “Válido”, tipo “Corporativo”.
Definición: Relación temporal entre un tag y un vehículo específico.Detalle de asignación de tag con información completaImportancia:
  • Un vehículo puede tener diferentes tags en diferentes períodos
  • Un tag solo puede estar asignado a un vehículo a la vez
  • Las validaciones dependen de estas asignaciones históricas
Ejemplo: Tag #123456 asignado al vehículo #1001 desde el 01/01/2024 hasta el 31/12/2024.
Definición: Punto físico donde se cobran las tarifas de tránsito.Datos incluidos:
  • Nombre: Identificación de la estación
  • Ubicación GPS: Coordenadas exactas (latitud, longitud)
  • Tarifas por Categoría: Montos oficiales para cada tipo de vehículo
Ejemplo: “Peaje Autopista Norte Km 45”, coordenadas (4.7110, -74.0721), tarifa categoría 1: $5,000.
Definición: Registro de un cobro realizado cuando un vehículo pasa por una estación.Información incluye:
  • Fecha y Hora: Momento exacto del cargo
  • Tag: Número del tag usado
  • Estación: Donde ocurrió el cobro
  • Monto: Cantidad cobrada
  • Estado de Validación: Resultado de las verificaciones
Ejemplo: Cargo del 15/01/2024 14:30, tag #123456, Peaje Norte Km 45, $5,000.

​
Estados de Validación

​
Estados GPS

  • VALIDO
  • UBICACION_INVALIDA
  • SIN_TELEMETRIA
  • Sin Validar
Descripción: El vehículo estaba presente en la ubicación y momento del cargo.Criterios:
  • Datos GPS disponibles dentro del rango de tiempo (±1 minuto)
  • Distancia a la estación menor a 500 metros
  • Velocidad y dirección coherentes
Indicador: ✅ Verde - Cargo aprobado automáticamente

​
Estados de Duplicados

Único

Descripción: Cargo sin duplicados detectados.Criterio: No existe otro cargo con mismo tag, estación y fecha similar.Acción: Ninguna - Cargo válido.

Duplicado

Descripción: Se detectó otro cargo idéntico o muy similar.Criterios de detección:
  • Mismo tag y estación
  • Diferencia de tiempo menor a 10 minutos
  • Monto igual o similar
Acción: Revisar manualmente para determinar cuál mantener.

​
Estados de Categoría

  • Correcto
  • Cobro Mayor
  • Cobro Menor
Descripción: El monto cobrado coincide exactamente con la tarifa oficial.Validación: Monto del cargo = Tarifa de la categoría del vehículo.Resultado: ✅ Sin problemas detectados.

​
Proceso de Validación

​
Flujo Automático

1

Importación de Cargos

Los cargos se importan desde archivos CSV proporcionados por las concesionarias de peajes.Formato típico: Fecha, Tag, Estación, Monto, TipoFrecuencia: Diaria o semanal según la concesionaria.
2

Sincronización GPS

El sistema obtiene datos de telemetría desde la API de ERM Karma.Datos obtenidos: Posición, velocidad, timestamp, odómetroVentana de tiempo: ±2 horas alrededor de cada cargo para asegurar cobertura.
3

Ejecución de Validaciones

Se ejecutan automáticamente las 4 validaciones principales:
  1. Validación GPS: Confirma presencia del vehículo
  2. Detección de Duplicados: Identifica cargos repetidos
  3. Validación de Categoría: Verifica montos correctos
  4. Verificación de Tags: Confirma estado activo
Este proceso puede tomar varios minutos dependiendo del volumen de datos.
4

Generación de Resultados

Cada cargo recibe:
  • Estado de validación para cada tipo
  • Detalles explicativos
  • Recomendaciones de acción
  • Evidencia GPS cuando está disponible
Los resultados se almacenan permanentemente para auditoría.

​
Revisión Manual

Después de la validación automática, los operadores pueden:
Criterios de prioridad:
  • Cargos con validación GPS fallida
  • Duplicados detectados
  • Cobros excesivos (categoría incorrecta)
  • Tags inhabilitados
Herramientas disponibles:
  • Mapa GPS con ruta del vehículo
  • Historial de cargos del tag
  • Comparación con cargos similares
Opciones de decisión:
  • Válido: Confirmar que el cargo es legítimo
  • Ubicación Inválida: Rechazar por evidencia GPS
  • Sin Telemetría: Aceptar por falta de datos
Documentación: Cada decisión debe incluir comentarios explicativos.
Tipos de reportes:
  • Resumen ejecutivo de validaciones
  • Detalle de fraudes detectados
  • Análisis de ahorros generados
  • Exportación a Excel con todos los datos
Periodicidad: Diario, semanal, mensual según necesidades.

​
Roles y Permisos

​
Tipos de Usuario

  • OrgAdmin
  • Analyst
  • Dispatcher
  • ReadOnly
Administrador de OrganizaciónPermisos completos:
  • Gestionar usuarios y roles
  • Configurar integraciones API
  • Acceso a todos los módulos
  • Generar cualquier reporte
  • Modificar configuraciones del sistema
Responsabilidades: Configuración inicial, gestión de equipo, supervisión general.

​
Configuraciones Importantes

​
Parámetros de Validación

​
time_window_minutes
integer
default:"1"
Ventana de tiempo para validación GPS. Rango recomendado: 1-5 minutos.
​
distance_meters
integer
default:"500"
Radio máximo de distancia para considerar válida la ubicación. Rango: 100-1000 metros.
​
duplicate_time_threshold
integer
default:"10"
Tiempo máximo entre cargos para considerar duplicado. Rango: 5-30 minutos.

​
Integración con ERM Karma

La integración con ERM Karma API es fundamental para obtener datos GPS. Requiere credenciales válidas y configuración correcta de la URL del servidor.
Configuración requerida:
  • URL del servidor Karma
  • Usuario y contraseña
  • Sincronización automática habilitada
  • Respaldo de datos GPS local

​
Próximos Pasos

Una vez que comprendas estos conceptos básicos, puedes continuar con:

Modelos de Datos

Estructura detallada de cada entidad del sistema

Sistema de Validación

Funcionamiento interno de cada tipo de validación