Iniciar ruta
Acción manual. La API crea la sesión y devuelve tracking_session_id.
El ID correlaciona; no autoriza.
Propuesta documental de captura GPS, ingestión y composición del mapa. Las zonas distinguen los datos de tracking de los datos comerciales que siguen bajo propiedad de sus servicios CRM.
Check-in/check-out viaja aparte del lote GPS.
Acción manual. La API crea la sesión y devuelve tracking_session_id.
El ID correlaciona; no autoriza.
~10 s en movimiento; 30–60 s en reposo, sólo con ruta activa y horario autorizado.
La app mantiene la cola local; no toma muestras nuevas fuera de ventana.
Aproximadamente cuatro muestras cada 2 min; a 10 s de cadencia son 12.
Una muestra válida en cola puede cargarse más tarde.
Check-in/check-out se envía de inmediato a la API de visitas de svc-fuerza-ventas.
Incluye referencia de sesión; no espera ni entra al lote GPS. La ruta HTTP no está documentada.
Primero se vacían los puntos GPS pendientes; luego se solicita el cierre de sesión.
Acción manual; la captura ya cesa al salir de la ventana autorizada.
Composición mediante APIs propietarias; sin joins entre bases.
Inicio/cierre manualCola localGPS adaptativo
La app envía unos cuatro puntos por lote cada dos minutos, vacía los pendientes antes del cierre y permite la carga tardía de puntos tomados dentro del horario.
La cadencia, permisos y ejecución en segundo plano deben validarse en dispositivos reales. El lote reduce solicitudes, no el muestreo ni la energía que consume el GPS.
La API crea/cierra sesiones, recibe lotes y consulta puntos. empresa_id es obligatorio en cada sesión y punto lógico; se deriva y autoriza desde el contexto de autenticación confiable, nunca desde un valor libre del cliente.
tracking_session_id identifica la sesión pero no concede autorización. Todas las operaciones aplican el tenant confiable.
Sesiones y puntos guardan empresa_id. El consumidor interno autorizado lo suministra; la API autentica y autoriza al caller y aplica el tenant como predicado obligatorio en cada operación. La app móvil deriva su ámbito del contexto autenticado, no de un campo libre. Las respuestas incluyen empresa_id. MongoDB no aplica PostgreSQL RLS: es una excepción de tracking a la política transversal CRM, pendiente de reconciliación y aprobación. Si RLS de base es obligatorio, PostgreSQL particionado con RLS sigue siendo la alternativa.
No almacenar aquí: cliente_id, prospecto_id, nombres o identificación de clientes, visitas, pedidos ni actividades.
Es propietario de visitas/check-in/check-out, pedidos y actividades. Recibe la referencia tracking_session_id y persiste su empresa_id en su almacenamiento CRM protegido por RLS.
Una sesión puede relacionarse con varias visitas. La validación servicio-a-servicio de sesión es opcional, pendiente y sólo de lectura si se adopta.
Conserva la propiedad de clientes y locales; el mapa los obtiene mediante su API.
Consulta puntos de ruta en la API de tracking, visitas/pedidos/actividades en svc-fuerza-ventas y clientes/locales en svc-clientes.
Una ruta puede relacionarse con muchas visitas por tracking_session_id. Cada API autoriza bajo el contexto de empresa correspondiente.
Sin acceso directo a bases de datos y sin copias de datos comerciales a tracking.
Propuestos para discusión; no son endpoints aprobados.
/api/v1/rutas/sesionesIniciar ruta; respuesta con tracking_session_id.
/api/v1/rutas/sesiones/{tracking_session_id}/puntosEnviar un lote de puntos GPS.
/api/v1/rutas/sesiones/{tracking_session_id}/finalizacionFinalizar la sesión tras vaciar la cola GPS.
/api/v1/rutas/sesiones/{tracking_session_id}/puntos?desde=…&hasta=…&limite=…&cursor=…Consultar puntos por sesión e intervalo, con tenant autorizado.
/api/v1/rutas?promotor_id=…&desde=…&hasta=…Listar rutas de un promotor y período, bajo el tenant autorizado.
Visitas: el check-in/check-out se envía de inmediato a la API propietaria de svc-fuerza-ventas. No se documentó una ruta HTTP para esa operación, por lo que no se inventa una URL.
Estimación para un turno activo de 8 horas por dispositivo.
En reposo, 30–60 s produce aproximadamente 2–4 puntos por lote de 2 min y reduce las muestras. Los lotes reducen solicitudes, no el almacenamiento de puntos ni la energía del muestreo GPS. El retraso de hasta 2 min en la frescura del mapa es un intercambio propuesto para historial, no un SLA de tiempo real aprobado.