Se aplica a: Administración · Administración de socios · Administración de oficina
Módulo: Gestión > Integraciones > Combustible
Proveedor: TCS (Transportation Clearinghouse Solutions) · Tipo de integración: Unidireccional · Dirección de sincronización: Carga manual de archivos CSV desde TCS a Alvys
Última revisión: junio de 2026 · Propietario: Equipo de soporte
La integración de combustible de TCS le permite importar datos de transacciones de tarjetas de combustible de Transportation Clearinghouse Solutions a Alvys mediante la carga manual de archivos CSV: utilícela para realizar un seguimiento de los gastos de combustible y aplicar deducciones a las liquidaciones de los conductores.
Descripción general
La integración de combustible de TCS (Transportation Clearinghouse Solutions, importación de tarjetas de combustible de TCS, carga manual de CSV) conecta los datos de las tarjetas de combustible de TCS con Alvys. Este es un proceso de importación manual: se descarga un archivo CSV de transacciones desde el sistema TCS y se carga en Alvys. Alvys asocia cada transacción con el conductor correspondiente utilizando los últimos 4 dígitos del 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 TCS a Alvys.
Requisitos previos
Antes de configurar esta integración, confirme lo siguiente:
En Alvys tienes acceso para gestionar las integraciones.
Usted dispone de las credenciales de acceso a su sistema TCS.
Sus filiales ya están configuradas en Alvys.
Si necesita ayuda para localizar el informe de descarga de transacciones en TCS, póngase en contacto con su representante de ventas de TCS.
Cómo conectarse
Haz clic en tu nombre de usuario en la esquina inferior izquierda de Alvys y luego selecciona Administración ( https://app.alvys.com/#/manage/integrations ) .
Ve a la sección de Integraciones .
Desplácese hasta el menú desplegable Tarjetas de combustible y seleccione el botón “ Inactivo” junto a TCS .
Tarjeta de integración de TCS con el botón “ Inactivo ” resaltado.
Tarjeta de integración de TCS con el botón “ Inactivo ” resaltado.
Elija la filial que debería utilizar TCS .
Haz clic en el botón azul “ Guardar” .
💡 No se requieren credenciales de API para la integración con TCS. Al habilitar la integración, TCS 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 guardados en su perfil los últimos 4 dígitos de su número de tarjeta de combustible TCS:
Desde la barra de herramientas de Alvys, vaya a Activos y seleccione Controladores .
Busca un conductor y haz doble clic para abrir su perfil.
En la primera sección, haga clic en el signo más junto a Números de tarjeta de combustible .
Esta imagen muestra la sección de Números de Tarjeta de Combustible del perfil de un conductor con el signo más resaltado.
Esta imagen muestra la sección de Números de Tarjeta de Combustible del perfil de un conductor con el signo más resaltado.
Introduzca únicamente los últimos 4 dígitos del número de la tarjeta de combustible TCS de este conductor.
Esta imagen muestra el campo para introducir el número de la tarjeta de combustible con un número de 4 dígitos introducido.
Esta imagen muestra el campo para introducir el número de la tarjeta de combustible con un número de 4 dígitos introducido.
Seleccione TCS en el menú desplegable Proveedor.
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 TCS.
Para descargar las transacciones de combustible de TCS:
Inicie sesión en su sistema TCS.
Navegue a Informes .
Desplácese hacia abajo hasta Descargar transacciones .
Seleccione el período de tiempo a la derecha.
Descargue el archivo en su dispositivo como un archivo CSV. Si no encuentra el informe de descarga de transacciones, comuníquese con su representante de ventas de TCS para obtener ayuda.
Para subir el archivo a Alvys (confirme primero que se hayan guardado los últimos 4 dígitos de la tarjeta de combustible de cada conductor):
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 de TCS.
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 TCS es una sincronización manual y unidireccional desde TCS a Alvys. Después de cargar un archivo CSV de TCS, Alvys asigna los datos de las transacciones de la siguiente manera:
Los últimos 4 dígitos del número de la tarjeta de combustible en el archivo CSV se comparan con los últimos 4 dígitos almacenados en el perfil de cada conductor. Las transacciones se atribuyen al conductor cuyo número de tarjeta 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 una transacción no coincide con ningún perfil de 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 automáticamente las transacciones duplicadas y no las importa. Volver a subir el mismo archivo es seguro.
Esta integración no cuenta con sincronización automática ni programada.
Solo se utilizan los últimos 4 dígitos porque los datos de la tarjeta de combustible TCS en los informes de transacciones utilizan únicamente los últimos 4 dígitos como identificador.
⚠️ Esta integración no admite importaciones automáticas ni programadas.
Introducir el número completo de la tarjeta impedirá que se realice la coincidencia correcta.
Alvys no escribe datos de vuelta a TCS.
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 TCS en Números de tarjeta de combustible. Solo debe introducir los últimos 4 dígitos.
Verifique que el número de tarjeta de 4 dígitos coincida con los últimos 4 dígitos de la exportación CSV de TCS. Alvys verifica que coincida exactamente con los dígitos almacenados en el perfil.
Vuelva a cargar el archivo CSV después de corregir el número de tarjeta. Alvys no reimportará una transacción que ya tenga registrada por ID, por lo que si la carga original no coincidió, corregir el número de tarjeta y volver a cargarlo resolverá el problema de coincidencia para futuras transacciones.
Si aún faltan transacciones, póngase en contacto con el servicio de asistencia de Alvys.
La carga falla o devuelve un error.
Confirme que ha seleccionado TCS (y no otro proveedor) en el menú desplegable Tipo de integración antes de cargar el archivo.
Confirme que el archivo sea el CSV de descarga de transacciones de los informes de TCS. 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: ¿Por qué solo debo ingresar los últimos 4 dígitos del número de la tarjeta de combustible?
A: Los datos de la tarjeta de combustible TCS en los informes de transacciones utilizan únicamente los últimos 4 dígitos como identificador. Introducir el número completo de la tarjeta impedirá la correcta coincidencia.
P: ¿La integración con TCS es automática o manual?
R: La integración con TCS es manual. Debes descargar los archivos CSV de los informes de TCS y subirlos a Alvys periódicamente.
P: ¿Qué sucede si subo las mismas transacciones dos veces?
R: Alvys detecta automáticamente las transacciones duplicadas 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 sus necesidades de informes y liquidación. Muchos equipos suben datos semanal o mensualmente para mantener actualizados los datos de combustible.
P: ¿Qué sucede si las transacciones de un conductor no aparecen después de subirlas?
A: Confirme que el conductor tenga los últimos 4 dígitos correctos de su número de tarjeta de combustible TCS guardados en su perfil en Activos > Conductores. Si el número falta o es incorrecto, agréguelo o corríjalo. De esta manera, las futuras cargas coincidirán correctamente.