Etapa 4: Aprovação KYB / Step 4: KYB Approval¶

📌 Visão Geral / Overview¶

Após o envio de todos os documentos, o processo de Know Your Business (KYB) é iniciado automaticamente com validação completa da empresa e sócios.

After submitting all documents, the Know Your Business (KYB) process automatically starts with complete validation of the company and partners.

🔍 O que acontece nesta etapa: / What happens in this step:¶

Validação do Contrato Social via OCR 1. Articles of Incorporation Validation via OCR
Consulta à Receita Federal (situação cadastral) 2. Federal Revenue Service Consultation (registration status)
Verificação de listas restritivas (PEP, sanções) 3. Restrictive lists verification (PEP, sanctions)
Validação dos sócios responsáveis 4. Responsible partners validation**
Decisão final de aprovação ou rejeição 5. Final decision of approval or rejection

📊 Status Possíveis / Possible Statuses¶

Status	Descrição / Description	Próxima Ação / Next Action
`documents_received`	Documentos recebidos Documents received	Aguardar validação Wait for validation
`validating_documents`	Validação OCR em andamento OCR validation in progress	Aguardar Wait
`pending_manual_review`	Análise manual necessária Manual review required	Aguardar Wait
`additional_info_required`	Informações adicionais necessárias Additional information required	Enviar dados solicitados Send requested data
`approved`	KYB aprovado KYB approved	Empresa habilitada Company enabled
`rejected`	KYB rejeitado KYB rejected	Verificar motivos Check reasons

🔎 Consultando o Status / Checking the Status¶

cURL

GET /v1/partner/public/clients/get-basic-data-pj/{clientId}

📥 Resposta de Consulta / Query Response¶

{
  "success": true,
  "data": {
    "clientId": "PJ_def456ghi789",
    "companyName": "Empresa Exemplo Ltda",
    "document": "12345678000123",
    "email": "contato@empresaexemplo.com.br",
    "status": "approved",
    "kybStatus": {
      "overallStatus": "approved",
      "documentsValidated": true,
      "complianceCheck": "passed",
      "approvalDate": "2024-01-15T16:30:00Z"
    }
  }
}

📊 Monitoramento e Consultas / Monitoring and Queries¶

🏢 Consultar Dados da Empresa / Query Company Data¶

cURL

GET /v1/partner/public/clients/get-basic-data-pj/{clientId}

📋 Listar Todas as Empresas / List All Companies¶

cURL

GET /v1/partner/public/clients/get-filtered?clientType=PJ&page=0&size=20

⚠️ Considerações Importantes / Important Considerations¶

🚧 Limitações e Validações / Limitations and Validations¶

Um CNPJ por cadastro ativo
One CNPJ per active registration
Empresa ativa na Receita Federal obrigatório
Active company at the Federal Revenue Service mandatory
Contrato social atualizado obrigatório
Updated Articles of Incorporation mandatory
Pelo menos um email adicional obrigatório
At least one additional email mandatory
Sócios com participação ≥ 10% devem ser informados
Partners with ≥ 10% stake must be informed
Documentos dos sócios obrigatórios
Partners' documents mandatory

⚙️ Validações Automáticas / Automatic Validations¶

CNPJ: Algoritmo de verificação e consulta à Receita Federal
CNPJ: Verification algorithm and Federal Revenue Service consultation
Email: Formato e unicidade no sistema
Email: Format and uniqueness in the system
Telefone: Formato brasileiro com DDD
Phone: Brazilian format with area code (DDD)
CEP: Formato brasileiro (12345-678)
CEP (ZIP Code): Brazilian format (12345-678)
Contrato Social: Extração e validação de dados via OCR
Articles of Incorporation: Data extraction and validation via OCR
Sócios: Validação de CPF e documentos
Partners: CPF and document validation
SeeAway: Validação compliance e KYB
SeeAway: Compliance and KYB validation

💡 Integração Recomendada / Recommended Integration¶

🔄 Fluxo de Desenvolvimento / Development Flow¶

Ambiente de Sandbox / Sandbox Environment
Teste todo o fluxo com dados fictícios
Test the entire flow with dummy/mock data
Valide tratamento de erros
Validate error handling
Implemente retry logic
Implement retry logic
Validações Frontend / Frontend Validations
CNPJ antes do envio
CNPJ before submission
Pelo menos um email adicional
At least one additional email
Validação de sócios obrigatórios
Mandatory partners validation
Formatação de CEP
CEP (ZIP Code) formatting
Formatação de arquivos
File formatting
Tamanhos de documento
Document sizes
Monitoramento / Monitoring
Status de cada etapa
Status of each step
Logs de erro detalhados
Detailed error logs
Métricas de conversão
Conversion metrics
Qualidade de documentos
Document quality
UX/UI Recomendada / Recommended UX/UI
Progress bar do fluxo
Flow progress bar
Formulário de sócios dinâmico
Dynamic partners form
Upload drag-and-drop
Drag-and-drop upload
Preview dos documentos
Document preview
Múltiplos uploads para documentos
Multiple uploads for documents
Notificações de status
Status notifications

[!WARNING] LEMBRE-SE / REMEMBER

Este é um processo regulamentado. Todos os dados fornecidos devem ser verdadeiros e atualizados. Informações falsas podem resultar em bloqueio permanente da conta e notificação aos órgãos competentes.

This is a regulated process. All data provided must be true and up-to-date. False information may result in permanent account suspension and notification to the competent authorities.

[!NOTE] SUPORTE / SUPPORT

Em caso de dúvidas sobre regulamentações ou requisitos específicos, entre em contato com nossa equipe de compliance através do canal de suporte dedicado.

If you have any questions regarding regulations or specific requirements, please contact our compliance team through the dedicated support channel.