Upload Document for Name Registration

Service that receives an identity document (image or PDF), extracts the name. For NIT document types, it also validates the RUT's validity (maximum 120 days).

The token must be sent in the headers as:

Authorization: Bearer **token**

🔗 Endpoint

POSThttp://localhost:8080/ValidadorDatainnova/ws/GestionNombresService/cargarDocumentoNombre

Content-Type: multipart/form-data

📦 Form Data

Field	Type	Description	Required
codigoPais	String	Country code in ISO 3166-1 Alpha-3 format (e.g., "COL", "PER"). Refer to the Countries guide for more information.	Mandatory
tipoDocumento	String	Document type (e.g., "cc", "nit", "pa"). Case-insensitive. Refer to the Document Types guide for more information.	Mandatory
numeroDocumento	String	Document number to register.	Mandatory
archivo	File	Document file. NIT: PDF only. Other types: PDF, JPG, JPEG, or PNG.	Mandatory

🧾 Possible Responses

✅ 200 OK — Name registered successfully

{
  "nombre": "JUAN CARLOS PÉREZ GÓMEZ",
  "tipoDocumento": "cc",
  "numeroDocumento": "1234567890",
  "codigoPais": "COL"
}

❌ 400 Bad Request — Validation errors

Country, document type, and regex validations are identical to those in the Check Name Existence endpoint.

Cause	Error message
Missing or empty required fields	"Debe enviar codigoPais, tipoDocumento y numeroDocumento."
File not sent	"Debe enviar el archivo del documento."
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	"<mensajeError configured for the document type>"
File is not PDF (NIT type)	"Para tipo de documento NIT solo se acepta formato PDF."
Invalid file format (other types)	"Solo se aceptan archivos en formato PDF, JPG, JPEG o PNG."
RUT older than 120 days	"El RUT no tiene vigencia válida. Han pasado X días desde su última actualización. El máximo permitido es 120 días."

❌ 500 Internal Server Error

Returned when an error occurs during processing after initial validations:

{
  "error": "No se pudo procesar el archivo. Se ha notificado al equipo de soporte."
}