Receitas e Despesas - Receitas

Visão Geral da Interface

O módulo "RECEITAS" é um módulo web projetada para permitir o registro, monitoramento e administração de receitas relacionadas à frota de veículos de uma empresa. A interface apresenta um layout moderno e intuitivo com uma barra lateral de navegação à esquerda e o conteúdo principal à direita. Este módulo é parte do sistema de gerenciamento de frota "CONCEPT RASTREAMENTO"

Possui três telas principais interligadas:

• Tela de Listagem de Receitas (pesquisa)
• Tela de Edição de Receita (individual)
• Tela de Inserção Múltipla de Receitas

A módulo  está construído com componentes de interface que incluem tabelas de dados, formulários, caixas de seleção, calendários, botões de ação e campos de texto, proporcionando uma experiência de usuário completa para a gestão financeira da frota. Para acessar, clique no menu FROTAS, seção RECEITAS E DESPESAS, opcão RECEITAS.

Elementos da Interface

Tela de Listagem de Receitas

Seção de Filtros

• Veículo: Campo de seleção dropdown com pesquisa que exibe uma lista de veículos disponíveis (placa, modelo e identificador opcional)
• Tipo: Dropdown para selecionar o tipo de receita (exemplo: FRETE, FRETE DURAFIX, TESTE RECEITA)
• Cliente: Dropdown para selecionar o cliente/favorecido associado à receita
• Rota: Campo de texto somente leitura com botão de pesquisa para selecionar rotas através de um popup
• Período: Dois campos de data (início e fim) utilizando calendário para definir o intervalo da pesquisa
• Botões de Ação:
  • Pesquisar: Executa a pesquisa com os filtros aplicados
  • Limpar Filtros: Restaura os filtros para seus valores padrão
  • Novo: Redireciona para a tela de cadastro de nova receita
  • Inserir múltiplas receitas: Redireciona para a tela de inserção de múltiplas receitas
  • Exportar para CSV: Exporta os dados da tabela para um arquivo CSV

Tabela de Resultados

• Colunas da tabela:
  • Numeração sequencial
  • Veículo (placa e identificador opcional)
  • Tipo de receita
  • Grupo
  • Nome
  • Data
  • Valor (R$)
  • Quantidade
  • É de Viagem (Sim/Não)
• Contador de registros na parte inferior da tabela

Tela de Edição de Receita

Abas

• Dados: Formulário principal para edição dos dados da receita
• Anexos: Gestão de documentos anexados à receita, com contador de anexos

Botões Principais

• Gravar: Salva as alterações
• Excluir: Remove o registro (disponível apenas para registros existentes)
• Voltar: Retorna à tela de listagem

Formulário de Dados

• Veículo: Dropdown com pesquisa para selecionar o veículo (obrigatório)
• Motorista: Campo de texto somente leitura com botão de pesquisa para selecionar motorista através de popup (obrigatório)
• Tipo: Dropdown para selecionar o tipo de receita (obrigatório)
• Grupo: Dropdown para selecionar o grupo de receita com código e nome
• Nome: Campo de texto para o nome da receita (obrigatório)
• Cliente: Dropdown para selecionar o cliente relacionado à receita com botão para adicionar novo cliente
• Descrição: Área de texto para detalhamento da receita (limite de 400 caracteres)
• Rota: Campo de texto somente leitura com botões para pesquisar e remover rota
• Viagem: Campo de texto somente leitura com botões para pesquisar e remover viagem
• Data: Campo de data com calendário (obrigatório)
• Quantidade: Campo numérico para quantidade (obrigatório)
• Valor: Campo numérico para valor monetário (obrigatório)

Seção de Anexos

• Tabela de documentos anexados com colunas:
  • Arquivo (nome do documento)
  • Criado às (data e hora)
• Botões para gerenciar anexos:
  • Ver Anexo: Visualiza o documento selecionado
  • Excluir Anexo: Remove o documento selecionado
• Área de upload de arquivos com:
  • Botão para selecionar arquivo
  • Campo para exibir o nome do arquivo selecionado
  • Botão para enviar o arquivo

Tela de Inserção Múltipla de Receitas

Seção de Veículo

• Veículo: Dropdown com pesquisa para selecionar o veículo (obrigatório)
• Motorista: Campo de texto somente leitura com botão de pesquisa para selecionar motorista (obrigatório)
• Rota: Campo de texto somente leitura com botões para pesquisar e remover rota
• Viagem: Campo de texto somente leitura com botões para pesquisar e remover viagem
• Botões Principais:
  • Gravar: Salva todas as receitas inseridas
  • Voltar: Retorna à tela de listagem

Seção de Receitas

• Botão para adicionar nova receita (abre popup)
• Tabela de receitas inseridas com colunas:
  • Numeração sequencial
  • Tipo
  • Grupo
  • Nome
  • Data
  • Quantidade
  • Valor
  • Botão para remover receita

