Formulários do Sistema
Cadastros e Operações

👤 Cadastro de Cliente

Preencha os dados do cliente para iniciar o atendimento

📋 Para que serve este formulário? Este é o primeiro passo! Aqui você cadastra os dados pessoais do cliente. Depois de salvar, você poderá: • Cadastrar os veículos do cliente
• Criar contratos de seguro ou proteção veicular
• Ter um banco de dados completo para contato e renovações
🔗 Integração com CRM Emmy Busque o cliente no CRM Emmy e todos os dados serão preenchidos automaticamente! Economize tempo e evite erros de digitação.
🔍
Buscar Cliente no CRM Emmy
Digite o CPF/CNPJ ou nome para buscar via API
A busca será feita na base do CRM Emmy via API
────────── OU ──────────
📝 Preencher Manualmente
✓ Cliente cadastrado com sucesso! Agora você pode cadastrar um veículo ou criar um contrato.
📋 Informações Pessoais
📞 Contato
📍 Endereço
📝 Observações

🚗 Cadastro de Veículo

Registre o veículo que será segurado

📋 Para que serve este formulário? Aqui você registra os veículos dos clientes. Cada veículo fica vinculado ao seu proprietário e pode ter um ou mais contratos (proteção veicular ou seguro).
💡 Como funciona? 1. Busque o cliente pelo nome ou CPF
2. Preencha os dados do veículo (placa, modelo, etc)
3. O veículo fica disponível para criar contratos
👤 Proprietário
🔍
Digite para buscar um cliente já cadastrado
🚗 Dados do Veículo
📝 Observações

📄 Novo Contrato

Este é o formulário principal - aqui você fecha o negócio!

📋 Para que serve este formulário? Este é o coração do sistema! Aqui você registra a venda de um seguro ou proteção veicular. Este formulário faz TUDO automaticamente:
⚡ AUTOMAÇÕES QUE ACONTECEM AO SALVAR:
✅ 1. Calcula a data da primeira mensalidade → Data de início + 30 dias
✅ 2. Gera as mensalidades automaticamente:
    • Seguro anual: 12 parcelas mensais
    • Proteção veicular: contínuo (gera mensalmente)
✅ 3. Registra a comissão de adesão → Valor que você recebe via PIX
✅ 4. Configura comissões recorrentes → 10% calculado automaticamente todo mês
✅ 5. Define data de repasse → Dia 10 do mês seguinte
👤 Cliente e Veículo
🔍
🏢 Tipo de Proteção
📅 Datas e Vigência
Apenas para seguros anuais
📆 Primeira Mensalidade Será calculada automaticamente: Data de Início + 30 dias = 10/01/2026
💰 Valores
📋 Entenda os valores:
• Adesão: Você recebe 100% desse valor hoje (via PIX)
• Mensalidade: O que o cliente vai pagar todo mês para a empresa
• Sua comissão: 10% da mensalidade que o cliente paga (calculado automaticamente)
Você recebe 100% via PIX
Valor que o cliente paga por mês
💵 Adesão (você recebe hoje): R$ 0,00
📊 Mensalidade do cliente: R$ 0,00
📈 Percentual de comissão: 0%
💰 Sua comissão mensal: R$ 0,00
🔄 Exemplo Real (Jorge - Multi Benefícios) • Adesão: R$ 74,44 (você recebe hoje via PIX)
• Mensalidade cliente: R$ 200,00
• Sua comissão: R$ 20,00/mês (10%)
• Repasse: Todo dia 10 do mês seguinte
📝 Informações Adicionais
Número fornecido pela empresa

💳 Registrar Pagamento

Marque quando o cliente pagar uma mensalidade

📋 Para que serve este formulário? Aqui você registra manualmente quando um cliente paga a mensalidade. Isso é útil quando o pagamento foi feito via PIX, dinheiro ou outras formas diretas à corretora.
💡 IMPORTANTE: Este formulário é apenas para casos manuais!
Na maioria dos casos, os pagamentos serão sincronizados automaticamente via:
• API das empresas (Multi, ProAuto, Seguradoras)
• Upload de Excel em massa (baixa da empresa, faz upload aqui)

