Consultar Existencia de Nombre

Servicio que valida si existe un nombre registrado para un documento de identidad. Recibe el país, tipo de documento y número de documento; valida que los datos sean correctos y luego consulta si el nombre existe o no.

El token debe enviarse en los headers como:

Authorization: Bearer **token**

🔗 Endpoint

POSThttp://localhost:8080/ValidadorDatainnova/ws/RegistroConsultaService/consultarExistenciaNombre

📦 Estructura JSON

{
  "codigoPais": "COL",
  "tipoDocumento": "cc",
  "numeroDocumento": "1234567890"
}

Campo	Tipo	Descripción	Requerido
codigoPais	String	Código del país bajo el formato ISO 3166-1 Alfa-3 (ej: "COL", "PER", "CHL"). Puede consultar la guía de Países para más información.	Obligatorio
tipoDocumento	String	Tipo de documento a consultar (ej: "cc", "nit", "pa"). No distingue mayúsculas. Puede consultar la guía de Tipos de Documentos para más información.	Obligatorio
numeroDocumento	String	Número del documento a consultar.	Obligatorio

🧾 Respuestas posibles

✅ 200 OK — Nombre encontrado

El documento fue consultado y tiene un nombre registrado.

{
  "existeNombre": true
}

✅ 200 OK — Nombre no encontrado

El documento fue consultado correctamente pero no existe nombre registrado para ese número de documento.

{
  "existeNombre": false
}

❌ 400 Bad Request — Errores de validación

Causa	Mensaje de error
Cuerpo vacío	"El cuerpo de la petición no puede estar vacío."
Campos obligatorios faltantes	"Debe enviar codigoPais, tipoDocumento y numeroDocumento."
Campos en blanco	"Los campos codigoPais, tipoDocumento y numeroDocumento no pueden estar vacíos."
País no existe en el catálogo	"El código de país 'XYZ' no existe."
Tipo de documento no disponible para el país	"El tipo de documento 'xx' no está disponible para el país 'COL'."
Número de documento con formato inválido	"El número de documento no es válido para el tipo cc." (el mensaje varía según el tipo)

❌ 500 Internal Server Error

Causa	Mensaje de error
Error en el servicio de nombres (timeout: 90 s)	"Error al consultar el nombre del documento."
Error inesperado no controlado	"Ocurrió un error al procesar la solicitud."