Cargar Documento para Registro de Nombre
Servicio que recibe un documento de identidad (imagen o PDF), extrae el nombre. Para documentos de tipo NIT, además valida la vigencia del RUT (máximo 120 días).
El token debe enviarse en los headers como:
Authorization: Bearer **token**
🔗 Endpoint
POSThttp://localhost:8080/ValidadorDatainnova/ws/GestionNombresService/cargarDocumentoNombre
Content-Type: multipart/form-data
📦 Form Data
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
| codigoPais | String | Código del país bajo el formato ISO 3166-1 Alfa-3 (ej: "COL", "PER"). Puede consultar la guía de Países para más información. | Obligatorio |
| tipoDocumento | String | Tipo de documento (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 registrar. | Obligatorio |
| archivo | File | Archivo del documento. NIT: solo PDF. Otros tipos: PDF, JPG, JPEG o PNG. | Obligatorio |
🧾 Respuestas posibles
✅ 200 OK — Nombre registrado exitosamente
{
"nombre": "JUAN CARLOS PÉREZ GÓMEZ",
"tipoDocumento": "cc",
"numeroDocumento": "1234567890",
"codigoPais": "COL"
}
❌ 400 Bad Request — Errores de validación
Las validaciones de país, tipo de documento y regex son idénticas a las del endpoint Consultar Existencia de Nombre.
| Causa | Mensaje de error |
|---|---|
| Campos obligatorios faltantes o vacíos | "Debe enviar codigoPais, tipoDocumento y numeroDocumento." |
| Archivo no enviado | "Debe enviar el archivo del documento." |
| 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 | "<mensajeError configurado para el tipo de documento>" |
| Archivo no es PDF (cuando el tipo es NIT) | "Para tipo de documento NIT solo se acepta formato PDF." |
| Formato de archivo inválido (otros tipos) | "Solo se aceptan archivos en formato PDF, JPG, JPEG o PNG." |
| RUT con más de 30 días de antigüedad | "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
Se retorna cuando ocurre un error en el procesamiento posterior a las validaciones:
{
"error": "No se pudo procesar el archivo. Se ha notificado al equipo de soporte."
}