Se aplica a: Administración · Soporte · Administración de socios
Módulo: Gestión > Integraciones > Combustible
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Este artículo explica cómo configurar la integración de la tarjeta de combustible EFS (WEX) en Alvys, configurar las importaciones diarias automáticas o las cargas manuales de archivos CSV y agregar los números de tarjeta de combustible EFS a los perfiles de los conductores.
Descripción general
La integración con EFS conecta tu cuenta de tarjeta de combustible EFS (WEX) (red de combustible) con Alvys para importar transacciones de combustible, ya sea automáticamente a través de la API o manualmente mediante la carga de un archivo CSV. EFS también admite la emisión de cheques electrónicos para pagos a conductores, como anticipos, tarifas de carga y reparaciones. Las importaciones automáticas se ejecutan diariamente a la 1:00 a. m. y extraen las transacciones de los últimos dos días. Las importaciones manuales utilizan un archivo CSV que descargas del sitio web de EFS y cargas en Alvys.
La integración proporciona dos servicios en Alvys:
Gestión de combustible: Importa datos de transacciones de combustible de EFS al Informe de combustible de Alvys. Esto se puede configurar como una importación automática diaria mediante API o como una carga manual en formato CSV.
Servicio de cheques electrónicos: Permite la emisión segura de pagos digitales directamente desde Alvys. Los cheques electrónicos se pueden usar para anticipos a conductores, tarifas de descarga, costos de reparación y gastos similares.
💡 A EFS también se le conoce como EFS WEX, la tarjeta de combustible EFS o la red de combustible EFS.
Requisitos previos
Antes de configurar EFS en Alvys, confirme lo siguiente:
En Alvys, usted tiene acceso de "Administrador" , "Soporte" o "Administrador de socios" (configurado en su rol de usuario en el Perfil de la empresa).
Para la importación automática de la API : primero debe agregar a Alvys como socio de intercambio de datos en EFS y obtener las credenciales de la API del soporte de EFS. Estas credenciales son diferentes de las que usa habitualmente para iniciar sesión en EFS.
Para la importación manual de archivos CSV : no se requieren credenciales de API. Solo necesita acceso al sitio de EFS para descargar los informes de transacciones.
Sus conductores han sido añadidos a Alvys con sus números de tarjeta de combustible EFS.
Cómo conectarse
Importación automática de API
La importación automática requiere credenciales que EFS genera específicamente para el acceso a la API. No se pueden utilizar su nombre de usuario y contraseña estándar de EFS.
Agregue a Alvys como socio para compartir datos en EFS. Descargue y siga las instrucciones para compartir datos en EFS (PDF) que encontrará en el artículo original de EFS en help.alvys.com . Este documento le guiará en el proceso para agregar a Alvys Inc. como socio para compartir datos en su cuenta de EFS.
Solicite las credenciales de la API al soporte de EFS. Después de agregar a Alvys como socio para compartir datos, envíe un correo electrónico al soporte de EFS a [email protected] para solicitar las credenciales de la API. Incluya lo siguiente en el cuerpo del correo electrónico, sustituyendo los datos de su empresa:
Nombre del cliente: el nombre de su empresa tal como está registrada en EFS.
Nombre de usuario: será creado por EFS.
Contraseña: será creada por EFS.
Identificador del operador: visible en su portal EFS eManager.
ID del contrato: pregunte a EFS si lo desconoce (se encuentra en Seleccionar programa > Gestión de crédito > Crédito disponible).
ID del contrato maestro: pregunte a EFS si lo desconoce.
Introduzca las credenciales de EFS en Alvys una vez que EFS responda:
Haz clic en tu nombre de usuario en la esquina inferior izquierda de Alvys y luego selecciona Administración .
Ve a la sección de Integraciones .
Desplácese hasta el menú desplegable Tarjetas de combustible y seleccione el botón “Inactivo” junto a EFS .
Esta imagen muestra el formulario de configuración de integración de EFS en Alvys con campos para nombre de usuario, contraseña, ID de contrato, ID de contrato maestro, ID de operador y selección de subsidiaria.
Importación manual de archivos CSV
La importación manual no requiere credenciales de API. Configure una entrada de integración independiente utilizando la opción CSV de EFS.
Haz clic en tu nombre de usuario en la esquina inferior izquierda de Alvys y luego selecciona Administración .
Ve a la sección de Integraciones .
Desplácese hasta el menú desplegable Tarjetas de combustible y seleccione EFSCSV .
Seleccione la filial con la que desea integrarse.
Haz clic en Guardar .
Esta imagen muestra la sección Integraciones en Alvys Management con la integración de EFSCSV.
💡 La ruta API automática y la ruta CSV manual de EFS son entradas de integración separadas y se pueden usar juntas.
Agregar números de tarjetas de combustible EFS a los perfiles de los conductores.
Esto se aplica tanto a las importaciones automáticas como a las manuales.
En la barra de herramientas azul de Alvys, seleccione Activos y, a continuación, elija Controladores .
Haz doble clic en un conductor de la lista para abrir su perfil.
Busque el campo "Números de tarjeta de combustible" junto al nombre del conductor y haga clic en el signo más.
Introduzca el número completo de la tarjeta de combustible, seleccione EFS como proveedor de la tarjeta de combustible y marque las casillas correspondientes para el descuento en el combustible o el combustible descontado, si fuera necesario.
Haz clic en Guardar .
Repita el procedimiento para cada conductor que tenga una tarjeta de combustible EFS.
Esta imagen muestra: un perfil de conductor en Alvys con el formulario "Agregar tarjeta de combustible" con los siguientes campos de entrada: Número de tarjeta, Deducir del propietario operador y Campo de proveedor con EFS seleccionado.
Importación manual únicamente: descargue y cargue el archivo de transacciones EFS.
Inicie sesión en el sitio web de EFS y descargue el informe de transacciones de combustible en formato Excel.
Al exportar, asegúrese de que estén seleccionadas las siguientes opciones: Mostrar número de tarjeta completo , Mostrar hora de la transacción y Mostrar importe del descuento .
Guarda el archivo en tu dispositivo. Alvys proporciona una plantilla que muestra el formato esperado (EFS Fuel template.xlsx); el enlace a la plantilla está disponible en la sección Informes de factoring de Alvys.
Desde la barra de herramientas de Alvys, vaya a Activos y seleccione Informe de combustible .
Esta imagen muestra la página del Informe de Combustible con el botón de Carga de Archivo de Transacción visible.
Haz clic en el icono de puntos suspensivos verticales (⋮) que aparece junto al botón “ Añadir transacción” .
Imagen que muestra el icono de puntos suspensivos junto al botón "Agregar transacción".
Seleccione la opción “ Importar informe ”.
Imagen que muestra la opción de importar informe.
En la ventana emergente, seleccione EFSCSV en el menú desplegable Tipo de integración .
Imagen que muestra el formulario "Subir informe de combustible" con el tipo de integración y los campos de entrada para agregar informes.
Sube el archivo CSV que descargaste del portal Compass.
Haz clic en el botón “Guardar”.
Una vez completada 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 EFS importa los datos de transacciones de combustible de EFS al Informe de Combustible de Alvys y, por separado, permite la emisión de cheques electrónicos.
Importación automática: Los datos de combustible se importan diariamente a la 1:00 a. m., extrayendo todas las transacciones de los últimos dos días desde que se configuró la integración. Las transacciones se asocian automáticamente a los camiones y conductores correspondientes en Alvys.
Importación manual: No existe sincronización automática. Debe descargar un archivo de transacciones del sitio web de EFS y subirlo a Alvys cada vez que necesite importar transacciones.
Coincidencia: Alvys asocia las transacciones de combustible con los perfiles de los conductores utilizando el número completo de la tarjeta de combustible EFS almacenado en el perfil del conductor. Cada conductor debe tener registrado su número de tarjeta EFS antes de que se puedan asociar las transacciones. El archivo CSV manual debe incluir el número completo de la tarjeta, la hora de la transacción y el importe del descuento.
⚠️ La importación automática solo extrae las transacciones de los últimos 2 días; utilice la importación manual de EFS CSV para completar los datos más antiguos.
Las credenciales de la API son generadas por EFS y no se pueden reutilizar desde otras integraciones ni desde el inicio de sesión estándar de su portal EFS.
La importación manual de archivos CSV requiere la exportación a Excel con formato EFS; no se admiten archivos personalizados ni con formato diferente.
Solución de problemas
Las transacciones de combustible no aparecen después de la importación automática.
Confirme lo siguiente: que aparezca la marca de verificación verde junto a la integración de EFS en Gestión, que el perfil del conductor contenga el número completo y correcto de la tarjeta de combustible EFS y que EFS esté seleccionado como proveedor. Si la integración se configuró recientemente, la primera importación se realizará a la 1:00 a. m. del día siguiente.
Las transacciones de combustible no aparecen después de una carga manual de CSV.
Verifique que el archivo exportado incluya las columnas " Mostrar número de tarjeta completo" , "Mostrar hora de transacción" y "Mostrar importe del descuento" . Si falta alguna de estas columnas, exporte el archivo nuevamente desde EFS con las tres opciones habilitadas y vuelva a cargarlo. Confirme que los conductores tengan el número de tarjeta EFS correcto en sus perfiles.
Las credenciales de EFS son rechazadas al guardar la integración.
Las credenciales que ingrese en el formulario de integración de Alvys deben ser las credenciales de API proporcionadas por el soporte de EFS ( [email protected] ). No puede usar sus credenciales de inicio de sesión habituales del portal de EFS. Si no dispone de credenciales de API, póngase en contacto con el soporte de EFS para solicitarlas.
Preguntas frecuentes
P: ¿Necesito tanto la integración automática como la manual de EFS?
R: No. Configure la integración automática de la API si desea importaciones diarias sin pasos manuales. Configure la integración manual de EFS CSV si prefiere controlar cuándo se importan las transacciones o si necesita completar datos históricos. Puede usar ambas si es necesario.
P: ¿Con qué frecuencia se ejecuta la importación automática?
R: La importación automática se ejecuta una vez al día a la 1 de la madrugada y extrae todas las transacciones de los últimos 2 días.
P: ¿Puedo usar mis credenciales de inicio de sesión habituales de EFS para la integración de la API?
R: No. El nombre de usuario y la contraseña para la integración de Alvys con EFS son credenciales de API que EFS genera específicamente para esta integración. Para solicitarlas, póngase en contacto con el soporte técnico de EFS en [email protected] .
P: ¿Qué sucede si se introduce incorrectamente el número de la tarjeta de combustible del conductor?
A: Si el número de tarjeta en Alvys no coincide con el número de tarjeta de la transacción importada, la transacción no se asociará a ese conductor. Corrija el número de tarjeta en el perfil del conductor y vuelva a importar o cargar los datos de la transacción.
P: ¿Para qué se utiliza el servicio de cheques electrónicos de EFS?
A: El servicio de cheques electrónicos de EFS le permite realizar pagos digitales a los conductores directamente desde Alvys. Se utiliza para gastos como anticipos a conductores, tarifas de carga y descarga y costos de reparación. La configuración de los cheques electrónicos se realiza por separado de la integración de importación de combustible.