Fluxo cadastral

A seguir, são descritos os passos a serem seguidos para realizar a criação do cadastro do investidor:

Passo Único: Criar/Atualizar Cadastro

• Ação: Envie os dados para o endpoint Criar Cadastro.
• Comportamento:
  • Novo Cadastro:
    • Se o investidor não existir na base, o cadastro é criado com validade de 3 anos.
  • Cadastro Existente:
    • Os dados sempre serão atualizados após a validação do formulário.
    • A validade do cadastro só será renovada para +3 anos se uma completamenteRevisado estiver como true.
    • Se a flag for false ou omitida: dados são atualizados, mas a validade não é alterada.

⚠️ Detalhes Técnicos

• API-KEY:
  • Header obrigatório em todas as requisições (API-KEY fornecida pela Nikos).
• completamenteRevisado:
  • Controla apenas a renovação da validade (não afeta a atualização dos dados).
• Exemplo de uso:
  • true: Renova validade para 3 anos (ex.: cliente confirma revisão anual dos dados).
  • false: Mantém a validade original (ex.: correção de erro em campo).

🔍 Respostas da API

• Status 200/201:
• Retorna validade_cadastro (data de expiração).
  • Novo cadastro: validade_cadastro = data atual + 3 anos.
  • Cadastro existente:
    • validade_cadastro renovada se completamenteRevisa = true.
    • validade_cadastro mantida se completamenteRevisado = false.
• Status 400:
  • Erros de validação (campos inválidos, termos não aceitos, etc.).

✅ Regras Específicas

1. Validade:
   1. Após 3 anos, o cadastro expira e o cliente não poderá operar até reenviar o formulário.
2. Atualizações Parciais:
   1. Sempre envie todos os campos obrigatórios (a API substitui os dados anteriores).
3. Controle da Flag:
   1. Decisão estratégica do parceiro (ex.: renovar validade apenas após confirmação explícita do cliente).