Consultas RUNT
Las pantallas de Consultas sirven para mirar datos del RUNT sin registrar nada. Útil antes de comprar un vehículo, o antes de contratar a un conductor.
Tres consultas:
| Consulta | Entrada | Devuelve |
|---|---|---|
| Vehículo | Placa + documento del propietario | Datos del vehículo, SOAT, tecnomecánica |
| Licencias | Tipo, número de documento y primer apellido | Licencias con categorías y vencimientos |
| Accidentalidad | Documento | Historial de accidentalidad |
Cada una requiere su permiso: consults.vehicle, consults.license,
consults.accident. Ver Usuarios y roles.
Consultar no es registrar
Sección titulada «Consultar no es registrar»Una consulta solo muestra. No agrega el vehículo ni el conductor a tu organización, no dispara notificaciones y no entra al seguimiento de vencimientos.
Para que NotiAuto vigile un vehículo, hay que registrarlo. Ver Vehículos.
El caché de 24 horas
Sección titulada «El caché de 24 horas»Cada consulta se cachea 24 horas por identidad —la combinación de placa y documento, o de tipo, número de documento y primer apellido—. Repetir la misma consulta el mismo día responde del caché sin volver al RUNT: es instantáneo.
Si sabes que algo cambió, hay una opción para forzar la consulta nueva.
El detalle completo, incluido qué pasa cuando el RUNT falla a medias, está en Consultas RUNT y caché. Aplica igual al panel y a la API.
Qué consume una consulta
Sección titulada «Qué consume una consulta»Tu plan incluye un cupo anual de consultas: 120 en Individual, 500 en PyME, 1.500 en PyME Pro. Cada consulta desde estas pantallas descuenta una.
Cuando el cupo anual se agota, las consultas empiezan a descontar del saldo prepago. Sin saldo, la pantalla pide recargar. Ver Planes y facturación.
Registrar un vehículo o un conductor no consume cupo. Esa consulta al RUNT ya la pagó tu plan, igual que la sincronización automática. Lo que descuenta es consultar ad hoc desde estas pantallas.
Topes de ritmo
Sección titulada «Topes de ritmo»Además del cupo anual hay un tope diario —10 consultas al día en Individual y PyME, 25 en PyME Pro— y un ritmo de 30 por hora. Los registros de vehículos y conductores tienen el suyo aparte, de 10 por hora.
El tope diario es protección contra un uso automatizado, no un límite pensado para el uso normal: nadie que use el panel a mano se acerca.
Cuando el RUNT no responde
Sección titulada «Cuando el RUNT no responde»Un fallo del RUNT nunca se cachea, así que reintentar más tarde puede funcionar. Si una consulta falla de forma consistente, el problema es del RUNT y no de tus datos.
Los mensajes dicen qué pasó sin pedirte nada imposible: si el RUNT no contestó, la pantalla te dice que lo intentes en unos minutos. No hay nada que corregir de tu lado.
Desde la API
Sección titulada «Desde la API»Las consultas de vehículo y de licencia están expuestas:
POST /consults/vehicle y
POST /consults/license.
La consulta de accidentalidad solo existe en el panel; no tiene endpoint publicado.