14  Anexos

Este capítulo reúne material de referencia y consulta rápida que complementa al manual: guías operativas detalladas paso a paso, información de contacto para soporte técnico, respuestas a las dudas más frecuentes, un glosario de términos del sistema y los requisitos técnicos para usar la plataforma correctamente.

14.1 Semaforización en la plataforma BOL

Guía de referencia · Monitoreo operativo

La plataforma usa un semáforo de colores para que el equipo detecte de un vistazo qué necesita atención. Esta guía explica qué significa cada color, con qué reglas se calcula y dónde se decide — en el servidor (back) o en la pantalla (front) — en las tres vistas donde vive: Viajes, Previajes y GPS.

Verde En orden, sin acción · Amarillo Alerta, se acerca un riesgo · Rojo Crítico, requiere acción ahora · Gris Sin señal relevante

Cómo leer el semáforo

Todas las vistas comparten el mismo lenguaje de cuatro niveles. Cada nivel tiene color, ícono y texto a la vez, para que el significado no dependa solo del color (accesible para daltonismo).

Nivel Color claro Color oscuro Ícono Significado
Verde #C8E6C9 #1B5E20 check-circle En orden, sin acción requerida.
Amarillo #FFF9C4 #F57F17 alert Alerta: se aproxima un riesgo, conviene vigilar.
Rojo #FFCDD2 #C62828 alert-octagon Crítico: requiere acción ahora.
Gris #ebeff3 neutro Sin señal relevante; estado normal del ciclo.

A lo largo de la guía, cada señal lleva una etiqueta que indica dónde se decide su color: Back lo calcula el servidor y llega ya resuelto; Front lo calcula la pantalla con los datos del viaje.

Vista de Viajes

Es la vista más rica. Combina un semáforo principal por fase del viaje que calcula el servidor, con varias señales de apoyo en la pantalla (ETA, temperatura, datos faltantes) que además tiñen la fila.

Semáforo principal por fase Back · GET /api/v2/shipments

El servidor clasifica cada viaje según su etapa y aplica un umbral distinto en cada una.

Etapa del viaje Rojo Amarillo Verde
Calendarizado
por arribar / por descargar, sin carga programada ni tracto
Faltan ≤ 2 días para la fecha estimada de carga Faltan ≤ 5 días Faltan más de 5 días
Programado / Asignado
con carga programada
La carga es hoy o ya pasó (≤ 0 días) Faltan ≤ 2 días Faltan más de 2 días
En carga
tiempo dentro del CEDIS
Lleva más de las horas máximas de carga (por defecto 12 h) Supera el 50 % de ese tiempo Por debajo del 50 %
En tránsito
contra la ETA
Ya venció la ETA Faltan ≤ 2 horas para la ETA Más de 2 horas de margen

El «tiempo máximo de carga» sale de cada viaje (max_loading_hours); si no está definido, se asumen 12 horas.

Señales de apoyo en la pantalla

Además del semáforo principal, cada fila muestra indicadores calculados en el front:

Etiqueta de estatus Front — por diseño, nunca se pinta de rojo: la urgencia la comunican la ETA, la temperatura y el tinte de fila, no el nombre del estatus.

  • Verde — Entregado y Finalizado.
  • Amarillo — Conciliando.
  • Gris — todas las etapas en curso (Programado, En carga, En tránsito, En destino, En descarga, En retorno…).

Chip de ETA (entrega) Front

  • Rojo — la ETA ya venció («Vencido hace…»).
  • Amarillo — faltan menos de 3 horas para la ETA.
  • Verde — más de 3 horas de margen.

Chip de temperatura Front — solo aplica a viajes con temperatura requerida (caja refrigerada).

  • Rojo — no hay lectura de temperatura, o está fuera de la tolerancia de ±1 °C respecto a la requerida.
  • Verde — la lectura está dentro de tolerancia.

Datos incompletos Front — un ícono amarillo «incompletos (N)» avisa cuántos datos clave faltan. Se revisan cinco campos: proveedor de tracto, tracto, caja, fecha de carga, ruta.

NotaTinte de la fila completa

Para no saturar, la fila se tiñe una sola vez con la señal más grave (rojo gana sobre amarillo): rojo si la temperatura es crítica o la ETA venció; amarillo si la ETA se acerca o faltan datos. Las filas en verde o neutro no se tiñen.

Vista de Previajes

