Francisco

Projetos (Aguardando Propostas):

• Portal para representantes comerciais

  Desenvolvimento Web | Orçamento: Aberto | Publicado: | Propostas: 27

  1. Objetivo do sistema
  Criar um portal para representantes comerciais de uma empresa de maquininhas de cartão, com envio e aprovação de cadastros de clientes, controle de TPV e comissões (atualizados mensalmente pela equipe interna), envio de Nota Fiscal antes do pagamento e cadastro de dados bancários para depósito.
  
  2. Perfis de usuário
  2.1 Representante
  Cadastrar clientes e enviar documentos.
  
  Acompanhar status de aprovação dos clientes.
  
  Ver TPV e comissão mensal (após atualização pela equipe interna).
  
  Enviar Nota Fiscal para receber comissão.
  
  Cadastrar e atualizar dados bancários.
  
  Acompanhar histórico de comissões.
  
  2.2 Equipe interna
  Analisar e aprovar ou reprovar cadastros de clientes.
  
  Atualizar TPV e calcular comissão mensal.
  
  Receber e validar Nota Fiscal antes do pagamento.
  
  Marcar comissões como pagas.
  
  Visualizar e editar dados bancários dos representantes.
  
  Gerar relatórios.
  
  3. Módulos do sistema
  3.1 Login
  Autenticação por e-mail e senha.
  
  Função de recuperação de senha.
  
  Permissão para definir perfil (Representante ou Equipe Interna).
  
  3.2 Cadastro de clientes
  Campos obrigatórios:
  
  Nome completo / Razão Social
  
  CPF/CNPJ
  
  Telefone
  
  E-mail
  
  Endereço
  
  Upload de documentos (RG, Contrato, Comprovante) – até 3 arquivos por cliente.
  
  Fluxo:
  
  Representante preenche e envia cadastro.
  
  Sistema gera status inicial: Em análise.
  
  Equipe interna aprova ou reprova.
  
  Status possíveis:
  
  Em análise
  
  Aprovado
  
  Reprovado
  
  Observações internas visíveis apenas para equipe interna.
  
  3.3 Módulo de TPV e comissão
  Campos:
  
  TPV do mês (valor numérico).
  
  Comissão do mês (calculada automaticamente).
  
  Status do pagamento.
  
  Fluxo mensal:
  
  Equipe interna atualiza TPV manualmente.
  
  Sistema calcula comissão com base na regra configurada:
  
  Exemplo: R$ 450 a cada R$ 100.000 de TPV (parâmetro configurável).
  
  Status inicial da comissão: Aguardando NF.
  
  3.4 Envio e aprovação de Nota Fiscal
  Fluxo:
  
  Quando comissão está como “Aguardando NF”, representante anexa:
  
  NF em PDF (obrigatório).
  
  XML da NF (opcional).
  
  Status muda para NF enviada.
  
  Equipe interna confere NF:
  
  Aprova? Status muda para Pendente Pagamento.
  
  Recusa? Volta para Aguardando NF com observação.
  
  Após pagamento, status final: Pago.
  
  Status possíveis da comissão:
  
  Aguardando NF
  
  NF enviada
  
  NF aprovada
  
  NF recusada
  
  Pendente Pagamento
  
  Pago
  
  3.5 Módulo de dados bancários
  Campos:
  
  Nome do titular
  
  CPF/CNPJ do titular
  
  Banco (lista ou texto)
  
  Agência
  
  Conta
  
  Tipo de conta (Corrente / Poupança / PJ)
  
  Chave Pix (CPF, CNPJ, e-mail ou telefone)
  
  Regras:
  
  Representante deve ter dados bancários preenchidos para enviar NF.
  
  Alteração de dados bancários gera notificação para equipe interna.
  
  Histórico de alterações armazenado.
  
  Equipe interna pode editar dados bancários.
  
  3.6 Relatórios
  Por representante: Clientes aprovados, TPV mensal, comissão gerada, status de pagamento.
  
  Por período: Total geral de TPV e comissões.
  
  Exportar CSV/PDF.
  
  Filtro por status de comissão.
  
  4. Tecnologias sugeridas
  Frontend: React.js ou Vue.js.
  
  Backend: Laravel (PHP) ou Node.js (JavaScript).
  
  Banco de dados: MySQL ou PostgreSQL.
  
  Armazenamento de arquivos: AWS S3 ou Google Cloud Storage.
  
  Hospedagem: AWS, DigitalOcean ou Hostinger Cloud.
  
  Autenticação: JWT.
  
  5. Regras de negócio
  Comissão só é paga se houver NF aprovada.
  
  TPV é atualizado apenas pela equipe interna, 1x ao mês.
  
  Representante só vê informações dos seus clientes e suas comissões.
  
  Equipe interna tem acesso a todos os cadastros e relatórios.
  
  Sistema deve armazenar histórico de alterações de dados bancários e status.