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