> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alvys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KSK ELD — ELD / Integración telemática

> Conecte KSK ELD a Alvys para obtener ubicaciones de camiones en vivo y horas de servicio del conductor en el despacho, utilizando un token API de KSK para sincronización telemática unidireccional.

<Note>
  📋 **Se aplica a:** Admin · Partner Admin · Support · Operations Manager · Dispatcher

  **Módulo:** Management > Integrations

  **Proveedor:** KSK ELD · **Tipo de integración:** Unidireccional · **Dirección:** Ubicación y HOS los datos fluyen desde KSK ELD hacia Alvys

  KSK ELD es un proveedor de telemática que conecta con Alvys para incorporar el estado del camión locations y las horas de servicio (HOS) en tiempo real a su flujo de trabajo de despacho. Esta integración también se conoce como KSK ELD, dispositivo de registro electrónico o flota tracking.
</Note>

## Qué hace esta integración

conectar KSK ELD a Alvys le permite a su equipo de despacho ver el camión actual locations y el conductor HOS los relojes de tiempo restantes sin salir de Alvys.

El kilometraje del remolque tracking y IFTA no está supported por KSK ELD. Solo el camión assets con dispositivos KSK ELD aparecerá en tracking.

## Requisitos previos

Antes de conectar, confirma que tienes lo siguiente:

* Una cuenta active KSK ELD con acceso API
* Tu KSK ELD API key
* El papel Admin, Partner Admin o Support en Alvys

## Cómo conectar

### Paso 1: Genera un token API en KSK ELD

1. Inicie sesión en su cuenta KSK ELD.
2. Vaya a **Management > API Tokens**.
3. Haga clic en **Generate Token**.
4. Ingrese **"Alvys Integración"** como nombre del token y haga clic en **Aceptar**.
5. Copia la ficha. Lo necesitarás en el paso next.

### Paso 2: Conectar KSK ELD en Alvys

1. Haga clic en el ícono de su perfil en la esquina inferior izquierda de Alvys para abrir **Company Profile**.
2. Seleccione la filial que desea configurar y haga clic en la pestaña **Integrations**.
3. Expanda la sección **ELD** y haga clic en el ícono pencil en la tarjeta KSK ELD.
4. Ingrese su token KSK ELD API y haga clic en **Save**.
5. Alvys validará tus credenciales. Una vez confirmado, el estado de integración cambia a active.

Después de conectar, los siguientes datos se extraen de KSK ELD a Alvys:

* **Ubicación del camión:** Coordenadas GPS actuales para cada camión con un dispositivo KSK ELD
* **HOS relojes:** Valores de tiempo restante para los límites HOS de cada conductor: estos son relojes de cuenta regresiva que muestran el tiempo restante

También se obtienen datos adicionales de detail, como lecturas del odómetro y niveles de combustible, cuando el identificador del dispositivo es un valor numérico. Si el dispositivo utiliza un identificador no numérico, se seguirán mostrando la ubicación básica y los datos HOS; Sólo es posible que no aparezcan los detail fields adicionales (odómetro, combustible).

## Asignar activos en Alvys

Después de connect, vincule cada camión o remolque en Alvys a su KSK ELD asset ID para que los datos de ubicación fluyan correctamente.

