Movimentações de Combustível

Visão Geral

O módulo de Movimentações de Combustível é uma ferramenta de gerenciamento que permite controlar e rastrear a transferência de combustível entre diferentes tanques de armazenamento. Este módulo faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO, permitindo que os usuários registrem e monitorem o movimento de combustível dentro da organização. Para acessar a opção utilize o menu FROTAS e a seção ABASTECIMENTO INTERNO e  opção MOVIMENTAÇÕES DE COMBUSTÍVEL.

Descrição da Interface

Tela de Pesquisa (Listagem)

A tela principal apresenta uma interface organizada em duas seções principais:

1. Seção de Filtros - Localizada na parte superior, permite refinamento das buscas
2. Tabela de Resultados - Exibe os registros de movimentação em formato tabular

Elementos da Seção de Filtros:

• Número Tanque de Combustível Origem - Campo de texto para filtrar pelo número do tanque de origem
• Período - Dois seletores de data que permitem definir um intervalo de datas para a pesquisa
• Número Tanque de Combustível Destino - Campo de texto para filtrar pelo número do tanque de destino
• Botões de Ação:
  • Pesquisar (ícone de lupa) - Executa a pesquisa com os filtros aplicados
  • Limpar Filtros (ícone de arquivo) - Restaura os valores padrão dos filtros
  • Novo (ícone de adição) - Abre a tela para registrar uma nova movimentação
  • Exportar para CSV (ícone de salvar) - Exporta os dados da tabela para um arquivo CSV

Elementos da Tabela de Resultados:

• Colunas da Tabela:

  • # - Número sequencial do registro na listagem
  • DATA - Data e hora da movimentação
  • TANQUE ORIGEM - Identificador do tanque de origem
  • TANQUE DESTINO - Identificador do tanque de destino
  • QTD - Quantidade de combustível transferida (em litros)

• Contador de Registros - Exibe o total de registros encontrados na pesquisa atual

Tela de Cadastro/Edição

A segunda tela é utilizada para criar novas movimentações ou visualizar detalhes de movimentações existentes:

Elementos da Tela de Cadastro:

• Tanque de Combustível Origem - Campo de seleção com botão de busca para escolher o tanque de origem
• Tanque de Combustível Destino - Campo de seleção com botão de busca para escolher o tanque de destino
• Data da Movimentação - Seletor de data e hora para registrar quando ocorreu a transferência
• Quantidade - Campo numérico para informar a quantidade de combustível transferida (em litros)
• Botões de Ação:
  • Gravar - Salva a movimentação no sistema
  • Excluir - Remove a movimentação (disponível apenas para registros existentes)
  • Voltar - Retorna à tela de pesquisa sem salvar alterações

Seção de Validação de Erros:

Quando há erros de preenchimento, o sistema exibe um painel de alerta com os campos que precisam ser corrigidos, como:

• Tanque de Combustível Origem obrigatório
• Tanque de Combustível Destino obrigatório
• Data de Movimentação obrigatória
• Quantidade obrigatória

Fluxo de Trabalho

Propósito Principal

Este módulo foi desenvolvido para:

• Gerenciar a transferência de combustível entre tanques
• Manter registro histórico das movimentações
• Controlar o estoque de combustível em cada tanque
• Garantir que todas as transferências sejam rastreáveis

Fluxo de Trabalho Básico

1. O usuário acessa a tela de pesquisa para visualizar as movimentações existentes
2. Opcionalmente, aplica filtros para localizar movimentações específicas
3. Para criar uma nova movimentação, clica no botão "Novo"
4. Na tela de cadastro, seleciona os tanques de origem e destino
5. Define a data/hora da movimentação e a quantidade transferida
6. Grava a informação, que será validada pelo sistema
7. Retorna à tela de pesquisa onde a nova movimentação já aparecerá listada

Instruções Passo a Passo

Como Realizar uma Pesquisa

1. Acesse a tela de Movimentações de Combustível
2. Na seção de filtros, preencha os campos desejados:
   • Digite o número do tanque de origem (opcional)
   • Selecione o período de datas (opcional)
   • Digite o número do tanque de destino (opcional)
3. Clique no botão com ícone de lupa (Pesquisar)
4. Os resultados serão exibidos na tabela abaixo
5. Para limpar os filtros e recomeçar, clique no botão com ícone de arquivo

Como Registrar uma Nova Movimentação

