Integración con Highway

​

Resumen

La integración con Highway (también llamada integración de cumplimiento de transportistas o integración de verificación de transportistas) conecta Alvys con la plataforma de cumplimiento de transportistas de Highway. Una vez conectada, Alvys se sincroniza con Highway cada cinco minutos para mantener los datos de transportistas actualizados. Los transportistas que completan la incorporación en Highway se crean automáticamente en Alvys, y los cambios de estado se reflejan casi en tiempo real. Esto elimina la entrada manual de transportistas y garantiza que su equipo siempre tenga información de cumplimiento precisa antes de asignar un transportista a una carga.

​

Requisitos previos

Antes de comenzar, necesita una cuenta activa de Highway y una clave de integración de Alvys de Highway. Si está cambiando desde otro TMS, revoque su conexión de Highway en ese TMS antes de conectar con Alvys. Ejecutar dos conexiones activas simultáneamente puede causar conflictos de sincronización. Una vez que su contacto de Highway confirme que la clave de integración está lista, todos sus transportistas incorporados previamente se sincronizarán automáticamente en Alvys después de completar la configuración siguiente.

​

Cómo conectar?

• Abra Integrations en Alvys. Haga clic en el icono de su perfil en la esquina inferior izquierda de Alvys y seleccione Integrations. En la sección Carrier Compliance, localice la tarjeta Highway y hágala clic para abrir la configuración.
• Ingrese su clave de API y seleccione subsidiarias. Ingrese la clave de API proporcionada por su representante de Highway. Luego seleccione a qué subsidiarias desea aplicar la integración. Alvys valida su clave de API automáticamente. Si la clave no es válida o ha expirado, aparece un banner que le solicita volver a ingresar sus credenciales.

• Confirme que la integración está activa. Una vez que se acepta la clave de API, el estado de la integración con Highway cambia a activo. Los transportistas incorporados previamente en Highway comenzarán a sincronizarse automáticamente en Alvys.

​

Qué se sincroniza?

Cuando un transportista completa la incorporación en Highway, Highway envía los siguientes datos a Alvys: nombre del transportista, número MC/DOT, dirección, detalles de seguro y estado de cumplimiento. Estos campos se mapean al registro de transportista correspondiente en Alvys. Alvys no envía registros de transportistas a Highway; Highway es el sistema de registro para la creación de transportistas. Las actualizaciones en tiempo real de Highway incluyen cambios de seguro, actualizaciones de dirección y modificaciones del estado de cumplimiento. Cada actualización se aplica al registro de transportista coincidente en Alvys. Alvys consulta Highway cada cinco minutos para detectar cambios de estado de cumplimiento y nuevos registros de transportistas. Para confirmar que la integración funciona, vaya a su lista de transportistas y busque transportistas que ya estaban incorporados en Highway. Deberían aparecer automáticamente en Alvys dentro de los cinco minutos posteriores a que la integración se active. Cada transportista debe mostrar un estado de cumplimiento de Highway (Pass, Partial Pass, Incomplete o Fail) en su registro de transportista. Si los transportistas no aparecen, confirme que su representante de Highway marcó la configuración de integración como completa en su lado.

​

Solución de problemas

​

Error de validación de clave de API al guardar

1. Confirme que copió la clave de API completa de su representante de Highway sin espacios adicionales.
2. Pida a su representante de Highway que genere una nueva clave de integración e intente de nuevo.
3. Si el error persiste después de ingresar una clave válida, contacte al soporte de Alvys. El paso de validación de credenciales puede no estar llegando a la API de Highway.

​

Los transportistas no se sincronizan después de la configuración

1. Confirme que su representante de Highway completó su parte de la configuración de integración.
2. Espere hasta cinco minutos. El intervalo de sincronización es de cinco minutos entre consultas.
3. Si los transportistas completamente incorporados en Highway siguen faltando después de 10 minutos, contacte al soporte de Alvys.

​

Un transportista con estado Incomplete o Fail no se puede asignar a una carga

• Los transportistas con estado Incomplete o Fail están bloqueados para asignación de carga de forma predeterminada. Este es el comportamiento esperado cuando la integración con Highway está activa. Si su cuenta tiene habilitado el permiso “OverrideCarrier”, puede proceder con la asignación a su discreción.

​

Preguntas frecuentes

P: ¿Qué sucede si agrego un transportista directamente en Alvys en lugar de a través de Highway? R: Los transportistas agregados directamente en Alvys no son monitoreados por Highway. No recibirá actualizaciones de estado de cumplimiento para esos transportistas. P: ¿Con qué frecuencia Alvys se sincroniza con Highway? R: Alvys se sincroniza con Highway cada cinco minutos. P: ¿Puedo asignar un transportista con estado Fail a una carga? R: De forma predeterminada, los transportistas con estado Fail están bloqueados para asignación de carga. Si su cuenta tiene habilitado el permiso “OverrideCarrier”, puede proceder con la asignación a su discreción. P: ¿Cuáles son los cuatro estados de cumplimiento de Highway? R: Los cuatro estados son Pass (todos los requisitos cumplidos, asignación permitida), Partial Pass (algunos requisitos cumplidos, asignación permitida), Incomplete (documentación aún incompleta, asignación bloqueada de forma predeterminada) y Fail (requisitos de cumplimiento no cumplidos, asignación bloqueada de forma predeterminada). P: Si usaba Highway con un TMS diferente, ¿qué debo hacer antes de conectar con Alvys? R: Debe revocar la conexión de Highway en su TMS anterior antes de conectar en Alvys. No hacerlo puede causar conflictos de sincronización.