Receitas e Despesas - Receitas

Visão Geral da Interface

O Sistema de Gerenciamento de Receitas de Veículos é uma aplicação 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.

O sistema 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 aplicação está construída 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.

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

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

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

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

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

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

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

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

Acesse a tela de listagem de receitas

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)

Clique no botão de pesquisa (ícone de lupa)

Visualize os resultados na tabela abaixo

Para limpar os filtros, clique no botão "Limpar Filtros"

Como Cadastrar uma Nova Receita

Na tela de listagem, clique no botão "Novo" (ícone +)

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

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

Clique no botão "Gravar" para salvar a receita

Para adicionar anexos, vá para a aba "Anexos" e faça upload dos documentos

Como Inserir Múltiplas Receitas

Na tela de listagem, clique no botão "Inserir múltiplas receitas"

Selecione o veículo comum a todas as receitas

Selecione ou pesquise o motorista

Opcionalmente, selecione uma rota ou viagem

Clique no botão "+" para adicionar uma nova receita

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

Repita o processo para adicionar mais receitas

Quando todas as receitas estiverem adicionadas, clique em "Gravar"

Como Editar ou Excluir uma Receita

Na tela de listagem, clique na linha da receita que deseja editar

Na tela de edição, modifique os campos necessários

Clique em "Gravar" para salvar as alterações

Para excluir a receita, clique no botão "Excluir"

Confirme a exclusão quando solicitado

Como Gerenciar Anexos

Na tela de edição de receita, vá para a aba "Anexos"

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)

Para visualizar um anexo:
- Selecione o anexo na tabela
- Clique em "Ver Anexo"

Para excluir um anexo:
- Selecione o anexo na tabela
- Clique em "Excluir Anexo"
- Confirme a exclusão

Como Exportar Dados para CSV

Na tela de listagem, aplique os filtros desejados para obter os dados

Clique no botão "Exportar para CSV" (ícone de disquete)

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

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.

É 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.

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.

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

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.

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.

Existe limite para o tamanho da descrição da receita?
- Sim, o campo de descrição tem um limite de 400 caracteres.

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

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.

Posso editar várias receitas ao mesmo tempo?
- Não, a edição é individual. Para editar uma receita, selecione-a na tabela de listagem.

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.

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.

É 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.