Conductores

Un conductor se identifica por documento. Al registrarlo, NotiAuto consulta el RUNT y trae sus datos y sus licencias.

Registrar

Necesitas el tipo de documento, el número y el primer apellido tal como aparece en el documento. Códigos válidos para personas:

Código	Documento
C	Cédula de ciudadanía
E	Cédula de extranjería
P	Pasaporte
T	Tarjeta de identidad
U	Registro civil
D	Carnet diplomático
Y	Permiso por Protección Temporal

El NIT (N) no aplica: un conductor es una persona.

El documento debe ser numérico, de 6 a 10 dígitos.

El RUNT devuelve nombres y apellidos, estado del conductor, estado de la persona, número de inscripción, y todas sus licencias con categoría, fechas de expedición y vencimiento, y estado.

Como con los vehículos, puedes agregar una descripción propia para reconocerlo en los listados.

El conductor se guarda antes de validarse, igual que los vehículos, y pasa por los mismos cuatro estados —verificando, validado, rechazado, y verificando con aviso—. Ver los cuatro estados de la validación.

Un conductor rechazado queda en tu cuenta con ese estado y fuera de la sincronización nocturna: solo lo reintenta un resincronizado a mano.

Nota

Un conductor sin licencias no es un rechazo. Que el RUNT lo reconozca pero no le encuentre licencias es una respuesta válida, y el conductor queda validado con la lista vacía. Si más adelante obtiene una, la sincronización periódica la trae sola.

El listado

Cada conductor muestra su nombre, documento, estado, sus licencias, y los contadores de comparendos activos y totales.

El campo que más se usa es has_active_license: es verdadero solo si el conductor tiene al menos una licencia que cumple las cuatro condiciones:

1. el RUNT la reporta como ACTIVA,
2. su fecha de vencimiento no ha pasado,
3. no tiene fecha de cancelación, y
4. no hay una suspensión que cubra la fecha de hoy.

Una licencia ACTIVA pero vencida no cuenta, y tampoco una vigente que esté suspendida. Ver Licencias.

Licencias

Las licencias no se registran a mano: llegan del RUNT junto con el conductor. Una persona puede tener varias categorías —B1, C2— y cada una tiene su propia fecha de vencimiento.

Ver Licencias para el detalle.

Resincronizar

Igual que los vehículos, y por los mismos dos motivos: cuando alguien renueve o refrende su licencia, y para pedir otro intento sobre un conductor que quedó rechazado. Ver Resincronizar.

Límite del plan

Tu plan define cuántos conductores puedes registrar. Ver Planes y facturación.

Desde la API

GET /drivers con el scope drivers.read. Devuelve el listado paginado con las licencias de cada conductor incluidas, así que no necesitas una segunda llamada.

Para consultar las licencias de una persona que no está registrada en tu organización, usa POST /consults/license.