📋 Se aplica a: Usuarios con permiso para administrar integraciones
Módulo: Gestión > Integraciones > Combustible
Proveedor: Compass Payment Services · Tipo de integración: Unidireccional (carga manual de CSV) · Dirección de sincronización: Compass a Alvys; los usuarios descargan un archivo CSV del portal de Compass y lo cargan en Alvys
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Compass Payment Services se conecta a Alvys mediante un proceso manual de carga de archivos CSV. Descargue los datos de las transacciones de la tarjeta de combustible desde el portal de Compass y cárguelos en Alvys para aplicar los descuentos por combustible y mantener los registros de consumo. Este proceso también se conoce como importación de datos de la tarjeta de combustible de Compass.
Descripción general
La integración de Compass para el combustible (Servicios de Pago de Compass, importación de tarjetas de combustible, carga manual de archivos CSV) conecta los datos de las tarjetas de combustible de Compass con Alvys. Este es un proceso de importación manual: se descarga un archivo CSV del portal de Compass y se carga en Alvys. Alvys asocia cada transacción con el conductor correcto utilizando el número de tarjeta de combustible almacenado en su perfil.
Utilice esta integración para controlar los gastos de combustible, aplicar deducciones por combustible a la nómina de los conductores y mantener registros precisos de combustible en su Informe de Combustible. La integración es unidireccional: los datos fluyen únicamente de Compass a Alvys.
Requisitos previos
Antes de configurar esta integración, confirme lo siguiente:
En Alvys tienes acceso para gestionar las integraciones.
Usted dispone de credenciales de acceso al portal de Compass Payment Services en cps.compasspaymentservices.com .
Sus filiales ya están configuradas en Alvys.
Cómo conectarse
En Alvys, vaya a Gestión y seleccione la filial que desea integrar con Compass.
Haz clic en el botón azul " Integrar ".
En la lista de integraciones, expanda la categoría Combustible .
Haz clic en el icono del lápiz gris que aparece junto a Brújula .
Confirme que se han seleccionado las filiales correctas y, a continuación, haga clic en Guardar .
No se requieren credenciales de API para la integración con Compass. Al habilitar la integración, Compass se registra como un tipo de carga disponible en el Informe de combustible.
Para que Alvys pueda atribuir las transacciones al conductor correcto, cada conductor debe tener su número de tarjeta de combustible Compass en su perfil:
Desde la barra de herramientas de Alvys, vaya a Activos y seleccione Controladores .
Busca y abre un perfil de conductor.
En la primera sección, haga clic en el signo más junto a Números de tarjeta de combustible .
Introduzca el número de la tarjeta de combustible de este conductor.
Seleccione Compass en el menú desplegable de proveedores.
Marque las casillas de deducción de combustible y combustible con descuento, si corresponde.
Haz clic en Guardar .
Repita los pasos de la tarjeta de combustible para cada conductor que tenga una tarjeta de combustible Compass.
Para descargar las transacciones de combustible de Compass:
Inicie sesión en el portal de Compass en cps.compasspaymentservices.com .
Abra el panel de control .
En la sección Transacciones, seleccione Exportar CSV .
Seleccione el rango de fechas y haga clic en Exportar .
Guarda el archivo CSV en tu dispositivo.
Para subir el archivo a Alvys (confirme primero que el número de tarjeta de combustible Compass de cada conductor esté guardado):
Desde la barra de herramientas de Alvys, vaya a Informes y seleccione Informe de combustible .
Haga clic en el botón azul "Cargar archivo de transacción" .
En la ventana emergente, seleccione Compass como tipo de integración.
Sube el archivo CSV que descargaste del portal Compass.
Una vez finalizada la carga, utilice el filtro de rango de fechas de transacción en el Informe de combustible para revisar las transacciones importadas.
¿Qué sincroniza?
La integración con Compass es una sincronización manual y unidireccional desde Compass a Alvys. Después de cargar un archivo CSV de Compass, Alvys asigna los datos de las transacciones de la siguiente manera:
El número de la tarjeta de combustible del archivo 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 de la transacción, el importe y los galones se importan al Informe de Combustible.
Si el número de tarjeta de combustible de una transacción no coincide con el perfil de ningún conductor, la transacción no se atribuirá a ningún conductor. Añada o corrija el número de tarjeta en el perfil del conductor y vuelva a cargar el archivo.
Alvys detecta las transacciones duplicadas mediante su ID y no importa duplicados.
Esta integración no cuenta con sincronización automática ni programada.
⚠️ Esta integración no admite importaciones automáticas ni programadas. · Las transacciones con un número de tarjeta que no coincida con ningún perfil de conductor no se atribuirán a ningún conductor. · Alvys no envía datos a Compass.
Solución de problemas
Las transacciones de combustible del conductor no aparecen después de la carga.
Abra el perfil del conductor en Activos > Conductores y confirme que se haya guardado un número de tarjeta de combustible Compass en Números de tarjeta de combustible.
Verifique que el número de tarjeta coincida con el que aparece en la exportación CSV de Compass. Alvys verifica que coincidan exactamente los dígitos almacenados en el perfil.
Vuelva a cargar el archivo CSV después de corregir el número de tarjeta. Alvys no importará una transacción que ya se haya importado con el mismo ID de transacción, por lo que si la carga original fue rechazada por completo, una nueva carga del mismo archivo funcionará.
Si después de corregir el número de tarjeta siguen faltando transacciones, póngase en contacto con el servicio de asistencia de Alvys.
La carga falla o devuelve un error.
Confirme que ha seleccionado Compass (y no otro proveedor) en el menú desplegable Tipo de integración antes de subir el archivo.
Confirme que el archivo sea un CSV descargado directamente del portal Compass. Los archivos modificados o reformateados podrían no analizarse correctamente.
Si el error persiste después de verificar el archivo y el tipo de integración, póngase en contacto con el soporte técnico de Alvys.
Preguntas frecuentes
P: ¿Qué sucede si subo el mismo archivo dos veces?
R: Alvys detecta las transacciones duplicadas mediante su ID y no las importará de nuevo. Volver a subir el mismo archivo es seguro.
P: ¿Con qué frecuencia debo subir los informes de transacciones de combustible?
R: Esto depende de su calendario de informes y liquidación. La mayoría de los equipos suben los datos semanal o mensualmente para mantenerlos actualizados.
P: ¿Qué sucede si las transacciones de un conductor no aparecen después de subirlas?
A: Confirme que el conductor tenga el número correcto de la tarjeta de combustible Compass en su perfil, en Activos > Conductores. Alvys asocia las transacciones con los conductores mediante 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 con Compass no requiere credenciales de API. Solo necesita activarla en Administración > Integraciones y luego cargar manualmente los archivos CSV.