Verificação do documento de identidade

Antes de criar um processo de assinatura ou de consultar antecedentes, a Auco verifica no registro oficial se o documento de identidade existe e se o titular não consta como falecido. Nos processos de assinatura, também compara o nome do signatário com o do registro.

Se a verificação falhar, a Auco não cria o processo e responde 400 com um código que indica o que falhou. Assim, nenhum documento é enviado para assinatura e nenhuma consulta é paga em nome de uma identidade que não existe.

A cobertura depende do país e do tipo de documento

Quando um país ou tipo de documento não tem cobertura, a verificação não é feita e o processo segue. O mesmo acontece se o registro oficial não responder: uma falha do provedor nunca impede a criação do processo.

---

🧩 Onde se aplica

Serviço	O que é verificado	O que precisa
POST /document/upload	Vigência e nome de cada signatário.	signProfile[x].identification e signProfile[x].identificationType. Ver Dados do signatário.
POST /document/save	Vigência e nome de cada signatário.	O signatureProfile do modelo deve definir a identificação e o tipo de documento do signatário.
POST /validate/background	Vigência do documento. Não há nome.	type em CC, CE ou PPT. Com NIT, a Auco verifica se a empresa existe no RUES.

Nos processos de assinatura, só são verificados os signatários que enviam identification. Na consulta de antecedentes, os tipos PP e INT não são verificados.

---

Dados do signatário

Estes campos vão em cada elemento de signProfile de POST /document/upload:

Nome	Tipo	Descrição
signProfile[x].identification	String opcional	Número de identificação do signatário.
signProfile[x].identificationType	String condicional	Tipo de documento, por exemplo CC ou CE. Sem ele, o signatário não é verificado e seu status chega como NOT_SUPPORTED.
signProfile[x].country	String opcional	País do documento em código ISO de duas letras. O padrão é CO.

---

📥 Exemplos de resposta

Quando algum signatário envia identification, a resposta de POST /document/upload e de POST /document/save inclui identityValidation, com um elemento por signatário verificado:

{
  "document": "ABCDEF1234",
  "identityValidation": [
    {
      "identification": "123456789",
      "name": "Firmante 1",
      "validated": true,
      "status": "ALIVE",
      "nameStatus": "MATCH"
    }
  ]
}

---

📋 Campos da resposta

Campo	Tipo	Descrição
identityValidation	Array<Object>	Opcional. Retornado apenas se algum signatário enviou identification.
identityValidation[].identification	String	Número de identificação verificado.
identityValidation[].name	String	Nome do signatário comparado com o registro.
identityValidation[].validated	Boolean	true apenas quando status é ALIVE.
identityValidation[].status	String	Estado do documento. Ver Estados do documento.
identityValidation[].nameStatus	String	Resultado da comparação do nome: MATCH, NO_MATCH, NOT_FOUND, UNSUPPORTED ou ERROR. Chega como null quando não foi comparado.

O resultado não é salvo com o processo

identityValidation só chega na resposta de criação. Se precisar dele depois, guarde-o na sua integração.

---

🔄 Estados do documento (identityValidation[].status)

Estado	Descrição
ALIVE	O documento existe e seu titular está vivo.
DECEASED	O titular do documento consta como falecido. Rejeita o processo.
NOT_FOUND	O documento não existe no registro oficial. Rejeita o processo.
UNKNOWN	O registro respondeu sem um estado conclusivo.
UNSUPPORTED	O país ou tipo de documento não tem cobertura de verificação.
ERROR	O provedor da consulta falhou.
UNAVAILABLE	A Auco não conseguiu fazer a consulta.
NOT_SUPPORTED	O signatário não tem identificationType, então não foi verificado.

Só DECEASED, NOT_FOUND e um nome em NO_MATCH rejeitam o processo; com qualquer outro estado o processo é criado.

O catálogo de estados não é fechado

Novos valores podem aparecer. Trate um valor desconhecido como um resultado não validado, sem fazer sua integração falhar.

---

🚫 Códigos de rejeição

Todos respondem 400. O código chega em message.

Código	Descrição
SIGNER_IDENTITY_DECEASED	Processos de assinatura. Um signatário consta como falecido.
SIGNER_IDENTITY_NOT_FOUND	Processos de assinatura. O documento de um signatário não existe no registro oficial.
SIGNER_NAME_MISMATCH	Processos de assinatura. O nome de um signatário não coincide com o do registro.
IDENTITY_DECEASED	Consulta de antecedentes. O titular do documento consta como falecido.
IDENTITY_NOT_FOUND	Consulta de antecedentes. O documento não existe no registro oficial.
COMPANY_NOT_FOUND	Consulta de antecedentes com type: NIT. A empresa não existe no RUES.

Nos processos de assinatura, o corpo do erro identifica o signatário que o causou. SIGNER_NAME_MISMATCH também traz name:

{
  "message": "SIGNER_IDENTITY_NOT_FOUND",
  "identification": "123456789"
}