Ir al contenido

Vehículos

Un vehículo se identifica por placa. Para registrarlo necesitas la placa y el documento del propietario: el RUNT exige los dos.

Al crear un vehículo, NotiAuto consulta el RUNT en ese momento y guarda lo que responde:

Grupo Datos
Identificación Placa, marca, línea, modelo, color
Clasificación Clase de vehículo, tipo de servicio, estado
Números Serie, motor, chasis, VIN
SOAT Número, aseguradora, expedición, vencimiento, vigencia
Tecnomecánica Número de certificado, fecha de revisión, vencimiento, vigencia

Además puedes ponerle una descripción propia —“Camión de reparto”, “Camioneta de gerencia”— que es tuya y no viene del RUNT. Sirve para reconocerlo en los listados sin memorizar placas.

Formatos de placa válidos: ABC123, 123ABC y ABC12D. No distingue mayúsculas.

La consulta al RUNT tarda entre 30 y 60 segundos, así que el vehículo se guarda primero y se valida después. El formulario te acompaña un rato esperando el veredicto y, si tarda demasiado, te deja en el listado: la validación sigue en segundo plano.

Eso significa que un vehículo existe en tu cuenta antes de estar validado, y puede quedarse en cualquiera de estos estados:

Estado Qué significa Qué hacer
Verificando datos La consulta está en curso o en cola Esperar. Se resuelve solo
Validado El RUNT respondió y los datos están completos Nada
Rechazado El RUNT no reconoció la placa con ese documento Corregir el documento y guardar, o resincronizar
Verificando, con aviso Una sección del RUNT no respondió, así que la validación quedó abierta Nada urgente: la sincronización periódica lo reintenta

La ficha del vehículo muestra el estado con su explicación, y el botón para reintentar cuando corresponde.

Cada fila trae la placa, la descripción, los datos del vehículo, el estado del SOAT y de la tecnomecánica, y dos contadores de comparendos:

  • activos — los que no están pagados
  • totales — todos los del vehículo, históricos incluidos

is_valid en SOAT o tecnomecánica no es solo lo que dijo el RUNT: NotiAuto además compara la fecha de vencimiento contra hoy. Un SOAT que el RUNT marcó vigente pero cuya fecha ya pasó aparece como no válido.

Dos motivos para hacerlo:

  • Los datos cambiaron. Se renovó un SOAT, se pasó la tecnomecánica. Resincronizar vuelve a consultar el RUNT y actualiza las fechas.
  • El vehículo quedó rechazado. Es la forma de pedir otro intento cuando el RUNT estaba caído, o después de corregir el documento del propietario.

La consulta al RUNT se cachea 24 horas por identidad, así que resincronizar dos veces el mismo día devuelve lo mismo.

Resincronizar tiene su propio tope de ritmo —10 por hora, el mismo que los registros— porque cuesta una consulta al RUNT igual que un alta.

Tu plan define cuántos vehículos puedes tener registrados. Al llegar al tope, el panel no deja crear más hasta que subas de plan o borres alguno. Ver Planes y facturación.

El mismo vehículo puede estar registrado por más de una organización. Pasa con vehículos vendidos, o arrendados a varias empresas.

Cada organización ve su registro y nada de la otra: su descripción, sus asignaciones. Los datos del RUNT son los mismos porque el vehículo es el mismo.

Esto también tiene efecto en los comparendos. Ver Comparendos.

Quiero Endpoint
Listar mis vehículos GET /vehicles
Un vehículo por placa GET /vehicles/{plate}

La API es de lectura. Registrar vehículos se hace desde el panel.

GET /vehicles/{plate} devuelve 404 si la placa no está registrada en tu organización, aunque exista en el RUNT. Para datos de un vehículo que no es tuyo, usa POST /consults/vehicle.