Los previajes provienen de una importación automática desde la fuente externa. Aquí el semáforo responde dos preguntas: ¿está fresca la sincronización? y ¿qué tan cerca está la fecha estimada?

Salud de la sincronización Back

Mide hace cuánto se importó por última vez desde la fuente externa (last_sync).

Indicador Condición Color
Desconectado Última sincronización hace más de 24 h #FF5252
Alerta Hace más de 2 h #FB8C00
En línea Dentro de las últimas 2 h #4CAF50

Cercanía de la ETA Front

A diferencia de Viajes, aquí la ETA se mide en días, no en horas.

  • Rojo — la fecha estimada ya pasó.
  • Amarillo — faltan 5 días o menos.
  • Verde — faltan más de 5 días.

La vista también reutiliza el ícono de datos incompletos Front, igual que en Viajes.

Vista GPS

El semáforo GPS mide la frescura de la última transmisión de cada equipo: qué tan reciente fue el último reporte de posición. Es la señal de «¿lo estamos viendo en el mapa?».

Semáforo por equipo Back · calculate_equipment_semaphore

Estado Condición
En línea Última transmisión hace menos de 1 h (si es refrigerada, además con temperatura reportada)
Alerta de señal Última transmisión entre 1 h y 3 h, o refrigerada sin temperatura
Desconectado Última transmisión hace más de 3 h, o sin datos de rastreo
TipColor del renglón y orden

El color del viaje en la lista GPS es el peor entre el tracto y todas sus cajas Front (rojo gana a amarillo, amarillo gana a verde). La lista se ordena por gravedad: primero los desconectados, luego los de alerta y al final los que están en línea — lo que necesita atención sube solo.

Umbrales de un vistazo

Resumen de las señales de tiempo más importantes de cada vista. Útil para notar que un mismo color puede significar plazos distintos según dónde estés.

Vista · Señal Capa Amarillo Rojo
Viajes · Calendarizado Back ≤ 5 días ≤ 2 días
Viajes · Programado / Asignado Back ≤ 2 días Hoy o vencido
Viajes · En carga Back > 50 % del máximo > Máximo (12 h por defecto)
Viajes · En tránsito / ETA (chip) Back Front ≤ 2 h (chip: 3 h) ETA vencida
Previajes · Sincronización Back > 2 h > 24 h
Previajes · ETA (por días) Front ≤ 5 días Vencida
GPS · Última transmisión Back 1 h – 3 h > 3 h / sin datos
AdvertenciaMismo color, distinto plazo

Un amarillo en GPS significa horas sin señal; en Previajes, hasta 5 días para la fecha estimada. El color indica «prioridad relativa dentro de esa vista», no un plazo absoluto igual en todas partes.


Guía de referencia de la semaforización de la plataforma BOL · Vistas de Viajes, Previajes y GPS · Señales de back (servidor) y front (pantalla). Los umbrales reflejan la configuración vigente y pueden ajustarse por producto.

14.2 Cómo se sincroniza la información entre BOL y Samsara

Guía operativa · Integración de flota

BOL es el sistema maestro. Cada vez que se da de alta o se edita un operador, un equipo, una dirección o una asignación, BOL envía esa información a Samsara de forma automática. Esta guía explica qué se sincroniza, bajo qué condiciones, y cómo interpretar el resultado, incluyendo la forma nueva de generar el usuario y la contraseña de los operadores.

BOL envía cambios Samsara

El principio básico

La regla que gobierna toda la integración es muy simple: la información se captura y se corrige en BOL. Samsara recibe una copia.

  • BOL manda. Los datos de negocio (nombre, placa, licencia, RFC, direcciones) se editan en BOL. Samsara nunca sobrescribe un dato de BOL.
  • La sincronización es automática. Al guardar un cambio en BOL, el envío a Samsara se dispara solo, en segundo plano.
  • Un envío fallido no bloquea tu trabajo. Si Samsara no responde o rechaza algo, el guardado en BOL igual se completa; el problema queda registrado en la bitácora.
  • Todo intento queda registrado. Cada envío, exitoso, omitido o con error, deja una fila en la bitácora (ver sección correspondiente).

Cuándo se sincroniza un registro

Para que un operador o un equipo viaje a Samsara deben cumplirse tres condiciones al mismo tiempo. Si falta cualquiera de ellas, el registro no se envía y queda marcado como Omitido.

