Controle de Viagens

O módulo "Viagens" é uma solução completa para administrar e monitorar a operação de veículos de uma frota. O módulo permite o planejamento, execução, monitoramento e análise histórica de viagens, oferecendo recursos para gerenciar rotas, motoristas, equipamentos e documentar todo o ciclo logístico de transporte.

Para acessar clique no menu VIAGENS opção CONTROLE DE VIAGENS.

Descrição Geral

A tela principal do módulo apresenta uma visão consolidada de todos os veículos da frota e suas respectivas viagens programadas ou em andamento. A interface é organizada de maneira intuitiva, permitindo visualizar rapidamente o status de cada veículo através de um sistema de cores e indicadores visuais.

Elementos da Interface

Seção Superior: Filtros e Controles

• Filtro de Status de Viagem: Menu suspenso que permite filtrar viagens por status (Todos, Sem viagem, Não Iniciadas, Em Viagem, Em Viagem Atrasado, Finalizadas, Saída Adiantada, Saída Atrasada, Chegada Adiantada, Chegada Atrasada)
• Filtro de Divisão: Menu suspenso para filtrar veículos por divisão organizacional
• Filtro de Tipo de Data: Menu suspenso com opções (Previsão Saída, Previsão Retorno, Saída Realizada, Retorno Realizado)
• Operador para Filtro de Data: Menu suspenso com opções (=, <, <=, >, >=)
• Data do Filtro: Seletor de data e hora para especificar o valor da data para filtro
• Campo de Pesquisa: Campo texto para busca por placas, motoristas ou outras informações
• Legenda de Cores: Indicadores visuais explicando o significado das cores (Em Viagem, Finalizada, Atrasado, Adiantado)
• Contador de Veículos: Exibe o número total de veículos filtrados
• Botão de Histórico: Acesso ao histórico completo de viagens
• Botão de Sumário: Acesso à visão resumida e agrupada de viagens
• Alternador de Visualização: Permite alternar entre visualização de lista e visualização de pistas (timelines)

Visualização de Pistas (Timelines)

Para cada veículo, exibe:

• Placa do Veículo: Identificador único do veículo
• Datas Planejadas: Horários previstos de saída e retorno
• Datas Realizadas: Horários efetivos de saída e retorno (quando disponível)
• Pontos de Origem e Destino: Locais de saída e chegada
• Motorista: Nome do condutor responsável
• Contato do Motorista: Telefone para contato (quando disponível)
• Progresso da Viagem: Barra visual indicando o progresso percentual da viagem
• Informações Adicionais: Tempo e distância restantes, localização atual
• Botões de Ação: Nova viagem, Nova viagem simples, Histórico, Cancelar, Alterar

Visualização em Lista

Para cada veículo, exibe em formato tabular:

• Veículo: Informações do veículo e equipamentos associados
• De/Para: Pontos de origem e destino e identificador da viagem
• Local Atual: Cidade ou localidade onde o veículo se encontra
• Deadline: Tempo restante para conclusão prevista
• Tempo/KM Restante: Tempo e distância estimados para conclusão
• Progresso: Percentual de completude e distância total
• Previsão: Datas planejadas de saída e retorno
• Realizado: Datas efetivas de saída e retorno
• Botões de Ação: Mesmos da visualização de pistas

Códigos de Cores e Indicadores Visuais

• Branco: Veículo sem viagem ou com viagem não iniciada
• Amarelo: Viagem em andamento
• Azul: Viagem finalizada
• Vermelho: Indicação de atraso
• Verde: Indicação de adiantamento
• Ícones: Indicadores para status de aceite do motorista, telefone, etc.

Interface de Edição de Viagem

Descrição Geral

Esta tela permite criar uma nova viagem ou editar detalhes de uma viagem existente. Inclui um formulário completo de dados da viagem e um mapa interativo para visualização e planejamento de rotas.

Elementos da Interface

Seção de Informações Básicas

• Identificador: Campo texto para referência única da viagem (obrigatório)
• Motorista: Campo de seleção de motorista com busca (obrigatório)
• Ajudantes: Contador numérico para quantidade de ajudantes
• Data de Saída: Seletor de data e hora para saída planejada (obrigatório)
• Data de Retorno: Seletor de data e hora para retorno planejado (obrigatório)
• Período: Menu suspenso com opções de período (mês/ano) (obrigatório)

Seção de Rota