Veja na aba "Automação de Comissões" como funciona! →
🔍 Buscar Contrato
🔍
Jorge Augusto Dente MULTI-001
Multi Benefícios • MOTO • R$ 200,00/mês
📋 Mensalidades Pendentes
Parcela 1/12
Vencimento: 10/01/2026
R$ 200,00
Pendente
💰 Dados do Pagamento
⚡ O QUE ACONTECE AUTOMATICAMENTE QUANDO VOCÊ SALVAR:
✅ 1. Status da mensalidade: PENDENTE → PAGO
✅ 2. Sistema cria comissão recorrente: R$ 20,00 (10% de R$ 200,00)
✅ 3. Define previsão de repasse: 10/02/2026
✅ 4. Atualiza dashboard em tempo real
✅ 5. Adiciona ao relatório de comissões do mês

⚡ Automação de Comissões

Sistema inteligente de sincronização de pagamentos

📋 Como funciona a automação? Em vez de cadastrar pagamento por pagamento manualmente, o sistema sincroniza automaticamente com as empresas de 2 formas:
🔌

OPÇÃO 1: Integração via API

Sincronização automática em tempo real

📊

OPÇÃO 2: Upload de Excel

Importação em massa e batimento automático

🔌 OPÇÃO 1: Integração via API (Melhor Opção!)
📋 Como funciona?
Conversamos com cada empresa (Multi, ProAuto, APVS, Seguradoras) para conectar o sistema deles com o seu sistema via API.
⚡ FLUXO AUTOMÁTICO:
1
Cliente paga a mensalidade
Jorge paga R$ 200,00 no boleto da Multi Benefícios
2
Sistema da empresa confirma pagamento
Multi registra o pagamento no sistema deles
3
API envia dados para seu sistema (AUTOMÁTICO!)
Em tempo real ou a cada X horas, a API sincroniza
4
Seu sistema atualiza automaticamente:
✓ Marca mensalidade como PAGA
✓ Calcula comissão: R$ 20,00 (10%)
✓ Define repasse: 10/02/2026
✓ Atualiza dashboard
✅ VANTAGENS DA API:
✓ ZERO trabalho manual
✓ Atualização em tempo real (ou a cada poucas horas)
✓ Sem erros humanos
✓ Dashboard sempre atualizado
✓ Você não precisa fazer nada!
🔧 Implementação: Precisamos conversar com cada empresa para solicitar acesso à API deles. Algumas empresas já têm APIs prontas, outras precisaremos negociar.
📊 OPÇÃO 2: Upload de Excel (Plano B)
📋 Como funciona?
Para empresas que não têm API ou enquanto negociamos a integração, você baixa o Excel do site da empresa e faz upload aqui. O sistema faz o batimento automático!
📤 FLUXO COM EXCEL:
1
Você acessa o site da empresa
Ex: Portal Multi Benefícios
2
Baixa o relatório de pagamentos em Excel
Arquivo com todos os clientes que pagaram no mês
3
Faz upload do Excel aqui no sistema
Botão "Importar Excel" → Seleciona arquivo
4
Sistema faz batimento automático:
✓ Identifica clientes pelo CPF/Contrato
✓ Compara valores (Excel vs Sistema)
✓ Marca mensalidades como PAGAS
✓ Calcula comissões automaticamente
✓ Mostra resumo: "32 pagamentos confirmados"
📊

Área de Upload de Excel

Arraste o arquivo aqui ou clique para selecionar

Formatos aceitos: .xlsx, .xls, .csv
✅ EXEMPLO DE RESULTADO APÓS UPLOAD:
📊 Arquivo processado com sucesso!

✓ 32 pagamentos confirmados
⚠️ 2 divergências encontradas
✗ 1 não encontrado no sistema

→ Jorge Augusto Dente: R$ 200,00 ✓
→ Emilly Gabrielle: R$ 300,00 ✓
→ Andre Pereira: R$ 350,00 ✓
...