Condición Qué significa Dónde se controla
Integración activa La conexión con Samsara está habilitada a nivel de plataforma. Configuración general
Marcado para sincronizar El registro tiene activada la opción Sincronizar con Samsara. Ficha del operador o equipo
Recurso propio Pertenece a un proveedor propio de la empresa, no a un tercero. Proveedor marcado como propio

Para los operadores existen además dos requisitos adicionales, explicados más adelante: el contacto debe estar marcado como operador y debe contar con un RFC válido.

Cómo se emparejan los registros

Cada registro de BOL y su equivalente en Samsara se relacionan mediante una etiqueta interna llamada bolId. Esta etiqueta no es visible para el usuario, pero permite identificar exactamente el mismo recurso en ambos sistemas y evita la creación de duplicados.

Cuando BOL crea un recurso en Samsara, automáticamente le asigna su bolId. A partir de ese momento, cualquier modificación posterior localizará ese mismo registro y lo actualizará en lugar de crear uno nuevo.

NotaAdopción de registros existentes

Es común que un tracto o una caja ya existan previamente en Samsara porque fueron registrados por el proveedor del GPS. En esos casos, BOL los identifica mediante la placa, les asigna el bolId y los adopta en lugar de duplicarlos.

Este resultado aparece en la bitácora con el estado Adoptado.

Operadores (conductores)

Un operador registrado en BOL se sincroniza como conductor dentro de Samsara. Si aún no existe, se crea automáticamente; si ya existe y está vinculado, únicamente se actualizan sus datos.

Dato en Samsara Origen en BOL
Nombre Nombre del operador
Teléfono Primer teléfono registrado
Licencia Número de licencia
Estatus (activo / inactivo) Estado del operador en BOL
Usuario del Driver App RFC (ver explicación siguiente)
Contraseña del Driver App RFC (ver explicación siguiente)

Novedad: usuario y contraseña generados desde el RFC

Samsara requiere un usuario y una contraseña para que el operador pueda iniciar sesión en la aplicación Samsara Driver App.

Actualmente ambos datos se generan automáticamente utilizando el RFC del operador, por lo que ya no es necesario capturarlos manualmente.

Ejemplo utilizando el RFC QUCH760104MB9:

QUCH Iniciales
760104 Fecha de nacimiento → Usuario
MB9 Homoclave
  • Usuario: los seis dígitos correspondientes a la fecha de nacimiento del RFC (760104).
  • Contraseña inicial: el RFC completo (QUCH760104MB9).

La contraseña únicamente se envía cuando el conductor se crea por primera vez. En sincronizaciones posteriores no vuelve a enviarse, para respetar cualquier cambio que el propio operador haya realizado desde la aplicación.

AdvertenciaContraseña inicial

El RFC es un dato relativamente fácil de conocer, por lo que únicamente se utiliza como contraseña temporal.

Se recomienda indicar al operador que cambie su contraseña durante el primer ingreso a la aplicación Samsara Driver App.

Por razones de seguridad, esta contraseña nunca queda almacenada en texto plano dentro de la bitácora.

Cuando dos operadores nacieron el mismo día, ambos tendrían inicialmente el mismo usuario.

Si el usuario ya existe en Samsara, BOL realiza automáticamente un segundo intento agregando la homoclave del RFC.

Ejemplo:

  • Primer intento: 760104
  • Segundo intento: 760104MB9

De esta manera se garantiza un usuario único sin necesidad de intervención manual.

Cuándo se omite un operador

Un operador no será enviado a Samsara cuando ocurra cualquiera de las siguientes situaciones:

  • El contacto no está marcado como operador.
  • No tiene RFC registrado.
  • El RFC no cumple con el formato correcto.

En cualquiera de estos casos, el registro aparecerá en la bitácora con el estado Omitido, indicando el motivo correspondiente.

BOL nunca genera usuarios utilizando un RFC incompleto o incorrecto, ya que eso provocaría la creación de un conductor con información inválida. ### Tractos y cajas

Los equipos también se sincronizan con Samsara, aunque el comportamiento depende del tipo de recurso.

ImportanteTracto (vehículo) — solo actualización

Samsara no permite crear vehículos desde BOL.

Un tracto debe existir previamente en Samsara, normalmente porque el proveedor del GPS lo dio de alta al instalar el dispositivo en la unidad.

