Recadastramento e Atualização Cadastral

Parceiros que precisam atualizar ou recadastrar seus clientes podem realizar a atualização via API, desde que tenham um usuário devidamente configurado. Os dados passarão por um processo de auditoria e validação automática. Alguns dados podem exigir validação manual, necessitando o anexo de documentos.

O fluxo se resume no seguinte conjunto de etapas:

  1. Detalhamento dos dados cadastrais:
    • Etapa opcional que fornece os dados atuais do cadastro do cliente. É útil para verificar previamente as informações atuais do cadastro.
  2. Rotas Auxiliares para Obtenção dos IDs para Recadastro

  3. Recadastramento de clientes:
    • Concretiza a ação de atualização. Uma vez chamada, as mudanças serão refletidas no perfil do cliente e registradas no histórico.
  4. Sem mudanças cadastrais:
    • Informa que o cliente está com os dados atualizados e nenhuma mudança será feita.

Regras de Validação para Recadastramento

  • Somente documentos de identificação válidos serão aceitos.
  • Não será possível alterar os dados cadastrais de clientes que se enquadrem nos termos da Lei FATCA.
  • As siglas dos estados e códigos de municípios devem seguir os disponibilizados no site do IBGE. Se necessário, a documentação da API da instituição está disponível aqui.
  • O campo de código de segurança será exigido caso o tipo de documento seja CNH, atualmente com ID 2.
  • Caso o valor de ativos declarado seja acima de R$ 1.000.000,00, é obrigatório informar o valor das aplicações financeiras no campo net_asset_value.

Se for necessário informar que o cliente não teve alterações cadastrais e se encontra no status de recadastramento, pode-se utilizar uma rota específica para confirmar que não há mudanças cadastrais.

Enumeradores

Enumeradores do fluxo.

Nacionalidade

ValorDescrição
1Brasileiro Nato
2Brasileiro Naturalizado
3Estrangeiro

Sexo/Gênero

ValorDescrição
MMasculino
FFeminino

Status Civil

ValorDescrição
1Solteiro(a)
2Casado(a)
3Separado(a)
4Divorciado(a)
5Viúvo(a)
6União estável

Aplicações financeiras

ValorDescrição
0Nenhum
1Até R$50.000,00
2De R$50.000,01 a R$100.000,00
3De R$100.000,01 a R$200.000,00
4De R$200.000,01 a R$300.000,00
5De R$300.000,01 a R$1.000.000,00
6Acima de R$1.000.000,00

Ganhos mensais

ValorDescrição
0Nenhum
1Até R$5.000,00
2De R$5.000,01 a R$10.000,00
3De R$10.000,01 a R$20.000,00
4De R$20.000,01 a R$30.000,00
5De R$30.000,01 a R$100.000,00
6Acima de R$100.000,00

Status Cadastral

ValorDescrição
20Iniciando nova alteração
21Verificação de aprovação automática
22Cancelado
23Expirado
6Cadastro alterado (alteração finalizada = aguardando documentação)
7Upload documento iniciado
8Upload documento finalizado (upload finalizado = em análise)
9Pendente
10Correção iniciada
11Correção finalizada
12Aguardando aprovação
13Aprovado