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: 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 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) 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 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 Na tela principal, localize o veículo desejado Clique no botão "Nova viagem" (ícone "+") à direita do veículo Preencha o campo "Identificador" com uma referência única Selecione o motorista clicando no ícone de busca ao lado do campo Defina as datas de saída e retorno previstas Selecione o período correspondente Nos campos "DE" e "PARA", selecione os pontos de interesse de origem e destino Preencha a região atendida e selecione a zona Informe a quantidade de cidades, entregas, peso e valor transportado Se necessário, selecione equipamentos adicionais nas listas suspensas Configure as opções de permissão conforme necessário Se desejar controlar o itinerário detalhado, ative a opção "Controlar Percurso" e clique em "Itinerário" No modal de itinerário, adicione os pontos intermediários e organize a sequência Verifique a rota gerada no mapa e os cálculos de distância e tempo Clique em "Gravar" para salvar a viagem Como Monitorar Viagens em Andamento Na tela principal, verifique as viagens marcadas em amarelo (em andamento) Observe o progresso percentual na barra de progresso ou gráfico Verifique informações de tempo e distância restantes Consulte a localização atual do veículo Identifique possíveis atrasos marcados em vermelho Como Finalizar uma Viagem Manualmente Na tela principal, localize a viagem em andamento Clique no botão "Finalizar" (ícone "stop") No modal exibido, confirme a data e hora de retorno ou ajuste conforme necessário Preencha as informações de odômetro e horímetro se solicitado Clique em "Gravar" para registrar a finalização Como Ajustar Dados de uma Viagem Concluída Na tela principal, clique no botão "Histórico" (ícone de lista) Filtre o período desejado e/ou motorista específico Localize a viagem a ser ajustada Para ajustar datas, clique no ícone correspondente e modifique as datas no modal Para registrar devoluções, clique no ícone de dinheiro e preencha os valores Para gerar relatório, clique no ícone de impressora Para excluir a viagem, clique no ícone de lixeira (disponível apenas para viagens finalizadas) Como Importar Dados de Viagem Na tela de criação de viagem, clique no botão "Importar" No modal exibido, selecione o arquivo XLS gerado pela rotina 967 do WINTHOR Clique em "Importar" para processar o arquivo Verifique os dados carregados e complemente informações faltantes Clique em "Gravar" para salvar a viagem importada Regras de Negócio e Validações Validações Principais 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 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 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 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 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 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) 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 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 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 Como faço para visualizar todas as viagens em andamento? Na tela principal, selecione "Em Viagem" no filtro de status. 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. 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. Posso alterar um motorista após a viagem iniciada? Sim, se a opção "Alterar motorista ao iniciar" estiver ativada. 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 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 Como sei se uma viagem está atrasada? As viagens atrasadas são marcadas em vermelho e mostram o tempo de atraso. Como posso ver a localização atual de um veículo? Na tela principal, a localização atual é exibida na coluna "Local Atual". 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 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. Quais formatos de exportação estão disponíveis? Os relatórios podem ser exportados em PDF, XLS, TXT e RTF. 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 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". 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. 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. 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. 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.