KYC Cadastro - cybervanguardtechnologies/Sirius GitHub Wiki
➕ KYC — Cadastrando um Cliente
Passo a passo
1. Inicie o cadastro
Na tela de listagem do KYC, clique em + Novo Cadastro.
2. Escolha o tipo
Selecione:
- Pessoa Física (PF) — para clientes individuais
- Pessoa Jurídica (PJ) — para empresas
Cadastro de Pessoa Física (PF)
Preencha os seguintes campos:
Dados pessoais
| Campo | Obrigatório? | Exemplo |
|---|---|---|
| Nome completo | ✅ Sim | João Carlos da Silva |
| CPF | ✅ Sim | 123.456.789-00 |
| Data de nascimento | ✅ Sim | 15/03/1985 |
| RG | Não | 12.345.678-9 |
| Órgão expedidor | Não | SSP-SP |
| Nacionalidade | Não | Brasileira (já preenchido) |
| Não | [email protected] | |
| Telefone | Não | (11) 91234-5678 |
| Profissão | Não | Engenheiro |
| Renda estimada | Não | 15.000,00 |
| Origem dos recursos | Não | Salário CLT |
PEP (Pessoa Exposta Politicamente)
| Campo | Obrigatório? |
|---|---|
| É PEP? | ✅ Sim (marque Sim ou Não) |
| Descrição do PEP | Se marcou Sim, descreva o cargo ou relação |
O que é PEP? São pessoas que ocupam ou ocuparam cargos públicos relevantes, ou seus familiares e pessoas próximas. Ex: deputados, prefeitos, diretores de estatais.
Endereço
| Campo | Obrigatório? |
|---|---|
| Rua | ✅ Sim |
| Número | Não |
| Complemento | Não |
| Bairro | Não |
| Cidade | ✅ Sim |
| Estado | ✅ Sim |
| CEP | ✅ Sim |
Base legal (LGPD)
| Campo | Obrigatório? | O que preencher |
|---|---|---|
| Finalidade | ✅ Sim | Por que você está cadastrando este cliente? Ex: "Abertura de conta corrente" |
| Base legal | ✅ Sim | Selecione uma opção: Consentimento, Contrato, Obrigação Legal, etc. |
Campos opcionais
- Tags — Palavras-chave para facilitar a busca (ex: "cliente_vip")
- Observações — Notas internas sobre o cadastro
3. Salve o cadastro
Clique em Salvar. O cadastro será criado com status Rascunho.
Cadastro de Pessoa Jurídica (PJ)
O processo é semelhante, mas com campos diferentes:
| Campo | Obrigatório? | Exemplo |
|---|---|---|
| Razão social | ✅ Sim | TechSolução Ltda. |
| CNPJ | ✅ Sim | 12.345.678/0001-90 |
| Nome fantasia | Não | TechSol |
| Natureza jurídica | Não | Sociedade Limitada |
| CNAE principal | Não | 6201-5 |
| Data de abertura | Não | 10/03/2015 |
| Não | [email protected] | |
| Faturamento estimado | Não | 1.200.000,00 |
| É PEP? | ✅ Sim | Se algum sócio é PEP |
Validações automáticas
O sistema verifica automaticamente:
- ✅ Se o CPF é válido (dígitos verificadores)
- ✅ Se o CNPJ é válido
- ✅ Se o CPF/CNPJ já está cadastrado (evita duplicidade)
- ✅ Se os campos obrigatórios estão preenchidos
Se algo estiver errado, uma mensagem de erro aparecerá indicando o campo a corrigir.
O que acontece depois
Após salvar:
- O cadastro é criado com status Rascunho
- O workflow de análise é iniciado automaticamente
- Um registro de base legal (LGPD) é criado
- A ação aparece na trilha de auditoria
Próximo passo: Envie os documentos obrigatórios