Total de comissões geradas: R$ 1.800,00

📊 Consultas e Relatórios

Consulte comissões, gere relatórios e analise seus resultados

📋 Para que serve este módulo? Aqui você consulta e filtra todas as informações do sistema: comissões recebidas, contratos ativos, inadimplência, performance por empresa e muito mais. Perfeito para fechar o mês, analisar resultados e tomar decisões!
🔍
Filtros de Consulta
Defina os parâmetros para gerar seu relatório
💰 Comissões do Período
R$ 2.100,00
Janeiro 2026
📋 Contratos Ativos
34
Gerando comissão
✅ Taxa de Adimplência
94%
32 de 34 pagando
📈 Ticket Médio
R$ 61,76
Por contrato/mês

📊 Detalhamento de Comissões

Mostrando 34 resultados
# Cliente Empresa Categoria Mensalidade Sua Comissão Status
1 Jorge Augusto Dente Multi Benefícios MOTO R$ 200,00 R$ 20,00 Pago
2 Emilly Gabrielle da Silva Multi Benefícios CARRO R$ 300,00 R$ 30,00 Pago
3 Andre Pereira da Silva Multi Benefícios CARRO R$ 350,00 R$ 35,00 Pago
4 Carlos Eduardo Santos Multi Benefícios MOTO R$ 180,00 R$ 18,00 Atrasado
5 Fernanda Costa Lima Multi Benefícios CARRO R$ 280,00 R$ 28,00 Pago
6 Roberto Silva Santos Multi Benefícios MOTO R$ 190,00 R$ 19,00 Pago
7 Patricia Alves Multi Benefícios CARRO R$ 320,00 R$ 32,00 Pago
8 Lucas Fernandes Multi Benefícios UTILITÁRIO R$ 400,00 R$ 40,00 Pago
9 Mariana Rodrigues Multi Benefícios CARRO R$ 260,00 R$ 26,00 Pago
10 Antonio Carlos Multi Benefícios MOTO R$ 210,00 R$ 21,00 Pago
11 Juliana Martins Multi Benefícios CARRO R$ 290,00 R$ 29,00 Pago
12 Pedro Henrique Multi Benefícios MOTO R$ 175,00 R$ 17,50 Pago
13 Camila Souza Multi Benefícios CARRO R$ 310,00 R$ 31,00 Pago
14 Ricardo Lima Multi Benefícios UTILITÁRIO R$ 380,00 R$ 38,00 Pago
15 Amanda Oliveira Multi Benefícios CARRO R$ 270,00 R$ 27,00 Pago
16 Thiago Mendes Multi Benefícios MOTO R$ 195,00 R$ 19,50 Pago
17 Beatriz Carvalho Multi Benefícios CARRO R$ 285,00 R$ 28,50 Pago
18 Gabriel Santos Multi Benefícios MOTO R$ 185,00 R$ 18,50 Pago
19 Larissa Rocha Multi Benefícios CARRO R$ 305,00 R$ 30,50 Pago
20 Rodrigo Costa Multi Benefícios UTILITÁRIO R$ 390,00 R$ 39,00 Pago
21 Carolina Dias Multi Benefícios CARRO R$ 295,00 R$ 29,50 Pago
22 Felipe Barbosa Multi Benefícios MOTO R$ 205,00 R$ 20,50 Pago
23 Renata Ferreira Multi Benefícios CARRO R$ 275,00 R$ 27,50 Pago
24 Bruno Nascimento Multi Benefícios MOTO R$ 220,00 R$ 22,00 Atrasado
25 Ana Paula Oliveira ProAuto CARRO R$ 250,00 R$ 25,00 Pago
26 Daniel Gomes ProAuto UTILITÁRIO R$ 150,00 R$ 15,00 Pago
27 Simone Almeida ProAuto CARRO R$ 170,00 R$ 17,00 Pago
28 Marcelo Teixeira ProAuto CARRO R$ 130,00 R$ 13,00 Pago
29 Maria Edvania Silva Tokio Marine CARRO/APP R$ 186,67 R$ 20,00 Pago
30 João Carlos Pereira Tokio Marine CARRO R$ 200,00 R$ 0,00 Renovação
31 Sandra Melo Tokio Marine CARRO R$ 180,00 R$ 0,00 Renovação
32 Claudio Ribeiro Tokio Marine CARRO R$ 170,00 R$ 0,00 Renovação
33 Vanessa Lopes Tokio Marine CARRO R$ 195,00 R$ 0,00 Renovação
34 Marcos Vieira Tokio Marine CARRO R$ 188,33 R$ 0,00 Renovação
TOTAL DE COMISSÕES JANEIRO 2026: R$ 2.100,00 32 Pagos
2 Atrasados
💡 Informações Importantes
📊 Sobre as Comissões: • Multi Benefícios: 24 contratos gerando R$ 1.800/mês (10% de comissão)
• ProAuto: 4 contratos gerando R$ 280/mês (10% de comissão)
• Tokio Marine: Apenas 1 contrato gera comissão mensal (R$ 20,00)
🏢 Tokio Marine (Seguros Convencionais): • 5 contratos aguardando renovação anual (não pagam mensalmente)
• Comissão só será recebida quando o seguro renovar (após 12 meses)
• Marque no calendário para não perder as renovações!
✅ Status dos Pagamentos: • 32 contratos pagos - Receberá dia 10/01/2026
• 2 contratos atrasados - Carlos (R$ 18) e Bruno (R$ 22)
• Entre em contato hoje para regularizar
📈 Resumo Geral: • Total gerando comissão mensal: 29 contratos ativos
• Previsão Janeiro 2026: R$ 2.100,00
• Taxa de sucesso: 94% (excelente!)
• Ticket médio: R$ 61,76 por contrato
🎯 Dica Profissional: Use os filtros acima para consultas específicas: • Filtrar por empresa para análise individual • Filtrar por status para ver só os atrasados • Usar período personalizado para relatórios mensais • Exportar em Excel para enviar ao contador

