Licencias

Las licencias llegan del RUNT junto con el conductor. No se crean ni se editan a mano.

Qué se guarda

Por cada licencia: número, categoría (B1, C2, …), fecha de expedición, fecha de vencimiento, fecha de vencimiento del examen y estado.

Y lo que el RUNT informe sobre el documento:

Dato	Cuándo aparece
Restricciones	Si el RUNT reporta alguna (por ejemplo, uso obligatorio de lentes)
Ventana de suspensión	Fecha de inicio y de fin, si la licencia está o estuvo suspendida
Fecha de cancelación	Si el documento fue cancelado
Número de resolución	El acto administrativo detrás de una suspensión o cancelación
Autoridad de tránsito	El organismo que lo emitió

Una persona puede tener varias categorías, cada una con su propia fecha de vencimiento. Se listan por separado, no se resumen en una sola.

Cada refrendación es un registro aparte

Cuando alguien refrenda su licencia, el RUNT no reemplaza el registro anterior: informa el historial completo, una entrada por refrendación. NotiAuto guarda ese historial tal cual.

Por eso una misma categoría puede aparecer varias veces:

Categoría	Expedida	Vence	Estado
B2	2015-05-06	2025-05-06	`INACTIVA`
B2	2018-05-05	2028-05-05	`INACTIVA`
B2	2021-05-05	2031-05-05	`INACTIVA`
B2	2024-05-07	2034-05-07	`ACTIVA`

No son registros duplicados ni un error de sincronización: son las cuatro veces que se refrendó esa categoría. El RUNT marca ACTIVA la que está en vigor y INACTIVA las anteriores, así que el estado es lo que distingue la vigente del historial.

Los conteos y las alertas usan únicamente la vigente. Las anteriores quedan como registro consultable.

Vigente no es lo mismo que activa

Esta distinción es la que causa más confusión, y decide si alguien puede conducir hoy:

Concepto	De dónde sale	Qué dice
Estado (`ACTIVA`)	Lo reporta el RUNT	Es la refrendación en vigor, no una anterior
Vigencia (`VIGENTE` / `VENCIDA`)	Lo calcula NotiAuto contra la fecha de hoy	La fecha de vencimiento no ha pasado
Suspensión	Fechas que reporta el RUNT	Hoy cae dentro de la ventana de suspensión
Cancelación	Fecha que reporta el RUNT	El documento fue cancelado

Una licencia puede estar ACTIVA y VENCIDA al mismo tiempo: es la refrendación en vigor, simplemente se le pasó la fecha. Esa persona no puede conducir.

Para que NotiAuto la cuente como utilizable hoy tienen que darse las cuatro condiciones: estado ACTIVA, fecha sin vencer, sin cancelación, y sin una suspensión que cubra la fecha de hoy. Eso es lo que responde has_active_license en un conductor. Ver Conductores.

Vencimientos

Las licencias disparan notificaciones de vencimiento y se pueden verificar con reglas de verificación, igual que el SOAT y la tecnomecánica.

En la API aparecen en GET /expirations, identificadas con su categoría — Licencia (B1) — y con el nombre del conductor en lugar de una placa.

El aviso de vencimiento se envía cuando la fecha cae dentro de los próximos 30 días. Una licencia que ya estaba vencida cuando se sincronizó por primera vez no genera aviso: aparece como vencida en el conductor, pero nadie recibe una notificación por ella.

Resincronizar

Cuando alguien renueva su licencia, el RUNT tarda en reflejarlo y NotiAuto solo ve lo que el RUNT le diga. Resincroniza el conductor para traer la fecha nueva. Ver Conductores.

Un conductor que hoy no tiene licencia y la obtenga más adelante no necesita nada manual: la sincronización periódica lo vuelve a consultar según tu plan y la licencia nueva entra sola.

La excepción es un conductor que el RUNT haya rechazado. Ese queda fuera de la sincronización periódica —no se lo vuelve a consultar cada noche— y hay que resincronizarlo a mano desde su ficha.

Desde la API

Tres formas de llegar a las licencias:

Quiero	Endpoint	Scope
Licencias de mis conductores	`GET /drivers`	`drivers.read`
Licencias por vencer	`GET /expirations`	`vehicles.read`
Licencias de cualquier persona, en vivo	`POST /consults/license`	`consults.license`