Tiene Siniestros

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/webServiceTieneSiniestros

🧩 Tipos de consulta

El servicio maneja dos tipos, controladas por el atributo plus del body:

Tipo	plus	Qué agrega
Tiene Siniestros	false u omitido	Fuentes de siniestro. Si además se envía el documento del propietario (tipoDocumento y numeroDocumento), se consulta el RUNT Público y se retornan datosBasicos y datosTecnicos del vehículo.
Tiene Siniestros PLUS	true	Fuentes de siniestro más runtVehicular (histórico de propietarios y datos básicos) y presentaSalvamento. En esta modalidad tipoDocumento y numeroDocumento se ignoran.

📦 Estructura JSON

{
  "placa": "ABC123",
  "plus": false,
  "tipoDocumento": "cc",
  "numeroDocumento": "39430590"
}

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.
plus	Boolean	(Opcional) Campo que indica si la consulta será Tiene Siniestros PLUS. Por defecto su valor es false. También se acepta como PLUS.
tipoDocumento	String	(Opcional) Tipo de documento del propietario actual del vehículo. Solo aplica cuando plus es false; se ignora en la modalidad PLUS. Debe enviarse junto con numeroDocumento.
numeroDocumento	String	(Opcional) Número de documento del propietario actual del vehículo. Mismas condiciones que tipoDocumento.

Si no se envían tipoDocumento/numeroDocumento, o el RUNT Público no logra validar al propietario con los datos enviados, la consulta se completa igual y los campos datosBasicos/datosTecnicos de la respuesta se retornan en null.

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	NIT
ti	Tarjeta de identidad
pa	Pasaporte
ppt	Permiso por protección temporal
rc	Registro civil

🧾 Respuesta

✅ Ejemplo de respuesta (200 OK)

{
  "idConsulta": "68379a048856964b3cacff5c",
  "tieneSiniestros": true,
  "presentaSalvamento": false,
  "dato": "JYW806",
  "runtVehicular": null,
  "datosBasicos": {
    "marca": "NISSAN",
    "linea": "X-TRAIL T32",
    "modelo": "2019",
    "color": "BLANCO PERLADO"
  },
  "datosTecnicos": {
    "pesoBrutoVehicular": "1910 Kgs",
    "noEjes": "2"
  },
  "imagenVehiculo": "https://certificar.s3.us-east-1.amazonaws.com/imagenesVehiculos/JYW806.png",
  "fasecoldaService": {
    "lista": "FasecoldaService",
    "tipo": "listasNacionales",
    "presentaRiesgo": true,
    "presentaAdvertencia": false,
    "Resultado": []
  },
  "costoSiniestroService": {
    "lista": "CostoSiniestroService",
    "tipo": "listasNacionales",
    "presentaRiesgo": false,
    "presentaAdvertencia": true,
    "Resultado": []
  },
  "costoSiniestroMapfreService": {
    "lista": "CostoSiniestroMapfreService",
    "tipo": "listasNacionales",
    "presentaRiesgo": false,
    "presentaAdvertencia": false,
    "Resultado": []
  },
  "polizasVehiculosService": {
    "lista": "PolizasVehiculosService",
    "tipo": "listasNacionales",
    "presentaRiesgo": false,
    "Resultado": []
  }
}

Estructura JSON de Respuesta

En todos los casos exitosos, se retorna una estructura JSON con los siguientes atributos. Todos los campos viajan siempre en la respuesta; los que no apliquen según la modalidad o los datos disponibles se retornan en null:

Atributo	Tipo	Descripción
idConsulta	String	Campo que indica el id de la consulta.
tieneSiniestros	Boolean	Campo que indica si alguna fuente de siniestro reportó riesgo o advertencia.
presentaSalvamento	Boolean	Campo que indica alerta de salvamento del vehículo según el RUNT. Solo se calcula en la modalidad PLUS.
dato	String	Campo que indica la placa del vehículo consultado.
runtVehicular	JSONObject	Solo se retorna en la modalidad PLUS. Contiene historicoPropietarios (Array) y datosBasicos del RUNT.
datosBasicos	JSONObject	Datos básicos del vehículo obtenidos del RUNT Público. Solo aplica en la modalidad Tiene Siniestros y si se pudo validar al propietario.
datosTecnicos	JSONObject	Datos técnicos del vehículo obtenidos del RUNT Público. Mismas condiciones que datosBasicos.
imagenVehiculo	String	Campo que indica la URL de la imagen del vehículo. Puede ser null.
fasecoldaService	JSONObject	Resultado de la fuente Fasecolda.
costoSiniestroService	JSONObject	Resultado de la fuente de costo de siniestro.
costoSiniestroMapfreService	JSONObject	Resultado de la fuente alterna de costo de siniestro.
polizasVehiculosService	JSONObject	Resultado de la fuente de pólizas del vehículo.

Estructura de un bloque de fuente

Los campos fasecoldaService, costoSiniestroService, costoSiniestroMapfreService y polizasVehiculosService comparten la misma estructura de nivel superior:

Atributo	Tipo	Descripción
lista	String	Campo que indica el nombre único de la fuente dentro del sistema.
tipo	String	Campo que indica la agrupación lógica de la fuente dentro de la aplicación.
presentaRiesgo	Boolean	Campo que indica si la fuente generó alerta de riesgo.
presentaAdvertencia	Boolean	Campo que indica si la fuente generó advertencia. Solo se incluye cuando la fuente lo reporta.
Resultado	JSONArray	Campo que indica el detalle devuelto por la fuente. Su contenido varía según la fuente y puede llegar vacío.
error	String	Campo que solo se incluye cuando la fuente falló al consultarse: "No se pudo consultar la fuente".

Que una fuente falle no invalida la consulta: la respuesta se retorna igual y esa fuente simplemente no aporta al cálculo de tieneSiniestros.

❌ Ejemplo de respuesta de error

En caso de que exista un error en el servicio se devuelve un Json Object

{
  "statusCode": 400,
  "error": "'placa' no encontrado en el body de la petición o es vacio"
}

{
  "statusCode": 403,
  "error": "No esta autorizado para consultar si tiene siniestros, por favor contacte con el area comercial para poder adquirir este producto"
}

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 mensaje con detalle del error ocurrido

Existen dos casos que se retornan con 200 OK pero indican que la consulta no pudo completarse, mediante el campo message en vez de la estructura de respuesta habitual:

• Usuario inactivo: {"message": "No cuenta con los permisos necesarios o su usuario esta inactivo"}
• No fue posible obtener el histórico del propietario en la modalidad PLUS: {"message": "No fue posible obtener los siniestros del vehículo."}