• De (Origem): Menu suspenso para selecionar ponto de interesse de saída (obrigatório)
• Para (Destino): Menu suspenso para selecionar ponto de interesse de chegada (obrigatório)
• Região Atendida: Campo texto para região geográfica atendida (obrigatório)
• Zona: Menu suspenso para seleção da zona logística (obrigatório)
• Controlar Itinerário: Alternador (Sim/Não) para habilitar controle detalhado de rota
• Botão Itinerário: Acessa modal para definição de pontos intermediários da rota

Seção de Métricas

• Quantidade de Cidades: Campo numérico para número de cidades na rota (obrigatório)
• Quantidade de Entregas: Campo numérico para número de entregas previstas (obrigatório)
• Peso: Campo numérico para peso total transportado (obrigatório)
• Valor: Campo numérico para valor total transportado (obrigatório)
• Adiantamento Custo: Campo numérico para valor de adiantamento ao motorista

Seção de Equipamentos

• Equipamento Principal: Menu suspenso para seleção de implemento/reboque
• Equipamento 2: Menu suspenso para seleção de equipamento adicional
• Equipamento 3: Menu suspenso para seleção de equipamento adicional

Seção de Configurações

• Permitir iniciar antes?: Caixa de seleção para autorizar início antecipado
• Iniciar somente com aceite?: Caixa de seleção para exigir aceite do motorista
• Alterar motorista ao iniciar?: Caixa de seleção para permitir alteração de motorista
• Aceite Motorista: Menu suspenso para status de aceite (S/N)

Seção de Mapa

• Mapa Interativo: Visualização geográfica da rota com pontos de origem, destino e intermediários
• Indicadores de Distância: Cálculo automático de distância total em KM
• Indicadores de Tempo: Cálculo automático de tempo estimado de percurso
• Indicadores de Consumo: Cálculo estimado de litros de combustível

Botões de Ação

• Importar: Para importar dados de viagem de arquivo XLS
• Gravar: Para salvar as informações da viagem
• Voltar: Para retornar à tela principal sem salvar
• Ocorrências: Para registrar problemas ou situações especiais (disponível em viagens existentes)

Modal de Itinerário de Viagem

Elementos do Modal

• Rotas de Viagens: Menu suspenso com rotas pré-definidas
• Ponto de Interesse: Menu suspenso para seleção de pontos intermediários
• Lista de Cidades: Tabela com cidades/pontos incluídos no itinerário
• Botões de Ação: Adicionar, Remover, Mover para cima, Mover para baixo (para reordenar)
• Botões de Confirmação: OK, Fechar

Interface de Edição Simples de Viagem

Descrição Geral

Versão simplificada da tela de edição de viagem, com menos campos e foco em registros rápidos de deslocamentos.

Elementos da Interface

Similar à interface de edição completa, porém com menos campos obrigatórios e sem a necessidade de detalhar completamente a rota.

Interface do Histórico de Viagens

Descrição Geral

Tela que apresenta o histórico de viagens realizadas, permitindo consulta, análise e edição de registros passados.

Elementos da Interface

Seção de Filtros

• Período: Campos de data de início e fim para filtrar período
• Motorista: Menu suspenso para filtrar por motorista específico
• Botão de Pesquisa: Para aplicar os filtros definidos

Tabela de Resultados

Colunas:

• Ação: Botões para excluir viagem, ajustar datas, informar valores de devolução e gerar relatório
• Veículo: Identificação do veículo utilizado
• Previsão: Datas planejadas de saída e retorno
• Realizado: Datas efetivas de saída e retorno
• Identificador: Código da viagem e nome do motorista
• KM: Quilometragem percorrida
• Duração: Tempo total da viagem e tempo com veículo ligado
• Quantidades: Número de entregas e cidades
• Peso: Peso total transportado
• Valor: Valor transportado e informações de devolução
• Região Atendida: Área geográfica coberta

Modais Adicionais

Modal de Ajuste de Datas

Permite ajustar as datas reais de saída e retorno de viagens já realizadas.

Elementos do Modal

• Data Saída Realizada Atual: Exibe a data atual registrada
• Data Retorno Realizada Atual: Exibe a data atual registrada
• Nova Data Saída Realizada: Campo para inserir a nova data
• Nova Data Retorno Realizada: Campo para inserir a nova data
• Botão Gravar: Para salvar as alterações

Modal de Devolução e Reentrega

Permite registrar valores relacionados a devoluções e reentregas de mercadorias.

Elementos do Modal

• Valor Adiantamento: Exibe o valor adiantado ao motorista
• Valor Adiantamento Devolvido: Campo para registro do valor devolvido
• Seção Devolução: Campos para quantidade, valor e peso de itens devolvidos
• Seção Reentrega: Campos para quantidade, valor e peso de itens para reentrega
• Botão Gravar: Para salvar as informações

