Consultar Existência de Nome

Serviço que valida se existe um nome registrado para um documento de identidade. Recebe o país, tipo de documento e número do documento; valida os dados e em seguida verifica se o nome existe ou não.

O token deve ser enviado nos headers como:

Authorization: Bearer **token**

🔗 Endpoint

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

📦 Estrutura JSON

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

Campo	Tipo	Descrição	Requerido
codigoPais	String	Código do país no formato ISO 3166-1 Alfa-3 (ex: "COL", "PER", "CHL"). Consulte o guia de Países para mais informações.	Obrigatório
tipoDocumento	String	Tipo de documento a consultar (ex: "cc", "nit", "pa"). Não diferencia maiúsculas de minúsculas. Consulte o guia de Tipos de Documentos para mais informações.	Obrigatório
numeroDocumento	String	Número do documento a consultar.	Obrigatório

🧾 Respostas Possíveis

✅ 200 OK — Nome encontrado

O documento foi consultado e possui um nome registrado.

{
  "existeNombre": true
}

✅ 200 OK — Nome não encontrado

O documento foi consultado corretamente, mas não existe nome registrado para esse número de documento.

{
  "existeNombre": false
}

❌ 400 Bad Request — Erros de validação

Causa	Mensagem de erro
Corpo vazio	"El cuerpo de la petición no puede estar vacío."
Campos obrigatórios ausentes	"Debe enviar codigoPais, tipoDocumento y numeroDocumento."
Campos em branco	"Los campos codigoPais, tipoDocumento y numeroDocumento no pueden estar vacíos."
País não encontrado no catálogo	"El código de país 'XYZ' no existe."
Tipo de documento não disponível para o país	"El tipo de documento 'xx' no está disponible para el país 'COL'."
Formato do número de documento inválido	"El número de documento no es válido para el tipo cc." (a mensagem varia conforme o tipo)

❌ 500 Internal Server Error

Causa	Mensagem de erro
Erro no serviço de nomes (timeout: 90 s)	"Error al consultar el nombre del documento."
Erro inesperado não tratado	"Ocurrió un error al procesar la solicitud."