1. Vaya a **Assets** en el menú de la izquierda y seleccione **camiones** o **Trailers**.
2. Haga doble clic en el activo que desea configurar.
3. Desplácese hacia abajo hasta la sección **ELD Integrations** y haga clic en **Add Integration**.
4. Seleccione **KSK ELD** en el menú desplegable.
5. Encuentre su KSK ELD asset ID en la URL cuando vea ese activo en su cuenta KSK ELD. Por ejemplo, si la URL es [app.kskeld.com/client/vehicle/25236](http://app.kskeld.com/client/vehicle/25236), el ID es **25236**.
6. Ingrese asset ID en **Integration ID** field y haga clic en **Save**.

Repita para cada camión o remolque que desee track.

## Mapa conductor en Alvys

Para ver las horas de servicio del conductor en cargas y el Planificador de despacho, vincule cada conductor a su ID de conductor KSK ELD.

1. Vaya a **Assets** en el menú de la izquierda y seleccione **conductor**.
2. Haga doble clic en el controlador que desea configurar.
3. Busque la sección **ELD Providers** y haga clic en **Add ELD**.
4. Seleccione **KSK** en el menú desplegable.
5. Encuentre su ID de controlador KSK ELD en la URL cuando edi introduzca ese controlador en su cuenta KSK ELD. Por ejemplo, si la URL es [app.kskeld.com/client/conductor/25236/details](http://app.kskeld.com/client/conductor/25236/details), el ID del controlador es **25236**.
6. Ingrese la identificación del conductor en **Integration ID** field y haga clic en **Save**.

Repita para cada conductor que utilice KSK ELD para sus Horas de servicio.

## Qué se sincroniza

Alvys solicita datos actualizados de KSK ELD periódicamente. Los relojes del camión locations y HOS reflejan los valores más recientes informados por el dispositivo.

* **Ubicación del camión:** Coordenadas GPS actuales para cada camión con un dispositivo KSK ELD.
* **HOS relojes:** Valores de cuenta regresiva del tiempo restante para los límites HOS de cada conductor.
* **Odómetro y nivel de combustible:** Se extrae solo para dispositivos con identificadores numéricos.

Para confirmar que la integración está funcionando, vaya a **Cargas**, abra una carga que tenga un conductor y un camión asignados y busque la ubicación del camión en el mapa o en la sección de activos tracking. Si la integración es active y el camión tiene un dispositivo KSK ELD, la ubicación actual debería ser visible. Los valores de tiempo restante HOS deben aparecer next junto al nombre del conductor o en el panel del detail del conductor.

## Solución de problemas

### La ubicación del camión no se muestra.

Confirme que el camión tenga un dispositivo KSK ELD instalado y encendido. Verifique que el API key en Alvys coincida con el proporcionado por KSK ELD; vaya a Management > Integrations y vuelva a ingresar la clave si es necesario. Verifique que el estado de integración se muestre como active.

### HOS los relojes están en blanco

Confirme que el conductor haya iniciado sesión en el dispositivo KSK ELD para su turno actual. Verifique que el dispositivo esté transmitiendo actively a los servidores de KSK ELD.

### El odómetro o el nivel de combustible no muestra

KSK ELD devuelve datos adicionales de detail (odómetro, nivel de combustible) solo para dispositivos con identificadores numéricos. Si el dispositivo utiliza un formato de identificador no numérico, este detail no se mostrará. La ubicación básica y los datos HOS seguirán estando disponibles.

<Warning>
  ⚠️ El tráiler tracking no está supported, solo camiones. · Los informes de kilometraje IFTA no están disponibles a través de KSK ELD. · Es posible que el odómetro y el nivel de combustible detail no se muestren en dispositivos con identificadores no numéricos.
</Warning>

## Preguntas frecuentes

**P: ¿Puedo track trailers con KSK ELD?**

**R:** No. KSK ELD no devuelve datos del avance. Solo los camiones assets pasan support a través de esta integración.

**P: ¿Por qué no se muestran los datos del odómetro de uno de mis camiones?**

**R:** Los datos del odómetro y del nivel de combustible detail están disponibles solo para dispositivos con identificadores numéricos. Si el dispositivo de un camión específico utiliza una identificación no numérica, no se mostrarán los cinco ceros adicionales. La ubicación básica y los datos HOS seguirán apareciendo para ese camión.

**P: ¿Hay IFTA millas disponibles?**

**R:** No. El millaje IFTA no está support completado por KSK ELD y no está disponible en Alvys a través de esta integración.

## Profundizar

* [Configuración ELD / Telemática Integrations](https://help.alvys.com/en/articles/9857524-setting-up-eld-telemática-integrations)
