Valor Vehicular

Para consumir el servicio REST, es necesario hacer un llamado POST, usando una autenticación básica en los “headers" con el usuario y la contraseña proporcionados.

🔗 Endpoints disponibles

POSThttp://localhost:8081/app/servicioValorVehicular

📦 Estructura JSON

{
	"placa": "ABC123",
	"tipoDocumento": "cc",
	"numeroDocumento": "1234567891"
}

Estructura JSON de Envío

La solicitud al servicio debe enviarse en formato JSON, con los siguientes atributos:

Atributo	Tipo	Descripción
placa	String	Campo que indica la placa del vehículo a consultar.
tipoDocumento	String	Campo que indica el tipo de documento a consultar. Ejemplo: Cédula, NIT, etc.
numeroDocumento	String	Campo que indica Número del documento de identidad a consultar.

Tipos de documentos permitidos

El campo tipoDocumento debe enviarse como uno de los siguientes códigos:

Código	Descripción
cc	Cédula de ciudadanía
ce	Cédula de extranjería
cd	Carnet diplomático
nit	Número de Identificación Tributaria
ti	Tarjeta de identidad
pa	Pasaporte
ppt	Permiso por protección temporal
rc	Registro civil

🧾 Respuesta

✅ Ejemplo de respuesta (200 OK)

{
  "idConsulta": "65a84036ae9f105d9bcd5c71",
  "dato": "ABC123",
  "datosBasicos": { ... },
  "rtms": { ... },
  "soat": { ... },
  "precioPromedio": "80400000",
  "presentaAdvertencia": false,
  "presentaRiesgo": false
}

Estructura JSON de Respuesta

En todos los casos exitosos, se retorna una estructura JSON con los siguientes atributos:

Atributo	Tipo	Descripción
idConsulta	String	Campo que indica el id de la consulta.
dato	String	Campo que indica el dato del vehículo consultado
datosBasicos	JSONObject	Campo que indica los datos básicos del vehículo.
rtms	JSONObject	Campo que indica la revision técnico mecánica mas reciente del vehículo.
soat	JSONObject	Campo que indica el soat mas reciente del vehículo.
precioPromedio	String	Campo que indica el precio promedio del vehículo.
presentaAdvertencia	Boolean	Campo que devuelve true si el soat o el rtms vencen en menos de 3 meses
presentaRiesgo	Boolean	Campo que devuelve true si el soat o el rtms no están vigentes

❌ Ejemplo de respuesta (401 UNAUTHORIZED)

"La empresa no tiene permisos para consumir este servicio"

❌ Ejemplo de respuesta (500 INTERNAL SERVER ERROR)

 "Ha ocurrido un error interno, contacte con el administrador"