Modal de Espelho da Viagem

Exibe relatório detalhado de uma viagem específica.

Elementos do Modal

• Controles de Navegação: Botões para avançar, retroceder, zoom
• Botões de Exportação: Opções para exportar em PDF, XLS, TXT, RTF
• Relatório: Exibe todas as informações da viagem, incluindo dados financeiros, métricas e detalhamentos

Fluxo de Trabalho

O sistema segue um fluxo de trabalho completo para o gerenciamento de viagens:

1. Planejamento da Viagem:

   • Criação da viagem com definição de datas, motorista, rota e valores
   • Opcionalmente, detalhamento do itinerário com pontos intermediários
   • Associação de equipamentos e atribuição de valores de adiantamento

2. Execução da Viagem:

   • Registro automático ou manual do início da viagem
   • Monitoramento em tempo real da posição e progresso da viagem
   • Visualização de desvios em relação ao planejado (atrasos, adiantamentos)

3. Finalização da Viagem:

   • Registro automático ou manual do término da viagem
   • Registro de dados de devolução e reentrega, quando aplicáveis
   • Documentação dos valores finais, distâncias e tempos

4. Análise e Relatórios:

   • Geração de relatório espelho da viagem
   • Análise de métricas e desempenho
   • Ajustes de dados, quando necessário

Instruções Passo a Passo

Como Criar uma Nova Viagem

1. Na tela principal, localize o veículo desejado
2. Clique no botão "Nova viagem" (ícone "+") à direita do veículo
3. Preencha o campo "Identificador" com uma referência única
4. Selecione o motorista clicando no ícone de busca ao lado do campo
5. Defina as datas de saída e retorno previstas
6. Selecione o período correspondente
7. Nos campos "DE" e "PARA", selecione os pontos de interesse de origem e destino
8. Preencha a região atendida e selecione a zona
9. Informe a quantidade de cidades, entregas, peso e valor transportado
10. Se necessário, selecione equipamentos adicionais nas listas suspensas
11. Configure as opções de permissão conforme necessário
12. Se desejar controlar o itinerário detalhado, ative a opção "Controlar Percurso" e clique em "Itinerário"
13. No modal de itinerário, adicione os pontos intermediários e organize a sequência
14. Verifique a rota gerada no mapa e os cálculos de distância e tempo
15. Clique em "Gravar" para salvar a viagem

Como Monitorar Viagens em Andamento

1. Na tela principal, verifique as viagens marcadas em amarelo (em andamento)
2. Observe o progresso percentual na barra de progresso ou gráfico
3. Verifique informações de tempo e distância restantes
4. Consulte a localização atual do veículo
5. Identifique possíveis atrasos marcados em vermelho

Como Finalizar uma Viagem Manualmente

1. Na tela principal, localize a viagem em andamento
2. Clique no botão "Finalizar" (ícone "stop")
3. No modal exibido, confirme a data e hora de retorno ou ajuste conforme necessário
4. Preencha as informações de odômetro e horímetro se solicitado
5. Clique em "Gravar" para registrar a finalização

Como Ajustar Dados de uma Viagem Concluída

1. Na tela principal, clique no botão "Histórico" (ícone de lista)
2. Filtre o período desejado e/ou motorista específico
3. Localize a viagem a ser ajustada
4. Para ajustar datas, clique no ícone correspondente e modifique as datas no modal
5. Para registrar devoluções, clique no ícone de dinheiro e preencha os valores
6. Para gerar relatório, clique no ícone de impressora
7. Para excluir a viagem, clique no ícone de lixeira (disponível apenas para viagens finalizadas)

Como Importar Dados de Viagem

1. Na tela de criação de viagem, clique no botão "Importar"
2. No modal exibido, selecione o arquivo XLS gerado pela rotina 967 do WINTHOR
3. Clique em "Importar" para processar o arquivo
4. Verifique os dados carregados e complemente informações faltantes
5. Clique em "Gravar" para salvar a viagem importada

Regras de Negócio e Validações

Validações Principais

1. Campos Obrigatórios:

   • Identificador da viagem
   • Motorista
   • Data de saída e retorno previstas
   • Pontos de origem e destino
   • Região atendida e zona
   • Quantidades (cidades, entregas)
   • Peso e valor transportado

2. Validações de Data:

   • A data de retorno deve ser posterior à data de saída
   • Para ajustes manuais, a data de saída deve ser anterior à de retorno

