Tacógrafo
Información de tacógrafo
Los AVT110T/AVT111T pueden leer de forma remota archivos DDD del tacógrafo digital y de la tarjeta del conductor como parte del sistema telemétrico. Normalmente, para leer archivos del tacógrafo es necesario insertar la tarjeta de empresa directamente en el tacógrafo del vehículo y descargar los archivos requeridos con una herramienta específica. El problema surge cuando los vehículos están lejos en el extranjero pero la tarjeta de empresa está en la oficina central.
Los datos entre el tacógrafo y la tarjeta de empresa se intercambian a través de Internet utilizando la estructura existente del sistema telemétrico.
Secuencia de referencia para la integración del tacógrafo AVT110T/AVT111T mediante el TCA. El flujo cubre el handshake de la aplicación, la recogida de operaciones en cola, la autorización APDU con tarjeta de empresa y la subida del archivo DDD al servidor.
Participantes
| Actor | Función |
|---|---|
| Tachograph Card Authorizer | Aplicación de escritorio (v1.3.9) que gestiona la autorización de tarjeta y retransmite paquetes APDU. |
| HTTP Server | Puente API REST entre el autorizador y el backend del tacógrafo. |
| TCP Server | Capa de transporte entre el servidor HTTP y el terminal AVT110. |
| Terminal (AVT110) | Dispositivo a bordo que intercambia comandos AT@TCO y eventos +RPT/+LDP con el tacógrafo. |
Resumen del flujo
Fase 1 — Handshake de la aplicaciónEl Card Authorizer comprueba la última versión de la aplicación e inicia sesión antes de cualquier operación de tacógrafo.
GET /api/tachograph/v1/tachoappinfo?current_version=1.3.9POST /account/zaloguj (usuario/contraseña)
Fase 2 — Cola y inicio de operaciónEl autorizador consulta tareas en cola en dispositivos en línea y luego inicia y supervisa la solicitud de tacógrafo.
GET /api/tachograph/v1/queue?limit=1&status=queued&online=trueGET /api/tachograph/v1/requests/{id}POST /api/tachograph/v1/requests/{id} — iniciar autorización
Fase 3 — Autorización APDU con tarjetaEl terminal intercambia comandos AT@TCO y eventos +RPT mientras el servidor HTTP retransmite paquetes APDU entre el dispositivo y el Card Authorizer hasta completar la autorización.
Terminal envía comandos AT@TCO=at,1,... con seqnum+RPT Event Type(25) — eventos de solicitud/respuesta APDUPOST /api/tachograph/v1/apdu/{device} — respuesta de tarjeta de empresaPOST /api/tachograph/v1/apdu/{device}/commit y /dequeueGET /api/tachograph/v1/apdu/{device}/status — estado de autorización
Fase 4 — Subida del archivo DDDTras la autorización, el terminal sube el archivo DDD en tramas LDP e informa del progreso mediante eventos +RPT.
+RPT Event Type(26), state(01) — inicio de subidaMensajes +LDP — tramas 1..N al servidor+RPT Event Type(26), state(02) — subida correcta
Endpoints de la API
El diagrama usa URLs de ejemplo en http://127.0.0.1:8080. Sustituya el host por su endpoint de API de tacógrafo en producción.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/tachograph/v1/tachoappinfo | Comprobar la última versión de la aplicación de tacógrafo |
| POST | /account/zaloguj | Autenticar la sesión del autorizador de tarjeta |
| GET | /api/tachograph/v1/queue | Obtener operaciones de tacógrafo en cola para dispositivos en línea |
| GET | /api/tachograph/v1/requests/{id} | Leer el estado y progreso de la operación |
| POST | /api/tachograph/v1/requests/{id} | Iniciar la autorización de la operación |
| GET | /api/tachograph/v1/apdu/{device}/status | Obtener el estado actual de la operación APDU |
| POST | /api/tachograph/v1/apdu/{device} | Enviar la respuesta APDU de la tarjeta de empresa |
| POST | /api/tachograph/v1/apdu/{device}/commit | Confirmar el paquete APDU procesado |
| POST | /api/tachograph/v1/apdu/{device}/dequeue | Sacar de cola el siguiente paquete APDU de la sesión |
Diagrama de secuencia
El diagrama de secuencia siguiente documenta el intercambio completo de mensajes entre el Card Authorizer, los servidores HTTP/TCP y el terminal AVT110. Las etiquetas de pasos y cargas técnicas del diagrama están en inglés.
