Aplicable a: Administradores · Administradores de socios · Gerente de operaciones · Despachador
Módulo: Gestión > Integraciones
Propietario: Soporte
Última revisión: 2026-06
Conecte RoadStar a Alvys para obtener datos de ubicación en tiempo real de sus camiones y remolques equipados con RoadStar, lo que le brindará visibilidad en el mapa de activos y en la planificación de envíos.
Descripción general
RoadStar (también conocido como RoadStar ELD, RoadStar Telematics o BrightRoadStar) es una solución de dispositivo de registro electrónico (ELD) que registra las horas de servicio de los conductores y la ubicación de los vehículos. Esta integración permite a Alvys obtener automáticamente datos de ubicación en tiempo real de sus camiones y remolques equipados con RoadStar, para que su equipo pueda visualizar la posición de los activos en el mapa de activos y utilizar esos datos en la planificación de envíos.
Se trata de una integración unidireccional: RoadStar envía datos de ubicación a Alvys. No se envían datos de carga ni datos sobre las horas de servicio del conductor a RoadStar.
Requisitos previos
Antes de conectar RoadStar a Alvys, necesita lo siguiente:
Una cuenta activa de RoadStar con permiso para generar tokens de API.
Acceso a tu cuenta de Alvys con permisos de administrador o administrador de socios.
Tiempo estimado para completar la instalación: 20 minutos.
Cómo conectarse
Genera tu token de API de RoadStar.
Inicie sesión en su cuenta de RoadStar y vaya a Administración > Tokens de API .
Haz clic en Generar token .
Pantalla de tokens de la API de RoadStar que muestra el botón Generar token.
Abra la sección Integraciones en Alvys.
Haz clic en el icono de perfil que se encuentra en la esquina inferior izquierda de Alvys.
Imagen que muestra la navegación a la página de Integraciones de Alvys.
Imagen que muestra la navegación a la página de Integraciones de Alvys.
Seleccione la filial que desea configurar.
Introduce tu token de API de RoadStar.
En la pestaña Integraciones, expanda la sección ELD y haga clic en el icono del lápiz en la tarjeta RoadStar.
Imagen que muestra la pestaña ELD expandida en la página de Integraciones de Alvys.
Imagen que muestra la pestaña ELD expandida en la página de Integraciones de Alvys.
Introduzca su token de API de RoadStar y haga clic en Guardar .
Imagen que muestra el formulario "Agregar integración" de Alvys para RoadStar Eld.
Recursos cartográficos para el seguimiento de la ubicación
Debe asignar cada camión o remolque en Alvys a su ID de activo RoadStar correspondiente. Sin este paso, los datos de ubicación no aparecerán, incluso si las credenciales de integración son válidas.
Abra el recurso en Alvys.
Dirígete a Activos en el menú de la izquierda y selecciona Camiones o Remolques .
Haga doble clic en el activo que desea configurar, luego desplácese hacia abajo hasta la sección Integraciones ELD y haga clic en Agregar integración .
Encuentre su ID de activo de RoadStar.
Abra el recurso en su plataforma RoadStar y observe la URL en su navegador. El ID del recurso es el número que aparece al final de la ruta de la URL. Por ejemplo, si la URL es app.brightroadstar.com/client/trucks/25236 , el ID del recurso es 25236.
Introduzca el ID del activo y guarde.
Seleccione RoadStar en el menú desplegable Agregar integración, ingrese el ID del activo en el campo ID de integración y haga clic en Guardar .
Repita este proceso para cada camión o remolque que desee rastrear con RoadStar.
Imagen que muestra el menú desplegable "Agregar integración" en el perfil del activo.
¿Qué sincroniza?
Una vez activada la integración, Alvys obtiene los datos de ubicación de RoadStar para cada activo que se haya mapeado. Los siguientes datos fluyen de RoadStar a Alvys:
Localización de activos en tiempo real (latitud y longitud).
Posiciones de los activos visibles en el mapa de activos de Alvys.
Una vez configurada la integración y asignados los activos, Alvys obtiene automáticamente las actualizaciones de ubicación de RoadStar de forma periódica. No se requiere ninguna acción manual tras la configuración inicial. Los datos de ubicación aparecen en el Mapa de Activos siempre que el activo tenga un ID de activo de RoadStar válido asignado en Alvys.
Para confirmar que la integración funciona, abra el Mapa de activos en Alvys después de completar la configuración y mapear al menos un activo. A continuación, verifique que el camión o remolque mapeado muestre una ubicación actual. Si el activo no muestra una ubicación, consulte la sección de Solución de problemas a continuación.
📋 Límites y funciones no compatibles:
La integración solo extrae datos de ubicación; los datos de horas de servicio (HOS) del conductor no se muestran en Alvys.
La integración se configura por filial; cada filial requiere su propio token de API de RoadStar.
Cada camión o remolque debe ser mapeado individualmente; no existe la opción de mapeo masivo de activos.
Solo los camiones y remolques pueden asignarse a los identificadores de activos de RoadStar.
Solución de problemas
La ubicación del activo no aparece en el mapa de activos.
Confirme que el token de la API de RoadStar guardado en Integraciones sea correcto. Un token no válido impedirá la sincronización de los datos de ubicación. Vaya a Administración > Integraciones, expanda la sección ELD y verifique que la tarjeta de RoadStar muestre un estado activo.
Confirme que el activo tenga asignado un ID de activo de RoadStar. Abra el activo en Alvys (Activos > Camiones o Activos > Remolques), desplácese hasta Integraciones ELD y verifique que exista una entrada de RoadStar con un ID de integración válido.
Confirme que el ID del activo coincida con el número que aparece en la URL de la plataforma RoadStar para dicho activo. Si no coincide, la sincronización de la ubicación fallará sin mostrar ningún mensaje de error.
Si las credenciales son válidas, el ID del activo es correcto y aún no aparecen los datos de ubicación, póngase en contacto con el soporte de Alvys y proporcione el nombre del activo y el ID del activo de RoadStar para que el equipo técnico pueda investigar la respuesta de sincronización.
Error de token de API no válido al guardar
Vuelva a generar el token de API en su cuenta de RoadStar (Administración > Tokens de API > Generar token) y copie el nuevo token tal cual.
Vuelva a Integraciones de Alvys, expanda la sección ELD, haga clic en el icono del lápiz en la tarjeta RoadStar, pegue el nuevo token y haga clic en Guardar .
Preguntas frecuentes
P: ¿Dónde puedo encontrar los identificadores de mis activos de RoadStar?
A: La forma más sencilla es consultar la URL al visualizar o editar un activo en su plataforma RoadStar. El ID del activo es el número que aparece al final de la ruta de la URL (por ejemplo, app.brightroadstar.com/client/trucks/25236 corresponde al ID de activo 25236).
P: ¿Puedo rastrear tanto camiones como remolques?
R: Sí. Puede configurar el seguimiento de RoadStar tanto para camiones como para remolques agregando la integración a cada activo individualmente.
P: ¿Qué sucede si ingreso un token de API no válido?
A: Alvys valida las credenciales al guardar. Si el token es incorrecto, verá un error inmediatamente y la integración no se activará. Genere el token nuevamente en RoadStar e introdúzcalo en Alvys.
P: ¿Esta integración requiere configuración por separado para cada filial?
R: Sí. El token de la API de RoadStar se configura por filial. Si tiene varias filiales, cada una necesita su propio token, que deberá introducirse en su pestaña de Integraciones.