Por ello, BOL únicamente puede:

  • Actualizar un tracto existente.
  • Adoptarlo mediante su placa si ya existe en Samsara.

Si el vehículo aún no existe en Samsara, el registro queda marcado como Omitido hasta que el proveedor lo registre.

Dato en Samsara Origen en BOL
Nombre Identificador del tracto
Placa Placa
VIN / Número de serie VIN
Marca y año Marca y año de fabricación

Caja (remolque)

Las cajas sí pueden crearse desde BOL.

Su funcionamiento es similar al de los operadores:

  • Si no existe en Samsara, se crea.
  • Si ya existe, se actualiza.
  • Si fue registrada previamente por el proveedor del GPS, BOL la adopta utilizando la placa y evita crear un duplicado.

Cuando esto ocurre, la bitácora muestra el estado Adoptado.

NotaAdopción mediante placa

Si Samsara contiene más de un equipo con la misma placa, BOL no selecciona uno automáticamente.

En ese caso el registro queda marcado como Omitido para que la vinculación se realice manualmente.

Si la caja no tiene placa registrada tampoco podrá ser adoptada.

Direcciones

Las direcciones registradas en BOL también pueden sincronizarse con Samsara para utilizarse como ubicaciones con geocerca.

Su funcionamiento es el siguiente:

  • Si la dirección no existe, se crea.
  • Si ya existe, se actualiza.

Además:

  • Si la dirección tiene un polígono definido, se envía como una geocerca poligonal.
  • Si no tiene polígono, se envía como un círculo utilizando su punto central y el radio configurado.
  • Si la dirección no ha cambiado desde la última sincronización exitosa, BOL omite el envío para evitar llamadas innecesarias a Samsara.

También existe una opción para forzar una resincronización, la cual envía nuevamente la dirección aunque no haya sufrido modificaciones.

14.3 Polígonos de entrada y salida en Direcciones

Permite configurar, para una misma dirección, dos polígonos de geocerca independientes: un polígono de entrada y un polígono de salida, con el fin de delimitar de forma más precisa las zonas de detección de llegada y salida de un viaje.

Polígonos disponibles

Polígono Color Capa (z-index)
Entrada (geofence_polygon) Azul 1
Salida (outer_geofence_polygon) Amarillo 2

El polígono de salida se muestra sobre el polígono de entrada, permitiendo distinguir ambas zonas dentro de una misma dirección.

Edición de los polígonos

  1. En la dirección deseada, seleccione la opción de edición de geocerca.
  2. Ajuste el polígono de entrada (azul) arrastrando sus puntos según la zona deseada.
  3. Ajuste el polígono de salida (amarillo) de la misma forma, arrastrando y modificando sus puntos.
Figura 14.1: Edición de polígonos de entrada y salida.
  1. Antes de guardar los cambios, el sistema validará que el polígono de salida contenga completamente al polígono de entrada. Si algún punto del polígono de entrada queda fuera del polígono de salida, el sistema no permitirá guardar la configuración y mostrará el mensaje correspondiente.
  2. Seleccione GUARDAR CAMBIOS para almacenar la configuración de ambos polígonos.

Nota: Si la dirección no cuenta con un polígono de salida previamente definido, el sistema permite crearlo a partir del polígono de entrada existente, ajustándolo posteriormente según sea necesario. Al eliminar el polígono de salida, la geocerca de la dirección conserva únicamente el polígono de entrada.

Visualización de los polígonos

Ambos polígonos (entrada y salida) se visualizan en el mapa en los siguientes puntos del sistema:

  • Módulo de Direcciones, al consultar la ubicación de una dirección.
  • Detalle del viaje, al consultar la ubicación del destino asociado.
Figura 14.2: Visualización de polígonos de entrada y salida en el mapa.

Nota: El autoajuste (auto-fit) del mapa considera ambos polígonos para centrar y encuadrar correctamente la vista de la geocerca completa.

Asignaciones

Una asignación relaciona un operador con su tracto y, cuando aplica, con una o varias cajas.

Al sincronizarla, BOL publica esta relación en Samsara.

Operador + Tracto + Caja(s) Asignación en Samsara

Salida (BOL → Samsara)

Cuando una asignación propia se crea o modifica, BOL la publica automáticamente.

Si Samsara responde que esa asignación ya existe, el resultado se considera correcto y no se genera un duplicado.

Entrada bajo demanda (Samsara → BOL)

Las asignaciones no generan avisos automáticos desde Samsara.

