Carregar Documento para Registro de Nome

Serviço que recebe um documento de identidade (imagem ou PDF), extrai o nome. Para documentos do tipo NIT, também valida a vigência do RUT (máximo de 120 dias).

O token deve ser enviado nos headers como:

Authorization: Bearer **token**

🔗 Endpoint

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

Content-Type: multipart/form-data

📦 Form Data

Campo	Tipo	Descrição	Requerido
codigoPais	String	Código do país no formato ISO 3166-1 Alfa-3 (ex: "COL", "PER"). Consulte o guia de Países para mais informações.	Obrigatório
tipoDocumento	String	Tipo de documento (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 registrar.	Obrigatório
archivo	File	Arquivo do documento. NIT: somente PDF. Outros tipos: PDF, JPG, JPEG ou PNG.	Obrigatório

🧾 Respostas Possíveis

✅ 200 OK — Nome registrado com sucesso

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

❌ 400 Bad Request — Erros de validação

As validações de país, tipo de documento e regex são idênticas às do endpoint Consultar Existência de Nome.

Causa	Mensagem de erro
Campos obrigatórios ausentes ou em branco	"Debe enviar codigoPais, tipoDocumento y numeroDocumento."
Arquivo não enviado	"Debe enviar el archivo del documento."
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	"<mensajeError configurado para o tipo de documento>"
Arquivo não é PDF (tipo NIT)	"Para tipo de documento NIT solo se acepta formato PDF."
Formato de arquivo inválido (outros tipos)	"Solo se aceptan archivos en formato PDF, JPG, JPEG o PNG."
RUT com mais de 120 dias de validade	"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

Retornado quando ocorre um erro no processamento após as validações iniciais:

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