Avalúo Comercial
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/ws/avaluo
📦 Estructura JSON
{
"placa":"ABC123",
"kilometrajeActual":"10000"
}
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 |
| kilometrajeActual | String | Campo que indica el kilometraje actual del vehículo a consultar |
🧾 Respuesta
✅ Ejemplo de respuesta (200 OK)
{
"precioVentas": 123000000,
"precioCompras": 123000000,
"precioSegunKilometraje": 200000,
"precioUtilidad": 123000000,
}
Estructura JSON de Respuesta
En todos los casos exitosos, se retorna una estructura JSON con los siguientes atributos:
| Atributo | Tipo | Descripción |
|---|---|---|
| precioVentas | Long | Campo que indica el precio calculado para la venta |
| precioCompras | Int | Campo que indica el precio calculado para la compra |
| precioSegunKilometraje | Int | Campo que indica el precio calculado según el kilometraje dado |
| precioUtilidad | Int | Campo que indica el precio calculado según el kilometraje dado |
Existe otra estructura de respuesta con el siguiente atributo:
{
"message": "No fue posible obtener el precio de
referencia debido a su modelo y características
del vehículo"
}
| Atributo | Tipo | Descripción |
|---|---|---|
| message | String | Campo que indica un mensaje indicando que para la placa consultada "No fue posible obtener el precio de referencia debido a su modelo y características del vehículo" |
❌ Ejemplo de respuesta de error
En caso de que exista un error en el servicio se devuelve un Json Object
{
"statusCode": 400,
"error": "'precioVentas' no encontrado en el body de la petición o es vacio"
}
Estructura JSON Response Error
| Atributo | Tipo | Descripción |
|---|---|---|
| statusCode | String | Campo que indica el código de estado de respuesta HTTP |
| error | String | Campo que indica el mensaje con detalle del error ocurrido |