📋 Se aplica a: Admins · Partner AdminsMódulo: Management > Integrations · Settings > Mileage ProfilesProveedor: PCMILER (Trimble) · Tipo de integración: unidireccional · Dirección: Alvys consulta a PCMILER para calcular el millaje de cargas y viajesConecta Alvys a PCMILER para crear Mileage Profiles que definan cómo se calcula el millaje de cargas y viajes, con parámetros como el tipo de ruteo, las preferencias de peaje, las clasificaciones de materiales peligrosos y la versión de PCMILER, sin costo adicional más allá de su suscripción existente a PC*MILER.
Qué hace esta integración
La integración con PCMILER permite a Alvys calcular el millaje de cargas y viajes con datos de ruteo de PCMILER en lugar del proveedor predeterminado HereMaps. Una vez conectada, puede crear Mileage Profiles con nombre que definan parámetros de ruteo precisos para distintas necesidades de clientes u operativas. Esos perfiles se pueden aplicar a nivel de inquilino o por cliente. Capacidades clave que ofrece esta integración:- Análisis de costos preciso: el seguimiento exacto del millaje respalda cálculos precisos de costos de transporte y la planificación financiera.
- Cumplimiento normativo: los informes de millaje alineados con los estándares del sector reducen el riesgo de incumplimiento.
- Planificación de rutas optimizada: los datos de ruteo de PC*MILER respaldan la selección de rutas eficientes en combustible.
- Control de versión de PCMILER: cuando los clientes exigen que el millaje se facture con una versión específica de PCMILER, puede fijar esa versión en el perfil y eliminar los ajustes manuales.
Requisitos previos
- Debe tener una suscripción activa a PC*MILER (Trimble) para obtener credenciales de API.
- Si aún no es cliente de PC*MILER, contacte al soporte de Alvys para solicitar credenciales de API en su nombre. Alvys coordinará con Trimble para obtenerlas.
- Si ya es cliente de PC*MILER, puede usar sus credenciales de API existentes para configurar la integración.
Conectar / autenticar
Ir a las integraciones en Alvys
En Alvys, vaya a Management > Integrations. Ubique la opción de integración con PC*MILER.Ingresar las credenciales de API
Ingrese sus credenciales de API de PC*MILER en los campos designados y habilita la configuración de la integración.
Cambiar la fuente de millaje predeterminada a PC*MILER
Después de guardar las credenciales de la integración, debe actualizar la configuración de cálculo de millaje predeterminada de HereMaps a PCMILER para activar el ruteo de PCMILER en sus cargas. En Alvys, haga clic en el icono de persona en la esquina inferior izquierda de cualquier página y seleccione Settings. Ubique la sección Mileage Profiles. Cambie la configuración de cálculo de millaje predeterminada de HereMaps a PC*MILER y guarde.Asignación de campos y datos
Los mileage profiles definen los parámetros que PC*MILER usa al calcular el millaje de una carga o un viaje. Los parámetros configurables de cada Mileage Profile son:- Routing Type: Practical, Shortest o Fastest
- Toll Roads: Always Avoid, Avoid if Possible o Allow
- Borders Open: Yes o No
- Use Traffic: Yes o No (aplica solo a Dispatch Mileage)
- HazMat Types: None, General, Caustic, Explosives, Flammable, Inhalants, Radioactive, HarmfulToWater o Tunnel (se admiten varias selecciones)
- PC Miler Version: un número de versión específico, seleccionable de una lista
Comportamiento de la sincronización
El millaje de PCMILER se calcula por demanda: cuando se crea una carga o un viaje, o cuando se recalcula el millaje, Alvys consulta la API de PCMILER con los parámetros definidos en el Mileage Profile seleccionado. Los mileage profiles se pueden asignar a nivel de inquilino (aplica a todas las cargas salvo que se anule) o a nivel de cliente (anula el valor predeterminado del inquilino para las cargas vinculadas a ese cliente).Verificar que funciona
Después de la configuración, cree un Mileage Profile de prueba y asígnelo a una carga. Confirme que el millaje que se muestra en la carga refleja los datos de ruteo de PC*MILER y no de HereMaps. Si la fuente de millaje sigue mostrando HereMaps, confirme que la configuración de millaje predeterminada se cambió en Settings > Mileage Profiles.Solución de problemas
El millaje se sigue calculando con HereMaps después de la configuración
Paso 1: confirme que la configuración de cálculo de millaje predeterminada se cambió de HereMaps a PC*MILER en Settings (haga clic en el icono de persona en la esquina inferior izquierda, seleccione Settings y revise Mileage Profiles). Paso 2: confirme que las credenciales de API guardadas en la integración son correctas y que la integración está en estado habilitado. Paso 3: confirme que el Mileage Profile que creó está asignado a la carga o al perfil del cliente.La versión de PC*MILER no produce el millaje esperado
Paso 1: confirme que el campo PC Miler Version del Mileage Profile está fijado en la versión que exige el cliente. Paso 2: confirme que el nombre del Mileage Profile incluye el número de versión, para que se seleccione el perfil correcto de la lista. Si ninguno de los pasos anteriores resuelve el problema, contacte al soporte de Alvys con el número de carga, el nombre del Mileage Profile y la fuente de millaje que aparece en la carga.Límites / no compatible
- La integración con Co-Pilot no se admite. PC*MILER se admite únicamente para el cálculo de millaje.
- El parámetro Use Traffic aplica solo a Dispatch Mileage; no tiene efecto en los cálculos de Customer Mileage.
- Se pueden seleccionar varios tipos de HazMat por perfil, pero elegir tipos en conflicto puede afectar los resultados de ruteo de PC*MILER.