📋 Aplicable 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 desde TCS hacia 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
En Alvys, vaya a Gestión y seleccione la filial que desea integrar con TCS.
Haz clic en el botón azul " Integrar ".
En la ventana emergente, haga clic en el menú desplegable Tipo de integración y desplácese hacia abajo para encontrar TCS .
Seleccione TCS y, a continuación, 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 .
<image source="5584"></image>
Introduzca únicamente los últimos 4 dígitos del número de la tarjeta de combustible TCS de este conductor.
<image source="4ba4"></image>
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 Informes y seleccione Informe de combustible .
Haga clic en el botón azul "Cargar archivo de transacción" .
<image source="3734"></image>
En la ventana emergente, seleccione TCS en el menú desplegable Tipo de integración .
<image source="c4fb"></image>
Haz clic en el botón azul para buscar tu archivo CSV de TCS o arrástralo y suéltalo en la ventana.
Sube el archivo.
Una vez finalizada la carga, seleccione un 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á la correcta coincidencia. · Alvys no envía datos 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 cargar el archivo 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.