Popup de Inserção de Receita

• Tipo: Dropdown para selecionar o tipo de receita (obrigatório)
• Grupo: Dropdown para selecionar o grupo de receita
• Nome: Campo de texto para o nome da receita (obrigatório)
• Cliente: Dropdown para selecionar o cliente relacionado à receita
• Descrição: Área de texto para detalhamento da receita
• Data: Campo de data com calendário (obrigatório)
• Quantidade: Campo numérico para quantidade (obrigatório)
• Valor: Campo numérico para valor monetário (obrigatório)
• Botões:
  • Inserir: Adiciona a receita à tabela
  • Inserir e Limpar: Adiciona a receita à tabela e limpa o formulário para nova inserção

Validações

• O sistema valida campos obrigatórios:
  • Veículo
  • Motorista
  • Tipo
  • Nome
  • Data
  • Valor
  • Quantidade
• Exibe mensagens de erro quando os campos obrigatórios não são preenchidos
• A tela de inserção múltipla valida que pelo menos uma receita deve ser inserida

Propósito e Fluxo de Trabalho

Propósito

O sistema foi projetado para gerenciar as receitas associadas aos veículos de uma frota, permitindo:

• Registro detalhado de receitas por veículo
• Categorização por tipo e grupo
• Associação com rotas e viagens
• Vinculação a clientes/favorecidos
• Anexação de documentos comprobatórios
• Inserção única ou múltipla de receitas

Fluxo de Trabalho Principal

1. Pesquisa e Visualização:

   • O usuário acessa a tela de listagem
   • Aplica filtros conforme necessário (veículo, período, tipo, etc.)
   • Visualiza os resultados na tabela
   • Pode exportar os dados para CSV

2. Registro de Nova Receita:

   • O usuário clica no botão Novo na tela de listagem
   • Preenche o formulário com os dados da receita
   • Seleciona o veículo e motorista associados
   • Opcionalmente associa a uma rota ou viagem
   • Inclui informações financeiras (valor e quantidade)
   • Salva o registro
   • Opcionalmente adiciona anexos

3. Registro Múltiplo:

   • O usuário clica no botão de inserção múltipla na tela de listagem
   • Seleciona o veículo e motorista comuns a todas as receitas
   • Opcionalmente associa a uma rota ou viagem
   • Adiciona múltiplas receitas através do popup
   • Visualiza a lista de receitas na tabela
   • Finaliza gravando todas as receitas de uma vez

4. Edição e Manutenção:

   • O usuário seleciona um registro na tabela de listagem
   • Visualiza e edita os dados conforme necessário
   • Adiciona ou remove anexos
   • Salva as alterações ou exclui o registro

Instruções Passo a Passo

Como Pesquisar Receitas

1. Acesse a tela de listagem de receitas
2. Selecione os filtros desejados:
   • Escolha um veículo específico (opcional)
   • Selecione um tipo de receita (opcional)
   • Escolha um cliente (opcional)
   • Selecione uma rota usando o botão de pesquisa (opcional)
   • Defina o período de datas (por padrão, é o mês atual)
3. Clique no botão de pesquisa (ícone de lupa)
4. Visualize os resultados na tabela abaixo
5. Para limpar os filtros, clique no botão "Limpar Filtros"

Como Cadastrar uma Nova Receita

1. Na tela de listagem, clique no botão "Novo" (ícone +)
2. Na tela de edição, preencha os campos obrigatórios:
   • Selecione o veículo na lista suspensa
   • Selecione ou pesquise o motorista
   • Escolha o tipo de receita
   • Digite um nome para a receita
   • Informe a data da receita
   • Digite a quantidade e o valor
3. Preencha os campos opcionais conforme necessário:
   • Selecione um grupo
   • Escolha um cliente
   • Adicione uma descrição detalhada
   • Associe a uma rota ou viagem específica
4. Clique no botão "Gravar" para salvar a receita
5. Para adicionar anexos, vá para a aba "Anexos" e faça upload dos documentos

Como Inserir Múltiplas Receitas

1. Na tela de listagem, clique no botão "Inserir múltiplas receitas"
2. Selecione o veículo comum a todas as receitas
3. Selecione ou pesquise o motorista
4. Opcionalmente, selecione uma rota ou viagem
5. Clique no botão "+" para adicionar uma nova receita
6. No popup que aparece:
   • Preencha todos os campos obrigatórios
   • Clique em "Inserir" para adicionar à lista ou "Inserir e Limpar" para adicionar e preparar nova inserção
7. Repita o processo para adicionar mais receitas
8. Quando todas as receitas estiverem adicionadas, clique em "Gravar"

Como Editar ou Excluir uma Receita

1. Na tela de listagem, clique na linha da receita que deseja editar
2. Na tela de edição, modifique os campos necessários
3. Clique em "Gravar" para salvar as alterações
4. Para excluir a receita, clique no botão "Excluir"
5. Confirme a exclusão quando solicitado

