💳 Sequência: Cadastro de Dados de Recebimento

Requisito: 001.opus
Prioridade: 🔴 Alta - Crítico para MVP

Este diagrama mostra a sequência de interações entre os componentes durante o cadastro de dados de recebimento.

📋 Componentes Envolvidos

Frontend

• Formulário de cadastro
• Validação de campos
• Exibição de erros/sucesso

Backend API

• Endpoint: POST /api/providers/{id}/payment-data
• Validação de autenticação
• Processamento de dados

Validador

• Validação de CPF/CNPJ
• Validação de chave PIX
• Validação de dados bancários

Banco de Dados

• Tabela: provider_payment_data
• Verificação de duplicidade
• Armazenamento de dados

🔄 Fluxo de Validação

1. Validação de CPF/CNPJ

   • Verifica formato
   • Verifica dígitos verificadores
   • Retorna válido/inválido

2. Verificação de Duplicidade

   • Consulta se CPF/CNPJ já existe
   • Se existe, verifica se pertence ao prestador

3. Validação de Dados Bancários

   • Verifica se todos os campos obrigatórios estão preenchidos
   • Valida formato de conta/agência

4. Ativação

   • Marca dados como verificados
   • Ativa prestador para receber pagamentos

⚠️ Tratamento de Erros

• CPF/CNPJ Inválido: Exibir erro e permitir correção
• CPF/CNPJ não pertence: Exibir erro e solicitar correção
• Dados incompletos: Exibir campos faltantes
• Erro de salvamento: Exibir erro genérico e registrar log

---

Última atualização: 10 de Dezembro de 2025