Check Name Existence

Service that validates whether a name is registered for a given identity document. It receives the country, document type, and document number; validates the data, and then checks whether the name exists or not.

The token must be sent in the headers as:

Authorization: Bearer **token**

🔗 Endpoint

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

📦 JSON Structure

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

Field	Type	Description	Required
codigoPais	String	Country code in ISO 3166-1 Alpha-3 format (e.g., "COL", "PER", "CHL"). Refer to the Countries guide for more information.	Mandatory
tipoDocumento	String	Document type to query (e.g., "cc", "nit", "pa"). Case-insensitive. Refer to the Document Types guide for more information.	Mandatory
numeroDocumento	String	Document number to query.	Mandatory

🧾 Possible Responses

✅ 200 OK — Name found

The document was queried and has a registered name.

{
  "existeNombre": true
}

✅ 200 OK — Name not found

The document was queried successfully but no name is registered for that document number.

{
  "existeNombre": false
}

❌ 400 Bad Request — Validation errors

Cause	Error message
Empty body	"El cuerpo de la petición no puede estar vacío."
Missing required fields	"Debe enviar codigoPais, tipoDocumento y numeroDocumento."
Blank fields	"Los campos codigoPais, tipoDocumento y numeroDocumento no pueden estar vacíos."
Country not found in catalog	"El código de país 'XYZ' no existe."
Document type not available for country	"El tipo de documento 'xx' no está disponible para el país 'COL'."
Invalid document number format	"El número de documento no es válido para el tipo cc." (message varies by type)

❌ 500 Internal Server Error

Cause	Error message
Name service error (timeout: 90 s)	"Error al consultar el nombre del documento."
Unexpected unhandled error	"Ocurrió un error al procesar la solicitud."