Como Gerenciar Anexos

1. Na tela de edição de receita, vá para a aba "Anexos"
2. Para adicionar um novo anexo:
   • Clique em "Selecione o arquivo"
   • Escolha o arquivo do seu computador
   • Clique no botão de upload (ícone de seta para cima)
3. Para visualizar um anexo:
   • Selecione o anexo na tabela
   • Clique em "Ver Anexo"
4. Para excluir um anexo:
   • Selecione o anexo na tabela
   • Clique em "Excluir Anexo"
   • Confirme a exclusão

Como Exportar Dados para CSV

1. Na tela de listagem, aplique os filtros desejados para obter os dados
2. Clique no botão "Exportar para CSV" (ícone de disquete)
3. O arquivo será gerado e baixado automaticamente

Regras de Negócio e Funcionamento

Gestão de Veículos e Motoristas

• Os veículos exibidos são apenas os ativos para o cliente logado
• Ao selecionar um veículo, o sistema pode preencher automaticamente o motorista associado
• É possível selecionar outro motorista através do popup de pesquisa
• Veículos com marcação "HISTÓRICO" não podem ser selecionados

Associação com Rotas e Viagens

• Uma receita pode estar associada a uma rota OU a uma viagem, nunca ambas
• Ao selecionar uma rota, qualquer viagem selecionada será desmarcada e vice-versa
• A seleção de rota ou viagem requer que um veículo seja selecionado primeiro
• Quando uma receita está associada a uma rota ou viagem, ela é marcada como "É DE VIAGEM"

Permissões e Controle de Acesso

• O sistema verifica se o usuário tem permissão para gravar/alterar receitas
• Existem diferentes níveis de acesso: individual, grupo e master
• Usuários com acesso "master" ou com capacidade "master" no grupo podem realizar todas as operações
• O botão de exclusão só é exibido para registros existentes

Processamento de Múltiplas Receitas

• Ao inserir múltiplas receitas, todos os itens compartilham o mesmo veículo e motorista
• É necessário inserir pelo menos uma receita para poder gravar
• Cada receita na lista pode ter suas próprias informações de tipo, cliente, valor, etc.
• O sistema processa todas as receitas em um único lote quando o usuário grava

Gestão de Anexos

• Os anexos são armazenados em um servidor S3 (Amazon)
• O sistema permite visualizar os documentos diretamente no navegador
• A exclusão de anexos remove o registro do banco de dados e possivelmente do armazenamento

Perguntas Frequentes

Gerais

1. Como faço para filtrar receitas de um período específico?

   • Na tela de listagem, ajuste os campos de data de início e fim no filtro "Período" e clique no botão de pesquisa.

2. É possível cadastrar várias receitas para o mesmo veículo de uma só vez?

   • Sim, use a funcionalidade "Inserir múltiplas receitas" que permite cadastrar várias receitas para o mesmo veículo em uma única operação.

3. Como associo uma receita a uma viagem específica?

   • Na tela de edição de receita, clique no botão de pesquisa ao lado do campo "Viagem" e selecione a viagem desejada no popup que aparece.

4. Posso anexar comprovantes às receitas?

   • Sim, na aba "Anexos" da tela de edição você pode fazer upload de documentos relacionados à receita.

Validação e Campos

1. Quais campos são obrigatórios para cadastrar uma receita?

   • Os campos obrigatórios são: Veículo, Motorista, Tipo, Nome, Data, Valor e Quantidade.

2. Posso associar uma receita a uma rota e uma viagem ao mesmo tempo?

   • Não, uma receita pode estar associada apenas a uma rota OU a uma viagem, nunca ambas simultaneamente.

3. Existe limite para o tamanho da descrição da receita?

   • Sim, o campo de descrição tem um limite de 400 caracteres.

4. Como seleciono um veículo que não aparece na lista?

   • Apenas veículos ativos são exibidos. Se o veículo não aparece, pode estar inativo ou não pertencer ao cliente logado. Entre em contato com o administrador do sistema.

Operações Específicas

1. Como exporto minhas receitas para um relatório?

   • Na tela de listagem, aplique os filtros desejados e clique no botão "Exportar para CSV" para baixar os dados.

2. Posso editar várias receitas ao mesmo tempo?

   • Não, a edição é individual. Para editar uma receita, selecione-a na tabela de listagem.

3. O que acontece se eu excluir uma receita?

   • A exclusão remove permanentemente a receita do sistema, incluindo seus anexos. Esta operação não pode ser desfeita.

4. Como faço para ver todas as receitas do mês atual?

   • Na tela de listagem, clique em "Limpar Filtros" (que define o período para o mês atual por padrão) e depois clique no botão de pesquisa.

5. É possível pesquisar receitas por cliente?

   • Sim, use o filtro "Cliente" na tela de listagem para encontrar todas as receitas associadas a um cliente específico.