3. Validações de Equipamentos:

   • Não é permitido selecionar o mesmo equipamento mais de uma vez
   • Equipamentos 2 e 3 só podem ser selecionados se o equipamento anterior estiver definido

4. Validações de Rota:

   • Para gerar uma rota válida, os pontos de origem e destino devem estar definidos
   • Se controle de itinerário estiver ativo, deve haver pelo menos uma linha na rota

5. Validações de Valores:

   • O valor devolvido não pode ser maior que o valor do adiantamento
   • Valores numéricos não podem ser negativos

Comportamentos Especiais

1. Cálculo de Datas:

   • O sistema pode calcular automaticamente a data de retorno com base na duração estimada da rota
   • O cálculo considera horários de trabalho (8h às 18h) e intervalos de almoço (11h às 14h)

2. Status de Viagem:

   • Viagens são marcadas como "Em Viagem" quando iniciadas e sem retorno registrado
   • Viagens são marcadas como "Finalizadas" quando têm saída e retorno registrados
   • Atrasos e adiantamentos são calculados comparando datas previstas e realizadas

3. Aceite do Motorista:

   • Se "Iniciar somente com aceite" estiver ativo, a viagem só pode iniciar após confirmação
   • O motorista pode recusar a viagem, incluindo motivo da recusa

4. Controle de Percurso:

   • Quando ativo, o sistema monitora a aderência à rota planejada
   • A visualização da rota requer pontos de origem e destino definidos

Perguntas Frequentes

Perguntas Gerais

1. Como faço para visualizar todas as viagens em andamento?

   • Na tela principal, selecione "Em Viagem" no filtro de status.

2. Como calculo automaticamente a data prevista de retorno?

   • Ao criar uma viagem, defina os pontos de origem e destino, depois clique no ícone de calendário ao lado do campo de data de retorno.

3. Por que minha rota não está sendo gerada no mapa?

   • Verifique se os pontos de origem e destino estão corretamente selecionados. Ambos são obrigatórios para o cálculo da rota.

4. Posso alterar um motorista após a viagem iniciada?

   • Sim, se a opção "Alterar motorista ao iniciar" estiver ativada.

5. Como faço para registrar uma devolução de mercadoria?

   • No histórico de viagens, localize a viagem finalizada e clique no ícone de dinheiro para abrir o modal de devolução e reentrega.

Perguntas sobre Monitoramento

1. O que significam as cores na visualização de viagens?

   • Branco: sem viagem ou não iniciada
   • Amarelo: em andamento
   • Azul: finalizada
   • Vermelho: indicação de atraso
   • Verde: indicação de adiantamento

2. Como sei se uma viagem está atrasada?

   • As viagens atrasadas são marcadas em vermelho e mostram o tempo de atraso.

3. Como posso ver a localização atual de um veículo?

   • Na tela principal, a localização atual é exibida na coluna "Local Atual".

4. O que significa o percentual na barra de progresso?

   • Representa o progresso da viagem com base na distância percorrida em relação à distância total planejada.

Perguntas sobre Relatórios

1. Como gero um relatório completo de uma viagem?

   • No histórico de viagens, clique no ícone de impressora para acessar o espelho da viagem.

2. Quais formatos de exportação estão disponíveis?

   • Os relatórios podem ser exportados em PDF, XLS, TXT e RTF.

3. Como visualizo um resumo de todas as viagens do mês?

   • Na tela principal, clique no botão "Sumário" para ver estatísticas agrupadas.

Perguntas Técnicas

1. Por que não consigo importar meu arquivo XLS?

   • Verifique se o arquivo segue o formato da rotina 967 do WINTHOR com o tipo "Resumo de Carregamento por Placa".

2. Como faço para corrigir uma data de viagem registrada incorretamente?

   • No histórico, use a opção de ajuste de datas para modificar as datas realizadas.

3. Como posso cancelar uma viagem já iniciada?

   • Viagens iniciadas não podem ser canceladas, apenas finalizadas normalmente ou excluídas após a finalização.

4. Por que o campo de motorista não mostra todos os condutores?

   • O sistema filtra apenas motoristas ativos. Verifique se o motorista desejado está marcado como ativo no cadastro.

5. O que acontece se eu tentar excluir uma viagem finalizada?

   • A viagem será removida do histórico, mas suas métricas podem já ter sido contabilizadas em relatórios gerados anteriormente.

Esta documentação abrange os principais aspectos do Sistema de Gerenciamento de Viagens e Controle de Frota, fornecendo uma visão abrangente de suas funcionalidades, elementos de interface, fluxos de trabalho e regras de negócio.