Integración de combustible Compass

​

Resumen

La integración de combustible Compass (Compass Payment Services, importación de tarjeta de combustible, carga manual de CSV) conecta los datos de tarjeta de combustible Compass con Alvys. Este es un proceso de importación manual: descarga un archivo CSV del portal de Compass y lo carga en Alvys. Alvys luego coincide cada transacción con el conductor correcto usando el número de tarjeta de combustible almacenado en su perfil. Use esta integración para rastrear gastos de combustible, aplicar deducciones de combustible al pago del conductor y mantener registros de combustible precisos en su Fuel Report. La integración es unidireccional: los datos fluyen solo de Compass a Alvys.

​

Requisitos previos

Antes de configurar esta integración, confirme lo siguiente:

• Tiene acceso en Alvys para administrar Integrations (https://app.alvys.com/#/manage/integrations).
• Tiene credenciales de inicio de sesión para el portal de Compass Payment Services en cps.compasspaymentservices.com.
• Sus subsidiarias ya están configuradas en Alvys.

​

Cómo conectar

1. En Alvys, seleccione su Username en la esquina inferior izquierda y haga clic en la página de integraciones (https://app.alvys.com/#/manage/integrations).
2. En la lista de integraciones, expanda la categoría Fuel.
3. Haga clic en el botón gris “Inactive” junto a Compass.
4. Confirme que las subsidiarias correctas están seleccionadas, luego haga clic en Save.

Para que Alvys atribuya las transacciones al conductor correcto, cada conductor debe tener su número de tarjeta de combustible Compass en su perfil:

1. Desde la barra de herramientas de Alvys, vaya a Assets y seleccione Drivers.
2. Busque y abra un perfil de conductor.
3. En la primera sección, haga clic en el signo más junto a Fuel Card Numbers.

1. Ingrese el número de tarjeta de combustible para este conductor.
2. Seleccione Compass en el menú desplegable del proveedor.
3. Configure las casillas de deduct fuel y discounted fuel si corresponde.
4. Haga clic en Save.
5. Repita los pasos de tarjeta de combustible para cada conductor que tenga una tarjeta Compass.

​

Para descargar transacciones de combustible de Compass:

• Inicie sesión en el portal de Compass en cps.compasspaymentservices.com.
• Abra el Dashboard.
• En la sección Transactions, seleccione Export CSV.
  Esta imagen muestra el Dashboard del portal de Compass con la opción Export CSV resaltada en la sección Transactions.
  Esta imagen muestra el Dashboard del portal de Compass con la opción Export CSV resaltada en la sección Transactions.
• Seleccione su rango de fechas y haga clic en Export.
• Guarde el archivo CSV en su dispositivo.

Para cargar el archivo en Alvys (confirme primero que el número de tarjeta Compass de cada conductor esté guardado): Desde la barra de herramientas de Alvys, vaya a **Assets **y seleccione Fuel Report. Haga clic en el icono de elipsis vertical (⋮) junto al botón “Add **Transaction” **. Seleccione la opción “Import Report”. Seleccione Compass como tipo de integración. Cargue el archivo CSV que descargó del portal de Compass. Haga clic en el botón “Save” Después de completar la carga, use el filtro de rango Transaction Date en Fuel Report para revisar las transacciones importadas.

​

Qué se sincroniza

La integración de Compass es una sincronización manual unidireccional de Compass a Alvys. Después de cargar un CSV de Compass, Alvys mapea los datos de transacción de la siguiente manera:

• El número de tarjeta de combustible en el CSV se compara con los dígitos almacenados en el perfil del conductor. Las transacciones se atribuyen al conductor cuyo número de tarjeta de combustible coincide.
• La fecha, el monto y los galones de la transacción se importan al Fuel Report.
• Si el número de tarjeta de combustible en una transacción no coincide con ningún perfil de conductor, la transacción no se atribuirá a un conductor. Agregue o corrija el número de tarjeta en el perfil del conductor, luego vuelva a cargar el archivo.
• Alvys detecta transacciones duplicadas por ID de transacción y no importará duplicados.
• No hay sincronización automática ni programada para esta integración.

​

Solución de problemas

​

Las transacciones de combustible del conductor no aparecen después de la carga

1. Abra el perfil del conductor en Assets > Drivers y confirme que hay un número de tarjeta de combustible Compass guardado en Fuel Card Numbers.
2. Verifique que el número de tarjeta coincida con lo que aparece en la exportación CSV de Compass. Alvys coincide con los dígitos exactos almacenados en el perfil.
3. Vuelva a cargar el CSV después de corregir el número de tarjeta. Alvys no importará una transacción ya importada con el mismo ID de transacción, por lo que si la carga original se rechazó por completo, una nueva carga del mismo archivo funcionará.
4. Si las transacciones siguen faltando después de corregir el número de tarjeta, contacte al soporte de Alvys.

​

La carga falla o devuelve un error

1. Confirme que seleccionó Compass (no otro proveedor) en el menú desplegable Integration Type antes de cargar.
2. Confirme que el archivo es un CSV descargado directamente del portal de Compass. Los archivos modificados o reformateados pueden no analizarse correctamente.
3. Contacte al soporte de Alvys si el error persiste después de verificar el archivo y el tipo de integración.

​

Preguntas frecuentes

P: ¿Qué sucede si cargo el mismo archivo dos veces? R: Alvys detecta transacciones duplicadas por ID de transacción y no las importará de nuevo. Volver a cargar el mismo archivo es seguro. P: ¿Con qué frecuencia debo cargar informes de transacciones de combustible? R: Esto depende de su calendario de informes y liquidación. La mayoría de los equipos cargan semanal o mensualmente para mantener los datos de combustible actualizados. P: ¿Qué pasa si las transacciones de un conductor no aparecen después de la carga? R: Confirme que el conductor tiene el número de tarjeta de combustible Compass correcto en su perfil en Assets > Drivers. Alvys coincide transacciones con conductores usando ese número. Si el número falta o es incorrecto, agréguelo o corríjalo y vuelva a cargar el archivo. P: ¿Necesito credenciales de API para configurar esta integración? R: No. La integración de Compass no requiere credenciales de API. Solo necesita activarla en Management > Integrations y luego cargar archivos CSV manualmente.