Por ello existe una opción de reconciliación manual que consulta el estado actual de Samsara y aplica en BOL las altas, bajas o modificaciones necesarias.

Siempre prevalece la información más reciente.

Lo que llega desde Samsara

Samsara puede enviar información relacionada con conductores y vehículos.

Sin embargo, esta comunicación tiene un alcance muy limitado para mantener el principio de que BOL es el sistema maestro.

ImportanteRegla de la sincronización de entrada

Los avisos provenientes de Samsara nunca modifican la información de negocio almacenada en BOL ni crean registros nuevos.

Su única finalidad es reconciliar la etiqueta bolId.

Situación Acción realizada por BOL
El registro ya contiene bolId Solo se registra como referencia (Drift).
No tiene bolId pero existe una coincidencia por licencia o placa. Se asigna el bolId al recurso en Samsara (Vinculado).
No existe una coincidencia o existen varias. El recurso queda pendiente para vinculación manual (Sin resolver).

Bitácora y estados

Cada sincronización genera un registro en la bitácora.

Los estados posibles son los siguientes:

Estado Descripción
Creado El recurso no existía y fue creado en Samsara.
Actualizado El recurso ya existía y únicamente se actualizaron sus datos.
Adoptado Se encontró un recurso existente y quedó vinculado mediante bolId.
Omitido No se cumplió alguna condición necesaria para sincronizar.
Error El envío fue realizado, pero Samsara devolvió un error o no respondió.
Tip¿Cuándo es necesario revisar la bitácora?

Un estado Omitido normalmente indica que el recurso no debía sincronizarse.

En cambio, un estado Error sí requiere revisión, ya que significa que el intento de sincronización falló. El motivo específico puede consultarse en la bitácora.

Casos frecuentes

Di de alta un operador y no aparece en Samsara

Verifique que:

  • La integración esté activa.
  • El operador tenga marcada la opción Sincronizar con Samsara.
  • Pertenezca a un proveedor propio.
  • El contacto esté identificado como operador.
  • Disponga de un RFC válido.

Si alguna condición no se cumple, la bitácora mostrará el estado Omitido indicando el motivo.

¿Con qué usuario y contraseña inicia sesión el operador?

  • Usuario: los seis dígitos correspondientes a la fecha de nacimiento contenida en el RFC.
  • Contraseña inicial: el RFC completo.

Después del primer acceso se recomienda cambiar la contraseña desde la aplicación Samsara Driver App.

Un equipo ya existía en Samsara

No se genera un duplicado.

BOL identifica el recurso mediante la placa y lo adopta automáticamente.

Solo cuando existen varias coincidencias o la placa no está registrada será necesaria una vinculación manual.

Edité un operador ya sincronizado

Modificar un operador no reinicia su contraseña.

La contraseña únicamente se envía durante la creación inicial del conductor.

Las sincronizaciones posteriores actualizan únicamente la información operativa.

Forcé una resincronización de una dirección

La resincronización manual vuelve a enviar la dirección aunque no haya cambios.

Esta opción resulta útil cuando una dirección quedó desincronizada por algún problema previo.


