Se aplica a: Administrador · Administrador de socios
Módulo: Integraciones
Última revisión: 2026-06
Propietario: Equipo de Integraciones
Integración bidireccional del mantenimiento: Fleetrock envía las actualizaciones de las órdenes de reparación a Alvys mediante un webhook y Alvys importa las órdenes de reparación abiertas al activarse.
Descripción general
Fleetrock es una plataforma de gestión de mantenimiento de flotas que se conecta con Alvys para mantener sincronizados los pedidos de reparación y los elementos de mantenimiento programado. También se conoce como integración de mantenimiento de flotas, integración de pedidos de reparación o integración de seguimiento de mantenimiento.
Conectar Fleetrock con Alvys permite que su equipo vea y gestione las órdenes de reparación directamente en Alvys sin necesidad de acceder al portal de Fleetrock. Cuando se actualiza una orden de reparación en Fleetrock, Alvys refleja el cambio automáticamente. Alvys también recibe alertas de mantenimiento programado de Fleetrock, que aparecen en el Planificador de Despacho para que los despachadores puedan ver las próximas necesidades de servicio junto con las asignaciones de carga.
Requisitos previos
Antes de conectarse, confirme que dispone de lo siguiente:
Una cuenta activa de Fleetrock con acceso a la API.
Sus credenciales de la API de Fleetrock (nombre de usuario y contraseña de Fleetrock).
El rol de "Administrador" o "Administrador de socios" en Alvys. Estos roles pueden acceder a Administración > Integraciones .
Cómo conectarse
Abra las integraciones de mantenimiento: vaya a Administración > Integraciones > Mantenimiento en la navegación superior.
Imagen que muestra el menú desplegable de integración de mantenimiento.
Busque Fleetrock en la lista y haga clic en el estado "Inactivo" para abrir el cuadro de diálogo de configuración.
Imagen que muestra la tarjeta de integración de Fleetrock con estado inactivo, en la página de integraciones de Alvys.
Introduzca la URL de inicio de sesión proporcionada por Fleetrock. Por ejemplo: https://www.fleetrock.com . Tenga en cuenta que los inquilinos que sean socios revendedores pueden tener una URL de inicio de sesión diferente.
Imagen que muestra el formulario "Configurar integración" de Alvys para la integración con Fleetrock, con la URL de inicio de sesión y los campos de entrada de nombre de usuario.
Introduzca el nombre de usuario (por ejemplo, Alvyscustomer ). Solo debe utilizarse la cuenta principal o del propietario. Esta opción se encuentra en Fleetrock, en Configuración > Usuarios.
Imagen que muestra la página de configuración de Fleetrock con los detalles del usuario.
Genera la clave API. En Fleetrock, ve al menú Configuración y selecciona API. Introduce «Alvys» como descripción y asegúrate de desmarcar la casilla «Usar tokens web JSON (JWT)», ya que la integración no funcionará si está marcada. Haz clic en « Generar clave » y copia la clave API del campo gris en la configuración de integración de Alvys.
Imagen que muestra la página de configuración de Fleetrock con detalles de la API.
Seleccione la filial adecuada para la integración.
Imagen que muestra el formulario "Configurar integración" de Alvys para la integración con Fleetrock, con los campos de entrada "Clave API" y "Filiales".
Seleccione el grupo de activos predeterminado . Los grupos de activos en Fleetrock son necesarios para la creación de activos y ayudan a organizar las unidades. Un grupo predeterminado garantiza que los nuevos activos de Alvys se creen y clasifiquen correctamente en Fleetrock. Los grupos se pueden crear y administrar en Fleetrock accediendo a la pestaña Activos y seleccionando el botón Grupos .
Imagen que muestra el menú desplegable Grupo de activos predeterminado durante la configuración de la integración de Alvys Fleetrock.
Vincula Fleetrock y Alvys para recibir actualizaciones automáticas. Fleetrock utiliza webhooks para enviar datos en tiempo real a Alvys. Copia la URL del webhook proporcionada por Alvys. En Fleetrock, ve a la página de Configuración y selecciona Webhooks. Habilita el webhook marcando la casilla " Habilitar ". Pega la URL del webhook proporcionada por Alvys en el campo " URL del punto final ".
Imagen que muestra el cuadro de diálogo "Configurar webhooks" con detalles del webhook, como la clave secreta y la URL del webhook.
Copia la clave secreta de Alvys e introdúcela en el campo " Clave secreta del webhook ".
Seleccione " Todos " en el campo de entrada "Enviar eventos " y, a continuación, haga clic en " Enviar webhook de prueba " para verificar la conexión.
Imagen que muestra la interfaz de usuario de configuración de Fleetrock para la configuración de Webhook.
Un mensaje de confirmación indicará que la configuración es correcta. Finalmente, seleccione " Actualizar " para guardar la configuración del webhook.
Imagen que muestra la configuración exitosa de webhooks en Fleetrock.
Vuelve a Alvys y selecciona el botón Activar.
Imagen que muestra el botón "Activar" en el paso final de la configuración de integración de Fleetrock.
La integración ahora aparecerá como activa.
Imagen que muestra la integración activa de Fleetrock.
Creación de activos y sincronización con Fleetrock.
Cuando se activa la integración con Fleetrock por primera vez, Alvys no crea nuevos activos en Fleetrock para las unidades que solo existen en Alvys. Sin embargo, si un activo existe en ambos sistemas con el mismo VIN, la integración sincronizará automáticamente esos registros. Una vez habilitada la integración, cualquier activo nuevo (camiones y remolques) creado en Alvys se creará automáticamente en Fleetrock. Este proceso elimina la duplicación de datos, mantiene Fleetrock actualizado con la información de su flota actual y garantiza que los programas de mantenimiento se apliquen correctamente a los activos adecuados.
Campos sincronizados desde Alvys hasta Fleetrock:
Número de camión/remolque (Número de unidad)
Número de licencia
Estado de la licencia (Estado de registro)
Licencia (Vencimiento del registro)
VIN: Una vez que se proporciona un VIN válido, Fleetrock completará automáticamente detalles adicionales como la marca, el modelo y el año en la pestaña Datos VIN para el camión o remolque correspondiente.
Estado (Activo/Inactivo).
⚠️ Los cambios realizados en los activos directamente en Fleetrock no se sincronizarán con Alvys. ( Alvys es la fuente de información fidedigna ).
Si se elimina un activo en Alvys, su estado se establecerá como Inactivo en Fleetrock. Si ese activo se vuelve a crear en Alvys utilizando el mismo VIN, Fleetrock detectará la coincidencia y cambiará el estado de nuevo a Activo.
¿Qué sincroniza/flujo de datos?
Los estados de las órdenes de reparación se corresponden entre Fleetrock y Alvys de la siguiente manera:
Estado de Fleetrock | Estado de Alvy |
No ha comenzado | Abierto |
En curso | En curso |
Espera | En curso |
Finalizado | Terminado |
Facturado | Terminado |
Pagado | Terminado |
Los elementos de mantenimiento programados de Fleetrock también se sincronizan con Alvys. Estos aparecen como recordatorios de servicio próximos en el Planificador de despachos.
Fleetrock envía actualizaciones a Alvys automáticamente mediante webhook cada vez que se crea una orden de reparación o cambia su estado. No es necesario actualizar ni sincronizar manualmente. Los datos de mantenimiento programado se envían de Fleetrock a Alvys una vez al día a las 5:00 a. m. (hora del este).
La coincidencia del VIN se utiliza para vincular las órdenes de reparación en Fleetrock con el camión correcto en Alvys. El VIN del camión en Alvys debe coincidir con el VIN en Fleetrock para que las órdenes de reparación aparezcan en el activo correcto.
Cómo ver las órdenes de reparación en Alvys
Una orden de reparación (también conocida como orden de trabajo) es una solicitud formal para realizar mantenimiento o reparaciones en una unidad como un camión o un remolque.
Una vez habilitada la integración con Fleetrock, Alvys importará automáticamente cualquier orden de reparación de Fleetrock que no haya comenzado o que esté en curso . Estas órdenes de reparación se importan a Alvys como eventos de activos .
Vaya a la Lista de activos (Lista de camiones o Lista de remolques) en Alvys.
Seleccione la pestaña Eventos de activos en el registro. Aquí aparecerán todas las órdenes de reparación activas y completadas sincronizadas desde Fleetrock.
Imagen que muestra un perfil de camión de muestra, pestaña "Eventos de activos" con detalles de la orden de trabajo.
Imagen que muestra un perfil de camión de muestra, pestaña "Eventos de activos" con detalles de la orden de trabajo.
Haga clic en una orden de reparación para ver sus detalles, estado e historial de servicio, según lo informado por Fleetrock.
Cómo aparece el mantenimiento programado en el Planificador de despachos
El Planificador de Despachos muestra el mantenimiento programado de Fleetrock en una columna dedicada. Los despachadores pueden ver:
El camión que tiene una revisión programada.
El tipo de servicio programado.
La fecha de vencimiento o el límite de kilometraje para el servicio.
El estado actual de cualquier orden de reparación activa para ese camión.
Esto permite a los operadores planificar la asignación de cargas en función de las necesidades de mantenimiento antes de que se conviertan en urgentes.
Límites / no compatible:
Solo se importan las órdenes de reparación con estado "No iniciada" o "En curso" durante la activación.
El mantenimiento programado se sincroniza una vez al día (a las 5:00 a. m., hora del este), no en tiempo real.
Es necesario que el número de identificación del vehículo (VIN) coincida; las órdenes de reparación no se vincularán a un camión si el VIN no coincide.
La opción JWT debe permanecer desactivada; la autenticación JWT no es compatible con esta integración.
Solo se importan las órdenes de reparación con estado "No iniciada" o "En curso" durante la activación.
El mantenimiento programado se sincroniza una vez al día (a las 5:00 a. m., hora del este), no en tiempo real.
Es necesario que el número de identificación del vehículo (VIN) coincida; las órdenes de reparación no se vincularán a un camión si el VIN no coincide.
La opción JWT debe permanecer desactivada; la autenticación JWT no es compatible con esta integración.
Solución de problemas
Las órdenes de reparación no aparecen después de la activación.
Confirma que la opción JWT estaba DESMARCADA al guardar las credenciales. Si JWT estaba marcada, la conexión no se autenticará correctamente. Vuelve a introducir tus credenciales con JWT desmarcada.
Verifique que las órdenes de reparación en Fleetrock tengan el estado "No iniciada" o "En curso". Solo estos dos estados se importan durante la activación inicial.
Verifique que los números de identificación del vehículo (VIN) de los camiones en Alvys coincidan exactamente con los VIN en Fleetrock. Si los VIN no coinciden, las órdenes de reparación no aparecerán en el camión correcto.
Un cambio en el estado de una orden de reparación en Fleetrock no se actualiza en Alvys.
Confirme que el webhook de Fleetrock esté activo. La conectividad del webhook es necesaria para las actualizaciones en tiempo real. Si el webhook se interrumpió, comuníquese con Fleetrock para verificar que esté apuntando al punto final correcto de Alvys.
Consulta la tabla de correspondencia de estados que aparece arriba: algunos estados de Fleetrock se corresponden con el mismo estado de Alvys (por ejemplo, Finished, Invoiced y Paid se corresponden con Completed).
El mantenimiento programado no aparece en el Planificador de despachos.
Los datos de mantenimiento programado se sincronizan una vez al día a las 5:00 a. m. (hora del este). Si agregó un nuevo programa de mantenimiento en Fleetrock hoy, aparecerá en Alvys a la mañana siguiente. Si no aparece después de 24 horas, comuníquese con el soporte técnico de Alvys.
Preguntas frecuentes
P: ¿Por qué faltan algunas órdenes de reparación después de conectar Fleetrock?
R: Solo se importan las órdenes de reparación con estado "No iniciada" o "En curso" en Fleetrock al activar la integración por primera vez. Las órdenes de reparación con otros estados (como "Terminada", "Facturada" o "Pagada") no se importan al activar la integración. Aparecerán en Alvys a medida que Fleetrock envíe futuras actualizaciones de webhook.
P: ¿Qué sucede cuando marco una orden de reparación como pagada en Fleetrock?
A: Fleetrock envía una actualización de webhook a Alvys. El estado de la orden de reparación en Alvys se actualiza a Completado.
P: ¿Pueden los despachadores ver qué camiones necesitan mantenimiento antes de asignarles las cargas?
R: Sí. El mantenimiento programado de Fleetrock aparece en el Planificador de Despacho para que los despachadores puedan tener en cuenta las necesidades de servicio al asignar las cargas.
P: ¿Qué significa "JWT debe estar sin verificar"?
A: Durante la configuración, en el formulario de credenciales encontrará una opción llamada JWT. Esta opción debe permanecer sin marcar. Si se marca, la autenticación de Fleetrock no funcionará y la integración fallará.
P: ¿Qué sucede si elimino un activo en Alvys?
A: En Fleetrock, el activo pasa a estar inactivo. Si lo recreas con el mismo VIN, Fleetrock lo volverá a activar.
P: ¿Por qué no veo el estado del mantenimiento en Alvys justo después de crear un mantenimiento programado en Fleetrock?
R: Fleetrock envía los datos de mantenimiento programado a Alvys diariamente a las 5 AM EST, por lo que los cambios no se mostrarán de inmediato.
P: ¿Y la contabilidad? ¿Cómo llegan las facturas/órdenes de compra de Fleetrock a los sistemas de contabilidad externos?
R: Fleetrock ofrece integración con QuickBooks Online (QBO). Si un cliente no utiliza QBO, deberá crear su propia integración contable.