Referencia
Errores
El texto de message
puede cambiar sin aviso; code
no. Ramifique siempre por el código.
Reintente solo estos
El resto no cambia por volver a llamar.
Solo uno descuenta
vehiculo_no_encontrado se cobra porque el
Registro sí respondió y la consulta gastó un cupo real. Todos los demás dejan
cobrada: false.
401
credencial_invalida
La clave no es válida
- Cuándo
- No se envió el encabezado X-API-Key, o la clave no existe.
- Qué hacer
- Revise que la clave viaje en X-API-Key y que la copió completa, con su prefijo rnp_.
403
credencial_revocada
La clave fue revocada o expiró
- Cuándo
- La clave existe pero ya no sirve: se revocó, se desactivó o venció.
- Qué hacer
- Genere una clave nueva desde su portal, en Credenciales.
403
cuenta_suspendida
La cuenta está desactivada
- Cuándo
- La clave es válida pero la cuenta a la que pertenece está suspendida.
- Qué hacer
- Escríbanos: no se resuelve generando otra clave.
402
prueba_finalizada
Se acabaron las consultas de prueba
- Cuándo
- Consumió las consultas gratuitas del periodo de prueba.
- Qué hacer
- Elija un plan o compre una recarga desde su portal.
402
saldo_agotado
Sin saldo
- Cuándo
- La cuota del plan se agotó y no quedan créditos prepago.
- Qué hacer
- Recargue o espere a que el plan renueve. La respuesta trae recarga_url.
404
vehiculo_no_encontrado
descuenta
No hay vehículo con ese identificador
- Cuándo
- El Registro respondió correctamente y no tiene nada inscrito con esa placa o ese VIN.
- Qué hacer
- Verifique el identificador y la clase. Este es el único error que descuenta: la consulta se hizo y gastó un cupo real.
429
limite_excedido
reintentable
Demasiadas consultas por minuto
- Cuándo
- Superó el límite por minuto de su plan.
- Qué hacer
- Espere los segundos que indica reintentar_en y vuelva a intentar.
502
origen_no_disponible
reintentable
El Registro Nacional no responde
- Cuándo
- El Registro está caído, rechazó la consulta o cambió su estructura.
- Qué hacer
- Reintente más tarde. Es el error a esperar cuando el Registro tiene problemas.
503
sin_capacidad
reintentable
Sin capacidad momentánea
- Cuándo
- Todas nuestras conexiones con el Registro están ocupadas, o el servicio se pausó por degradación.
- Qué hacer
- Reintente en un minuto.
504
tiempo_agotado
reintentable
El Registro tardó demasiado
- Cuándo
- El Registro no respondió dentro del tiempo permitido.
- Qué hacer
- Reintente. El Registro suele tardar entre 3 y 10 segundos.