Guía operativa de la integración BOL ↔︎ Samsara · Incluye el cambio de credenciales de operador derivadas del RFC (tarea #1310). Documento de referencia para el equipo de operaciones.

14.4 ¿Cómo sabe el sistema que un camión llegó o salió de un lugar?

BOL · Operador Logístico — Guía para el Agente de Transporte

Esta guía explica, en términos operativos, cómo BOL detecta automáticamente cuándo un tracto o una caja llega a un origen o destino, y cómo ese evento provoca que el estatus del viaje cambie sin necesidad de intervención manual.

GPS manda posición toca la geocerca el estatus del viaje cambia solo
TipEn una frase

El GPS del equipo envía periódicamente su ubicación. Cuando esa posición entra o sale de la geocerca de un origen o destino, BOL actualiza automáticamente el estatus del viaje.

Por ejemplo, un viaje puede pasar de Programado a En carga sin que el usuario tenga que realizar ninguna acción.

¿Qué es una geocerca?

Una geocerca es un área virtual que rodea una dirección. Generalmente se representa como un círculo con un punto central y un radio definido en metros.

Su función consiste en indicar cuándo un equipo:

  • Se encuentra dentro del lugar.
  • Ya salió del lugar.

Cada dirección puede disponer de dos geocercas distintas:

Círculo interior Entrada

Detecta el momento en que el equipo llega al origen o al destino.

Círculo exterior Salida

Confirma que el vehículo abandonó el lugar y evita falsas salidas provocadas por pequeñas variaciones en la precisión del GPS.

AdvertenciaImportante para el agente

Si una dirección únicamente tiene configurado el círculo de entrada, el sistema podrá detectar automáticamente la llegada.

Sin embargo, nunca podrá detectar la salida hasta que también exista un círculo exterior.

¿Cómo sabe el sistema dónde está el camión?

El proveedor del servicio GPS instalado en el tracto o en la caja refrigerada envía continuamente la posición del equipo.

Cada vez que BOL recibe una nueva coordenada ejecuta automáticamente la siguiente pregunta:

¿La nueva posición cruza alguna geocerca perteneciente a un viaje activo?

Esta validación ocurre prácticamente en tiempo real y no depende de que un usuario tenga abierta la plataforma.

Durante esta revisión el sistema considera tanto:

  • El tracto.
  • Las cajas asignadas al viaje.

Si cualquiera de ellos entra o sale de una geocerca, el viaje es evaluado.

Además, únicamente se analizan viajes que realmente pueden cambiar de estado, por ejemplo:

  • Viajes programados próximos a iniciar carga.
  • Viajes actualmente en tránsito.
  • Viajes activos.

¿Qué cambia automáticamente cuando el camión llega o sale?

Cuando el sistema detecta un cruce de geocerca, modifica automáticamente el estatus del viaje de acuerdo con la siguiente lógica.

Situación detectada Estatus anterior Estatus nuevo
El equipo entra al círculo del origen. Programado En carga
El equipo entra al círculo del destino. En tránsito En destino
El equipo sale del círculo exterior del origen. En carga Puede iniciar el tránsito, dependiendo de la configuración del punto.
El equipo sale del círculo exterior del destino. En destino Por ejemplo, En retorno.
NotaLo que este proceso no hace

El cambio automático de estatus únicamente actualiza el estado del viaje.

No envía automáticamente:

  • Notificaciones push.
  • Mensajes por WhatsApp.
  • Correos electrónicos.
  • Avisos al cliente.

Si el cliente debe ser notificado, ese proceso depende de otras funciones del sistema o de la operación.

Requisito para que esto funcione: los checkpoints

Para que los cambios automáticos funcionen, el viaje debe tener configurados previamente sus checkpoints.

Normalmente un viaje cuenta con:

  • Punto de entrada en origen.
  • Punto de salida en origen (opcional).
  • Punto de entrada en destino.
  • Punto de salida en destino (opcional).

Cada checkpoint utiliza la geocerca correspondiente para determinar cuándo debe producirse un cambio de estatus.

ImportanteEl punto más importante de esta guía

Si un viaje no tiene checkpoints configurados, el sistema no cambiará automáticamente su estatus, aunque el camión ya haya llegado físicamente al origen o al destino.

En estos casos no aparece ningún mensaje de error.

Simplemente no ocurre ningún cambio.

Por ello, cuando un agente observa que un viaje permanece en el mismo estatus a pesar de que el vehículo ya llegó, la primera revisión debe consistir en verificar que los checkpoints estén correctamente configurados.

Una vez que un checkpoint dispara su cambio correspondiente, queda marcado como utilizado para impedir que el mismo cruce vuelva a modificar el estatus del viaje. ### Casos que un agente debe tener en cuenta

Estas son algunas situaciones reales que ayudan a explicar por qué un viaje puede no cambiar automáticamente de estatus.

Geocerca de salida sin configurar

La llegada se detecta correctamente, pero la salida nunca podrá registrarse de forma automática. En estos casos será necesario revisar el estatus manualmente.

GPS con retraso

Si el proveedor del GPS envía posiciones antiguas o acumuladas después de recuperar la señal, algunas lecturas pueden no utilizarse para generar cambios de estatus.

Falla temporal del sistema

Si ocurre una falla técnica justo cuando el equipo cruza la geocerca, el cambio puede perderse. Si posteriormente llega otra posición mientras el vehículo continúa dentro de la geocerca, el sistema volverá a intentar realizar el cambio.

Datos GPS inválidos

Una coordenada corrupta o con formato incorrecto puede impedir que el sistema procese correctamente ese reporte de ubicación.

Radio de geocerca demasiado pequeño

Si la dirección está mal ubicada o el radio configurado es insuficiente para cubrir realmente el patio o el andén, el equipo puede permanecer físicamente en el lugar sin llegar a entrar en la geocerca.

En resumen

TipResumen
  • Las geocercas son áreas virtuales utilizadas para detectar la llegada y salida de los equipos.
  • El GPS informa continuamente la posición del tracto y de las cajas.
  • Cuando una posición cruza una geocerca válida, el sistema cambia automáticamente el estatus del viaje.
  • La llegada al origen normalmente cambia el viaje a En carga.
  • La llegada al destino normalmente cambia el viaje a En destino.
  • La salida solo puede detectarse cuando existe una geocerca exterior configurada.
  • Si el viaje no tiene checkpoints configurados, el sistema no realizará ningún cambio automático.
  • El proceso ocurre prácticamente en tiempo real conforme llegan nuevas posiciones GPS.
  • El cambio automático de estatus no envía por sí mismo notificaciones a clientes ni operadores.

Documento de referencia operativa para BOL Operador Logístico. Basado en el funcionamiento del sistema de geocercas y detección automática de eventos de viaje.


Preguntas frecuentes

¿Qué hago si no puedo iniciar sesión al sistema?

Verifique que su correo electrónico y contraseña sean correctos. Si el problema persiste, contacte al administrador del sistema para validar el estado de su cuenta.

¿Qué significan los colores en la tabla de viajes?

  • Fila amarilla con ícono de advertencia: el viaje requiere atención porque contiene información pendiente o datos por validar.
  • Fila verde con ícono de verificación: el viaje no presenta observaciones y su información está completa.

¿Qué diferencia hay entre un Previaje y un Viaje?

Un Previaje corresponde a una solicitud de transporte pendiente de validación. Una vez confirmada la información necesaria, se convierte en un Viaje disponible para programación y seguimiento.

¿Cómo consulto la ubicación en tiempo real de una unidad?

Ingrese al módulo Viajes y abra la pestaña Vista GPS, donde podrá visualizar el semáforo de conexión, la última ubicación reportada y su posición en el mapa.

¿Puedo consolidar más de un viaje en una sola unidad?

Sí. Mediante la función Unir en Full es posible agrupar cargas compatibles dentro de un mismo viaje.

¿Qué hago si no encuentro un cliente, proveedor o ruta al crear un viaje?

Verifique primero si el registro existe en el módulo Catálogos. Si no existe, podrá crearlo desde ese módulo o directamente desde el formulario de captura del viaje.

14.5 Glosario

BOL
Sistema utilizado para la administración y seguimiento de las operaciones logísticas.
BSL
Referencia interna asignada a un viaje o embarque.
CI
Carta de Instrucciones. Documento que contiene la información principal del viaje.
ETA
Estimated Time of Arrival (Hora Estimada de Llegada).
Full
Consolidación de dos o más cargas compatibles dentro de un mismo viaje.
GPS
Sistema de Posicionamiento Global utilizado para rastrear las unidades.
KPI
Key Performance Indicator. Indicador utilizado para medir el desempeño operativo.
Pedimento
Documento requerido para operaciones aduanales de importación o exportación.
RFC
Registro Federal de Contribuyentes.
TIF
Tipo de dirección utilizado dentro del catálogo de direcciones.
RECO
Sistema utilizado para la gestión de importaciones.
Zona de No Parar
Tramo considerado de riesgo en el que se recomienda evitar detenciones durante el recorrido.

14.6 Requisitos técnicos

Para utilizar correctamente la plataforma BOL se recomienda contar con:

  • Navegador web: Google Chrome, Microsoft Edge o Mozilla Firefox en su versión más reciente.
  • Conexión a Internet: estable y con suficiente velocidad para el uso de mapas y sincronización en tiempo real.
  • Resolución mínima: 1366 × 768 píxeles.
  • Equipo recomendado: computadora de escritorio o laptop. Actualmente la plataforma no está optimizada para dispositivos móviles.

14.7 Soporte técnico

Para consultas, dudas o reportes relacionados con el funcionamiento del sistema, comuníquese con el equipo de soporte técnico:

  • Correo electrónico: contacto@hmhsistemas.com.mx
  • Teléfono: 312 323 7023
  • Horario de atención: lunes a viernes, de 09:00 a 18:00 horas.