1. Na tela de pesquisa, clique no botão "Novo" (ícone de adição)
2. Na tela de cadastro que será aberta:
   • Clique no botão de busca ao lado do campo "Tanque de Combustível Origem"
   • Selecione o tanque desejado na janela popup
   • Clique em "OK" para confirmar
   • Repita o processo para selecionar o "Tanque de Combustível Destino"
   • Defina a data e hora da movimentação no campo correspondente
   • Informe a quantidade de combustível transferida (em litros)
3. Clique no botão "Gravar" para salvar
4. Se todos os campos estiverem preenchidos corretamente, o sistema salvará a movimentação
5. Caso contrário, serão exibidas mensagens de erro indicando os campos que precisam ser corrigidos

Como Exportar Dados para CSV

1. Na tela de pesquisa, aplique os filtros desejados para refinar os resultados
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. O sistema gerará um arquivo CSV contendo os dados da tabela
4. O arquivo será nomeado como "CompraCombustivel.csv"

Regras de Negócio e Validações

Validações da Interface:

1. Campos Obrigatórios:

   • Tanque de Combustível Origem
   • Tanque de Combustível Destino
   • Data da Movimentação
   • Quantidade

2. Validações de Formulário:

   • Todos os campos obrigatórios devem ser preenchidos antes de gravar

Regras de Negócio do Backend:

1. Validações de Data:

   • A data da movimentação não pode ser futura (deve ser igual ou anterior à data atual)

2. Validações de Estoque:

   • A quantidade transferida não pode exceder a capacidade do tanque de destino
   • O estoque do tanque de origem não pode ficar negativo após a transferência

3. Validações de Compatibilidade:

   • Os tanques de origem e destino devem conter o mesmo tipo de combustível

4. Validações de Integridade:

   • Não é possível alterar uma movimentação existente (apenas inserir novas ou excluir)
   • Não é possível excluir movimentações se houver abastecimentos ou compras registrados após a data da movimentação

5. Restrições Temporais:

   • Não é possível registrar movimentações se existirem abastecimentos ou compras posteriores à data da movimentação

Perguntas Frequentes

Dúvidas Comuns

1. Por que não consigo alterar uma movimentação existente?

   O sistema não permite a alteração de movimentações para manter a integridade do histórico de estoque. Se uma movimentação foi registrada incorretamente, é necessário excluí-la e criar uma nova.

2. Por que recebo um erro sobre a capacidade do tanque de destino?

   Esta mensagem aparece quando a quantidade que você está tentando transferir, somada ao estoque atual do tanque de destino, excederia a capacidade total do tanque. Verifique a capacidade e o estoque atual do tanque de destino.

3. Por que não consigo excluir uma movimentação?

   Movimentações não podem ser excluídas se existirem abastecimentos ou compras registrados com data posterior à movimentação, pois isso afetaria a consistência do estoque. Você precisará primeiro excluir esses registros posteriores.

4. Por que aparece um erro sobre tipos de combustível diferentes?

   O sistema não permite transferir combustível entre tanques de tipos diferentes. Verifique se os tanques de origem e destino armazenam o mesmo tipo de combustível.

5. Como verifico o estoque atual de um tanque antes de fazer a movimentação?

   O sistema verifica automaticamente o estoque do tanque de origem e a capacidade do tanque de destino. Se a movimentação não for possível, uma mensagem de erro específica será exibida.

6. A data da movimentação precisa ser a data atual?

   Não, a data pode ser anterior à data atual, mas não pode ser futura. No entanto, movimentações com data retroativa podem ser impedidas se existirem abastecimentos ou compras registrados após essa data.

7. Posso filtrar as movimentações por tipo de combustível?

   A interface atual não possui um filtro direto por tipo de combustível, mas você pode filtrar pelo número do tanque, que indiretamente filtra pelo tipo de combustível associado a esse tanque.

8. Como sei qual é a capacidade disponível em um tanque?

   Ao tentar registrar uma movimentação que exceda a capacidade do tanque de destino, o sistema exibirá uma mensagem informando a capacidade total e o estoque atual do tanque.

9. O que significa o erro "Estoque atual do tanque de origem não pode ficar negativo"?

   Esta mensagem indica que você está tentando transferir mais combustível do que o disponível no tanque de origem. Verifique o estoque atual do tanque antes de realizar a movimentação.

10. É possível fazer transferências parciais de combustível?

    Sim, você pode especificar qualquer quantidade válida no campo "Quantidade", desde que não exceda o estoque do tanque de origem nem a capacidade disponível do tanque de destino.