🏢 Performance por Empresa

Multi Benefícios R$ 1.800
24 contratos ativos
Média: R$ 75,00/contrato
71% do total
ProAuto R$ 280
4 contratos ativos
Média: R$ 70,00/contrato
13% do total
Tokio Marine R$ 20
6 contratos ativos
Média: R$ 3,33/contrato
1% do total
Outras Empresas R$ 0
0 contratos ativos
APVS, Porto, Suhai
0% do total

💡 Insights e Recomendações

✅ Forte concentração na Multi Benefícios (71% das comissões) - considere diversificar
✅ Taxa de adimplência excelente (94%) - mantenha o relacionamento próximo
✅ Ticket médio de R$ 61,76 - oportunidade de upsell em contratos maiores
⚠️ 2 contratos atrasados - entre em contato hoje para regularizar
📈 Potencial de crescimento: dobrar a base em 12 meses = R$ 4.200/mês

⚙️ Configurações do Sistema

Gerencie empresas parceiras e categorias de produtos

📋 Para que serve este módulo? Aqui você configura a base do sistema: as empresas com quem você trabalha e as categorias de produtos. Esses dados alimentam todos os outros formulários!

🏢 Empresas Cadastradas

Multi Benefícios
Proteção Veicular 📊 Comissão: 10% recorrente 📅 Repasse: Dia 10
ProAuto
Proteção Veicular 📊 Comissão: 10-30% recorrente 📅 Repasse: Dia 10
Tokio Marine
Seguradora 📊 Comissão: Única + Renovação
💡 Como isso funciona no React + NestJS?
Frontend (React):
• Componente com formulário de cadastro
• Quando salva, faz POST para API: POST /api/empresas
• Lista carrega com GET: GET /api/empresas

Backend (NestJS):
• Controller recebe a requisição
• Service valida e salva no banco de dados
• Retorna sucesso ou erro para o React

Banco de Dados (MySQL):
• Tabela empresas e categorias já estão no script SQL!