Skip to main content
📋 Se aplica a: Admin · Partner Admin · SupportProveedor: TFMTipo de integración: UnidireccionalDirección: TFM → AlvysMódulo: Management > IntegrationsTFM es una integración ELD y telemática unidireccional: TFM envía ubicaciones de camiones y remolques y datos de Hours of Service a Alvys una vez que los activos están mapeados.

Resumen

TFM es una solución de dispositivo de registro electrónico (ELD), también conocida como proveedor de telemática o seguimiento GPS, que rastrea Hours of Service del conductor y ubicaciones de vehículos. La integración con TFM permite que Alvys extraiga datos de ubicación en vivo de sus camiones y remolques equipados con TFM, brindándole visibilidad en el Asset Map y en la planificación de despacho. Para completar la configuración, generará un token en su cuenta de TFM, configurará la integración en Alvys y luego mapeará cada camión o remolque a su ID de activo de TFM.

Requisitos previos

Antes de conectar TFM a Alvys:
  • Debe tener una cuenta activa de TFM con permiso para generar tokens.
  • Cada camión o remolque que desee rastrear debe estar configurado en su cuenta de TFM.
  • Debe tener el rol “Admin”, “Partner Admin” o “Support” en Alvys. Estos roles pueden acceder a Company Profile > Integrations.
  • Si administra múltiples subsidiarias, complete los pasos siguientes una vez para cada subsidiaria que desee habilitar.

Cómo conectar

Generar su token de TFM

  1. Inicie sesión en su cuenta de TFM.
  2. Vaya a Management y seleccione API Tokens.
  3. Haga clic en Generate Token. Cuenta TFM: pantalla Management > API Tokens mostrando el botón Generate Token. Cuenta TFM: pantalla Management > API Tokens mostrando el botón Generate Token.
  4. Ingrese un nombre de token (por ejemplo, “Alvys Integration”) y haga clic en OK. Diálogo de ingreso de nombre de token TFM con botón OK. Diálogo de ingreso de nombre de token TFM con botón OK.
  5. La página se actualiza y muestra su nuevo token de integración. Copie este token; lo necesitará en la siguiente sección.

Ingrese su token en Alvys

  1. En Alvys, haga clic en el icono de su perfil en la esquina inferior izquierda para abrir Company Profile.
  2. Seleccione la subsidiaria que desea configurar.
  3. Haga clic en la pestaña Integrations.
  4. Expanda la sección ELD.
  5. Haga clic en el icono de lápiz en la tarjeta TFM. Pestaña Integrations de Alvys con sección ELD expandida e icono de lápiz de tarjeta TFM visible. Pestaña Integrations de Alvys con sección ELD expandida e icono de lápiz de tarjeta TFM visible.
  6. Ingrese su API Token de TFM en el campo proporcionado.
  7. Haga clic en Save.
Alvys valida sus credenciales de inmediato. Si el token es aceptado, la integración con TFM se activa para esa subsidiaria.

Mapear cada activo a su ID de activo de TFM

Después de que la integración está activa, mapea camiones y remolques individuales en Alvys a sus ID de activo correspondientes en TFM. Este mapeo indica a Alvys de qué activo de TFM extraer datos de ubicación para cada vehículo. El campo Integration ID en Alvys corresponde al ID de activo en su cuenta de TFM. Para encontrar el ID de TFM de un activo, abra el activo en su cuenta de TFM y mire la URL. El número al final de la ruta de la URL es el ID de activo. Por ejemplo, si la URL es app.tfmeld.com/client/trucks/25236, el ID de activo es 25236.
  1. Vaya a Assets en el menú de navegación izquierdo y seleccione Trucks o Trailers.
  2. Haga doble clic en el activo que desea configurar para abrir su perfil.
  3. Desplácese hasta la sección ELD Integrations y haga clic en Add Integration.
  4. Seleccione TFM en el menú desplegable.
  5. Ingrese el ID de activo de TFM en el campo Integration ID.
  6. Haga clic en Save.
Repita para cada camión o remolque que desee rastrear.

Qué se sincroniza / flujo de datos

  • Los datos fluyen en una dirección: TFM envía ubicación y datos de Hours of Service a Alvys. Alvys no envía datos de vuelta a TFM.
  • Una vez que un activo está mapeado, Alvys extrae su ubicación automáticamente y la muestra en el Asset Map y en la planificación de despacho.
  • La integración de TFM de cada subsidiaria se configura y sincroniza de forma independiente.

Verificar que funciona

  1. Vaya a Assets en la navegación izquierda y seleccione Trucks o Trailers.
  2. Abra un camión o remolque que haya mapeado.
  3. Confirme que la sección ELD Integrations muestra TFM con el ID de activo que ingresó.
  4. Abra el Asset Map en Alvys y confirme que el camión o remolque muestra una ubicación actual.
📋 Límites / no compatibles: Cada subsidiaria requiere su propio token de TFM; un solo token no se puede compartir entre subsidiarias. · Alvys no escribe datos de despacho, asignaciones de carga ni ninguna otra información de vuelta a TFM: la sincronización es unidireccional de TFM a Alvys. · Los datos de sensores de temperatura de TFM no se muestran en Alvys.

Solución de problemas

Token rechazado al guardar

  1. Confirme que copió el token completo de TFM sin espacios al principio o al final.
  2. Regrese a su cuenta de TFM en Management > API Tokens y genere un token nuevo, luego vuelva a ingresarlo en Alvys.
  3. Si el error persiste, confirme que su cuenta de TFM tiene permiso para crear tokens. Contacte al soporte de Alvys si ninguna de estas razones aplica.

La ubicación del activo no aparece en el Asset Map después del mapeo

  1. Confirme que el ID de activo que ingresó en Alvys coincide exactamente con el número mostrado al final de la ruta de URL de ese activo en su cuenta de TFM.
  2. Confirme que el activo está activo y reportando actualmente en su cuenta de TFM.
  3. Espere unos minutos para que la primera actualización de ubicación se sincronice después de guardar el mapeo.
  4. Si el activo está activo en TFM y el ID es correcto pero no aparece ubicación, contacte al soporte de Alvys.

La sección ELD o la tarjeta TFM no son visibles en Alvys

  1. Confirme que inició sesión con rol Admin, Partner Admin o Support. La pestaña Integrations no es visible para otros roles.
  2. Confirme que está viendo una subsidiaria, no el company profile de nivel superior.
  3. Si tiene el rol correcto y está en una subsidiaria pero la tarjeta TFM aún no es visible, contacte al soporte de Alvys.

Preguntas frecuentes

P: ¿Dónde encuentro mis ID de activo de TFM? R: Abra el activo en su cuenta de TFM. El ID de activo es el número al final de la ruta de URL. Por ejemplo, si la URL es app.tfmeld.com/client/trucks/25236, el ID de activo es 25236. P: ¿Puedo rastrear tanto camiones como remolques con TFM? R: Sí. Puede agregar la integración TFM tanto a camiones como a remolques mapeando cada activo por separado en Assets > Trucks o Assets > Trailers. P: ¿Qué sucede si ingreso un token no válido? R: Alvys valida las credenciales antes de guardar. Si el token es incorrecto, verá un error de inmediato y la integración no se activará. P: ¿Puedo usar TFM para múltiples subsidiarias? R: Sí. Repita los pasos de conexión y mapeo de activos para cada subsidiaria. Cada subsidiaria requiere su propia configuración de token de TFM.

Profundice