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