Menu - Viagens

Opções do menu viagens abaixo:


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

Visualização de Pistas (Timelines)

Para cada veículo, exibe:

Visualização em Lista

Para cada veículo, exibe em formato tabular:

Códigos de Cores e Indicadores Visuais

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

Seção de Rota

Seção de Métricas

Seção de Equipamentos

Seção de Configurações

Seção de Mapa

Botões de Ação

Modal de Itinerário de Viagem

Elementos do Modal

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

Tabela de Resultados

Colunas:

Modais Adicionais

Modal de Ajuste de Datas

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

Elementos do Modal

Modal de Devolução e Reentrega

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

Elementos do Modal

Modal de Espelho da Viagem

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

Elementos do Modal

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.

Controle de Entrada e Saída

Descrição Geral da Interface

O módulo de "Controle de Entrada e Saída" de Veículos é uma solução para gerenciamento de frotas que permite monitorar quando veículos entram e saem de pontos de interesse predefinidos. A interface possui três telas principais:

  1. Lista de Controles: Mostra todos os veículos da frota, com informações sobre suas localizações, estados de controle e histórico de movimentação.
  2. Edição de Controle: Permite configurar pontos de interesse para um veículo específico, definindo áreas geográficas para monitoramento.
  3. Histórico de Viagens: Exibe um registro detalhado das viagens realizadas por um veículo específico, incluindo horários de saída e retorno, quilometragem percorrida e tempo de uso.

Para acessar clique no menu VIAGENS opção CONTROLE DE ENTRADA E SAÍDA

Elementos da Interface

Tela de Lista de Controles

Cabeçalho e Filtros

Tabela de Veículos

Tela de Edição de Controle

Cabeçalho

Formulário

Mapa

Tela de Histórico de Viagens

Cabeçalho

Tabela de Viagens

Propósito e Fluxo de Trabalho

Propósito

O sistema foi desenvolvido para monitorar e controlar o movimento de veículos em relação a pontos de interesse geográficos predefinidos, como garagens, depósitos ou áreas de trabalho. Ele permite:

  1. Definir perímetros de controle para cada veículo
  2. Registrar automaticamente entradas e saídas desses perímetros
  3. Calcular tempo de uso e quilometragem entre saídas e retornos
  4. Identificar condutores responsáveis por cada movimentação
  5. Gerar relatórios históricos de utilização da frota

Fluxo de Trabalho

  1. Configuração Inicial:

    • O administrador cadastra pontos de interesse no sistema
    • Para cada veículo, define-se quais pontos serão monitorados

  2. Monitoramento Contínuo:

    • O sistema rastreia a posição dos veículos em tempo real
    • Quando um veículo sai do perímetro definido, registra-se uma "saída"
    • Quando retorna ao perímetro (principal ou alternativo), registra-se um "retorno"
    • Estados possíveis: "CONTROLE ATIVO", "EM VIAGEM", "NO PONTO DE INTERESSE"

  3. Análise de Dados:

    • Consulta do histórico de viagens de cada veículo
    • Verificação de tempo de uso, quilometragem e condutores
    • Validação de uso correto dos veículos da frota

Instruções Passo a Passo

Como Ativar o Controle para um Veículo

  1. Na tela de lista, localize o veículo desejado
  2. Clique no botão "+" na coluna "AÇÃO"
  3. Na tela de edição, selecione o ponto de interesse principal no dropdown
  4. (Opcional) Selecione um ponto de interesse alternativo
  5. Clique no botão "Gravar"
  6. O sistema retornará à lista com o controle ativado para o veículo

Como Consultar o Histórico de um Veículo

  1. Na tela de lista, localize o veículo desejado
  2. Clique no botão de lista (ícone de linhas) na coluna "AÇÃO"
  3. Na janela de histórico, será exibido o período padrão (geralmente o mês atual)
  4. Para alterar o período:
    • Selecione a data inicial no primeiro campo de data
    • Selecione a data final no segundo campo de data
    • Clique no botão de busca (ícone de lupa)
  5. Analise os dados na tabela de resultados
  6. Feche a janela ao concluir a consulta

Como Cancelar o Controle de um Veículo

  1. Na tela de lista, localize o veículo com controle ativo
  2. Clique no botão de exclusão (ícone de lixeira) na coluna "AÇÃO"
  3. Confirme a operação quando solicitado
  4. O sistema retornará à lista com o veículo sem controle ativo

Como Filtrar Veículos na Lista

  1. Para filtrar apenas veículos com controle ativo:
    • Marque a caixa de seleção "Controle Ativado?"
  2. Para filtrar por termo de busca:
    • Digite no campo de texto (filtra por veículo, condutor ou ponto de interesse)
  3. Para filtrar por divisão:
    • Selecione a divisão desejada no dropdown correspondente

Regras de Negócio

Controle de Entrada/Saída

  1. Definição de Perímetro:

    • Pode ser um polígono (área irregular demarcada por pontos) ou um círculo (ponto central com raio)
    • O raio é especificado em quilômetros e convertido para coordenadas geográficas
    • Um veículo pode ter um ponto principal e um ponto alternativo de retorno

  2. Determinação de Status:

    • "CONTROLE ATIVO": Veículo possui ponto de interesse configurado mas não está em viagem nem no ponto
    • "EM VIAGEM": Veículo saiu do ponto de interesse e ainda não retornou
    • "NO PONTO DE INTERESSE": Veículo está dentro do perímetro do ponto principal ou alternativo

  3. Registro de Movimentação:

    • A saída é registrada quando o veículo deixa o perímetro do ponto de interesse
    • O retorno é registrado quando o veículo reentra no perímetro do ponto principal ou alternativo
    • O sistema armazena odômetro e horímetro nas saídas e retornos para cálculos de uso

  4. Cálculos Automáticos:

    • Quilometragem: Diferença entre odômetro de retorno e saída
    • Tempo de Viagem: Tempo decorrido entre saída e retorno
    • Tempo Ligado: Calculado com base no horímetro (tempo em que o motor esteve ligado)

Permissões e Restrições

  1. Controle de Acesso:

    • Existem diferentes níveis de acesso: Master, Grupo e Individual
    • A capacidade de adicionar, editar ou excluir controles depende das permissões do usuário
    • Todos os usuários podem visualizar históricos, independente de permissão de edição

  2. Validações:

    • Um veículo não pode ter mais de um controle ativo simultaneamente
    • O ponto de interesse principal é obrigatório para ativar o controle
    • O ponto de interesse alternativo é opcional

Perguntas Frequentes

1. Como o sistema detecta a saída e o retorno de um veículo?

O sistema monitora continuamente a posição geográfica do veículo e a compara com os perímetros definidos. Quando o veículo sai completamente do perímetro do ponto de interesse, registra-se uma saída. Quando ele retorna ao perímetro (principal ou alternativo), registra-se um retorno.

2. É possível definir múltiplos pontos de retorno para um mesmo veículo?

Atualmente, o sistema permite definir um ponto principal e um ponto alternativo de retorno. Se um veículo precisa transitar entre mais de dois pontos, seria necessário ajustar o controle ou usar outra abordagem de monitoramento.

3. O que acontece se o veículo entrar e sair múltiplas vezes do mesmo perímetro em curto período?

O sistema registra cada movimento como uma nova entrada/saída. Não há filtro de tempo mínimo entre registros, então movimentos frequentes na borda do perímetro podem gerar múltiplos registros.

4. Como definir o tamanho ideal do perímetro para um ponto de interesse?

O tamanho ideal depende do tipo de operação e precisão desejada. Para locais como garagens ou estacionamentos, um perímetro que cubra exatamente a área física é recomendado. Para pontos de referência mais amplos, um raio maior pode ser utilizado. Considere a precisão do GPS dos dispositivos de rastreamento ao definir o tamanho.

5. Por que alguns campos de quilometragem ou tempo aparecem com "-" no histórico?

Isso ocorre quando:

6. É possível exportar os dados de histórico para análise externa?

A interface atual não mostra botões de exportação, mas o sistema pode oferecer essa funcionalidade através de recursos adicionais. Consulte o administrador do sistema para verificar se há relatórios exportáveis disponíveis.

7. Por que a função de controle de entrada/saída seria desativada para um veículo?

Motivos comuns incluem:

Considerações Técnicas Adicionais

Cálculo de Distância Geográfica

Para determinar se um veículo está dentro de um ponto de interesse, o sistema utiliza cálculos matemáticos de distância geográfica:

Atualização de Status

O sistema atualiza periodicamente a lista de veículos a cada 60 segundos para refletir mudanças de posição e status. Este intervalo é configurado para equilibrar a necessidade de informações atualizadas com a performance do sistema.

Armazenamento de Histórico

O histórico de movimentações permanece disponível para consulta por longos períodos, permitindo análises retroativas de uso da frota. A interface permite consultar qualquer período específico através dos filtros de data.

Equipamentos de Viagens

Visão Geral

O módulo "Equipamentos de Viagem" é um módulo dentro da plataforma CONCEPT RASTREAMENTO, dedicado ao gerenciamento de equipamentos utilizados em viagens. Este sistema permite cadastrar, listar, editar e excluir equipamentos, como veículos, associando-os a tipos específicos e números de placa.

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

Interface do Sistema

O sistema possui duas telas principais:

  1. Tela de Listagem (Equipamentos de Viagens) - Interface para pesquisa e visualização dos equipamentos cadastrados
  2. Tela de Edição/Cadastro (Equipamento de Viagem) - Interface para inserção de novos equipamentos ou edição dos existentes

Tela de Listagem (Equipamentos de Viagens)

Elementos da Interface

Fluxo de Trabalho

  1. O usuário pode inserir critérios de filtro nos campos disponíveis
  2. Ao clicar no botão de pesquisa, o sistema exibe os equipamentos que atendem aos critérios
  3. O usuário pode selecionar um registro da tabela para edição
  4. Alternativamente, pode criar um novo registro clicando no botão de adição
  5. Os resultados podem ser exportados para um arquivo CSV

Tela de Edição/Cadastro (Equipamento de Viagem)

Elementos da Interface

Fluxo de Trabalho

  1. Ao criar um novo equipamento, o usuário insere os dados nos campos obrigatórios
  2. Ao editar um equipamento existente, os campos aparecem preenchidos com os dados atuais
  3. Após fazer as alterações desejadas, o usuário clica em "Gravar" para salvar
  4. Caso deseje excluir o registro, pode clicar em "Excluir" (apenas para equipamentos existentes)
  5. Se quiser cancelar a operação, basta clicar em "Voltar" para retornar à listagem

Validações do Sistema

Instruções Passo a Passo

Como Pesquisar Equipamentos

  1. Acesse a tela "Equipamentos de Viagens"
  2. Na seção de filtros, preencha os campos desejados:
    • Tipo: Digite parte ou todo o tipo do equipamento
    • Placa: Digite parte ou toda a placa do equipamento
  3. Clique no botão de pesquisa (ícone de lupa)
  4. Os resultados serão exibidos na tabela abaixo dos filtros
  5. Para limpar os filtros, clique no botão com ícone de arquivo

Como Cadastrar um Novo Equipamento

  1. Na tela de listagem, clique no botão de adição (ícone de mais)
  2. Na tela de cadastro, preencha os campos obrigatórios:
    • Tipo: Insira o tipo do equipamento (ex: "BI-TREM", "TRUCADO")
    • Placa: Insira a placa no formato correto (ex: "FHF-6822")
  3. Clique no botão "Gravar" para salvar
  4. Se a placa já existir no sistema, será exibida uma mensagem de erro
  5. Caso contrário, o sistema retornará à tela de listagem com o novo equipamento cadastrado

Como Editar um Equipamento Existente

  1. Na tela de listagem, clique no registro que deseja editar
  2. Na tela de edição, altere os campos desejados
  3. O campo "Ativo" pode ser desmarcado para inativar o equipamento
  4. Clique em "Gravar" para salvar as alterações
  5. O sistema retornará à tela de listagem

Como Excluir um Equipamento

  1. Na tela de listagem, clique no registro que deseja excluir
  2. Na tela de edição, clique no botão "Excluir"
  3. Confirme a exclusão quando solicitado
  4. O sistema removerá o registro e retornará à tela de listagem

Como Exportar Dados para CSV

  1. Na tela de listagem, realize uma pesquisa para filtrar os dados desejados
  2. Clique no botão de exportação (ícone de salvar)
  3. O sistema gerará um arquivo CSV chamado "EquipamentosViagens.csv" com os dados da tabela
  4. O arquivo será baixado automaticamente pelo navegador

Regras de Negócio

  1. Unicidade de Placa: O sistema não permite o cadastro de dois equipamentos com a mesma placa
  2. Validação de Campos Obrigatórios: Os campos Tipo e Placa são sempre obrigatórios
  3. Formato de Placa: A placa deve seguir o formato específico configurado no sistema
  4. Status do Equipamento: Um equipamento pode estar Ativo ou Inativo, mas novos equipamentos são sempre cadastrados como Ativos inicialmente
  5. Verificação de Duplicidade: Ao tentar gravar um equipamento com uma placa já existente, o sistema verifica se o ID do registro é diferente. Se for, significa que é outro equipamento tentando usar a mesma placa, e uma mensagem de erro é apresentada

Perguntas Frequentes

É possível cadastrar dois equipamentos com a mesma placa?

Não, o sistema não permite a duplicidade de placas. Cada equipamento deve ter uma placa única.

Como faço para inativar temporariamente um equipamento?

Na tela de edição do equipamento, desmarque a opção "Ativo" e clique em "Gravar". O equipamento permanecerá no sistema, mas com status "INATIVO".

Qual formato de placa é aceito pelo sistema?

O sistema aceita placas no formato AAA-#X##, onde AAA são letras, # são números e X é uma letra (exemplo: FHF-6822).

Posso reativar um equipamento inativado?

Sim, basta editar o equipamento, marcar a opção "Ativo" novamente e clicar em "Gravar".

Como exporto apenas alguns equipamentos específicos para CSV?

Aplique os filtros desejados na tela de listagem para exibir apenas os equipamentos que você quer exportar, e então clique no botão de exportação para CSV.

Posso editar a placa de um equipamento já cadastrado?

Sim, você pode editar a placa de um equipamento, mas se a nova placa já estiver associada a outro equipamento, o sistema não permitirá a alteração.

Os registros excluídos podem ser recuperados?

Não, uma vez excluído um registro, ele não pode ser recuperado através da interface. A operação de exclusão é permanente.

Como filtrar apenas por equipamentos ativos ou inativos?

Atualmente, o sistema não possui um filtro específico para status. É necessário pesquisar todos os equipamentos e identificar visualmente pela coluna STATUS.

Zonas de Viagens

Visão Geral

O módulo  "Zonas de Viagens" é um componente da plataforma CONCEPT RASTREAMENTO que permite aos usuários criar, visualizar, editar e excluir diferentes zonas geográficas para fins de logística e controle de viagens. Este módulo é essencial para organizar rotas, monitorar veículos e gerenciar entregas em áreas específicas.

Para acessar clique no menu VIAGENS opção ZONAS DE VIAGENS

Descrição da Interface

A interface do Sistema de Gerenciamento de Zonas de Viagens é composta por duas telas principais:

Tela de Pesquisa (Zonas de Viagens)

Esta tela apresenta uma lista de todas as zonas de viagens cadastradas no sistema, com os seguintes elementos:

Tela de Edição (Zona de Viagem)

Esta tela permite a criação de novas zonas de viagem ou a edição de zonas existentes:

Elementos e Campos

Tela de Pesquisa

Elemento Tipo Descrição Valores Possíveis
Filtro Nome Campo de texto Permite filtrar zonas pelo nome Texto livre
Botão Pesquisar Botão com ícone Executa a pesquisa com os filtros informados -
Botão Limpar Filtros Botão com ícone Remove todos os filtros aplicados -
Botão Novo Botão com ícone Direciona para a tela de criação de nova zona -
Botão Exportar para CSV Botão com ícone Exporta os dados em formato CSV -
Tabela de Resultados Tabela Lista todas as zonas encontradas -

Tela de Edição

Elemento Tipo Descrição Valores Possíveis Validações
Nome Campo de texto Nome da zona de viagem Texto livre Campo obrigatório
Botão Gravar Botão Salva as alterações - Desabilitado se usuário não tiver permissão
Botão Excluir Botão Remove a zona - Visível apenas para registros existentes; Desabilitado se usuário não tiver permissão
Botão Voltar Botão Retorna à tela de pesquisa - -

Regras de Negócio e Validações

  1. Criação e Edição:

    • O campo Nome é obrigatório
    • Não é permitido criar zonas com nomes duplicados no sistema
    • Apenas usuários com permissão de gravação ou capacidade Master podem criar/editar/excluir zonas

  2. Exclusão:

    • Não é possível excluir uma zona se existirem rotas associadas a ela
    • Não é possível excluir uma zona se existirem pedidos associados a ela
    • O sistema exige que as rotas e pedidos sejam transferidos para outra zona antes da exclusão

  3. Permissões:

    • Existem três níveis de acesso: Acesso Master, Acesso Grupo e Acesso Individual
    • Apenas usuários com permissão de gravação ou capacidade Master podem realizar alterações

Fluxo de Trabalho

O fluxo de trabalho típico para o gerenciamento de zonas de viagens é:

  1. O usuário acessa a tela de pesquisa "Zonas de Viagens"
  2. O usuário pode filtrar as zonas existentes pelo nome
  3. Para criar uma nova zona, o usuário clica no botão "Novo"
  4. Para editar uma zona existente, o usuário clica na linha correspondente na tabela
  5. Na tela de edição, o usuário preenche ou altera o nome da zona
  6. O usuário salva as alterações clicando em "Gravar" ou cancela a operação clicando em "Voltar"
  7. Para excluir uma zona, o usuário seleciona o registro e clica em "Excluir" na tela de edição

Instruções Passo a Passo

Pesquisar Zonas de Viagens

  1. Acesse a tela "Zonas de Viagens"
  2. (Opcional) Digite o nome ou parte do nome da zona desejada no campo "Nome"
  3. Clique no botão com ícone de lupa (Pesquisar)
  4. Os resultados serão exibidos na tabela abaixo

Criar Nova Zona de Viagem

  1. Na tela "Zonas de Viagens", clique no botão com ícone de "+" (Novo)
  2. Na tela de edição, digite o nome da nova zona no campo "Nome"
  3. Clique no botão "Gravar" para salvar
  4. O sistema retornará automaticamente para a tela de pesquisa após o salvamento bem-sucedido

Editar Zona de Viagem Existente

  1. Na tela "Zonas de Viagens", localize a zona desejada na tabela
  2. Clique na linha da zona para acessar a tela de edição
  3. Altere o nome da zona conforme necessário
  4. Clique no botão "Gravar" para salvar as alterações
  5. O sistema retornará automaticamente para a tela de pesquisa

Excluir Zona de Viagem

  1. Na tela "Zonas de Viagens", localize a zona desejada na tabela
  2. Clique na linha da zona para acessar a tela de edição
  3. Clique no botão "Excluir"
  4. Se houver rotas ou pedidos associados à zona, o sistema exibirá uma mensagem de erro
  5. Transfira as rotas e pedidos para outra zona antes de tentar excluir novamente
  6. O sistema retornará automaticamente para a tela de pesquisa após a exclusão bem-sucedida

Exportar Dados para CSV

  1. Na tela "Zonas de Viagens", aplique os filtros desejados (opcional)
  2. Clique no botão com ícone de salvamento (Exportar para CSV)
  3. O arquivo será gerado e baixado automaticamente com o nome "ZonaViagens.csv"

Perguntas Frequentes

1. Como posso saber se uma zona está sendo utilizada por rotas ou pedidos?

O sistema não exibe essa informação diretamente na interface. Você saberá apenas ao tentar excluir a zona – se houver rotas ou pedidos associados, o sistema exibirá uma mensagem informando que é necessário transferir os registros para outra zona primeiro.

2. Posso ter zonas com o mesmo nome?

Não, o sistema não permite a criação de zonas com nomes idênticos. Caso tente criar ou atualizar uma zona com um nome já existente, o sistema exibirá uma mensagem de erro.

3. Quem pode criar e editar zonas de viagem?

Apenas usuários com permissão de gravação ou capacidade Master podem criar, editar ou excluir zonas. Se você não tiver essas permissões, os botões "Gravar" e "Excluir" aparecerão desabilitados.

4. Como posso organizar as zonas de viagem de forma hierárquica?

O sistema atual não possui funcionalidade nativa para organização hierárquica de zonas. Você pode estabelecer uma convenção de nomenclatura (como "Zona Principal - Subzona") para facilitar a identificação visual.

5. Existe um limite para o número de zonas que posso criar?

Não há limite explícito no sistema para o número de zonas que podem ser criadas, mas é recomendável manter uma estrutura organizada para facilitar o gerenciamento.

6. O que acontece com veículos que estão em uma zona quando ela é excluída?

Antes de excluir uma zona, é necessário transferir todas as rotas e pedidos associados para outra zona. O sistema impede a exclusão caso ainda existam registros vinculados.

7. É possível restaurar uma zona excluída?

Não, uma vez que uma zona é excluída, não é possível restaurá-la. Será necessário criar uma nova zona com as mesmas informações.

8. Como posso visualizar todas as rotas associadas a uma zona específica?

Esta funcionalidade não está disponível diretamente neste módulo. Você precisará acessar o módulo de gerenciamento de rotas para visualizar essa informação.

Considerações Adicionais

Rotas de Viagens

Descrição Geral

O módulo "Rotas de Viagem" é uma ferramenta completa projetada para criar, gerenciar e otimizar rotas de viagem para frotas de veículos. A interface permite aos usuários definir rotas personalizadas através da adição de pontos geográficos (cidades, endereços ou pontos de interesse), visualizar essas rotas em um mapa interativo, e calcular distâncias precisas entre os pontos estabelecidos.

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

Elementos da Interface

Tela de Pesquisa (Lista de Rotas)

Esta tela principal apresenta as rotas cadastradas no sistema, com opções de filtro e navegação.

Componentes:

Tela de Edição/Cadastro

Esta tela permite a criação e edição detalhada de rotas de viagem.

Componentes:

Janela de Criação de Perímetro

Uma janela modal para configurar a criação de perímetros baseados na rota.

Componentes:

Tela de Impressão de Lista

Uma tela específica para visualização e impressão de relatório de itinerário.

Componentes:

Fluxo de Trabalho e Funcionalidades

Pesquisa de Rotas

  1. O usuário acessa a tela de pesquisa
  2. Pode filtrar por nome da rota
  3. Visualiza as rotas existentes em formato de tabela
  4. Pode selecionar uma rota para edição ou criar uma nova

Criação/Edição de Rota

  1. O usuário preenche o nome da rota
  2. Adiciona pontos utilizando:
    • Pesquisa de endereços: Digita no campo "Endereço do Local" e pressiona Enter ou o botão de adição
    • Seleção de pontos de interesse: Escolhe um ponto no dropdown e clica no botão de adição
  3. Visualiza os pontos adicionados na tabela e no mapa
  4. Pode reorganizar os pontos:
    • Manualmente: Usando os botões de mover para cima/baixo
    • Automaticamente: Usando os botões de otimização
  5. Verifica as distâncias calculadas
  6. Salva a rota usando o botão "Gravar"

Otimização de Rotas

Criação de Perímetro

  1. O usuário clica no botão "Criar Perímetro"
  2. Define a distância em metros (mínimo 400m)
  3. Escolhe uma cor para o perímetro
  4. Confirma a criação do perímetro

Impressão de Lista

  1. O usuário clica no botão "Imprimir lista"
  2. Visualiza o relatório formatado para impressão
  3. Pode imprimir ou voltar à tela de edição

Regras de Negócio

  1. Validações do Formulário:

    • Nome da rota é obrigatório
    • Uma rota deve ter pelo menos um ponto
    • Uma rota não pode exceder 45 pontos
    • Ao criar perímetro, a distância mínima é de 400 metros da rota

  2. Cálculo de Distâncias:

    • O sistema calcula automaticamente a distância total da rota em km
    • A distância ida/volta é o dobro da distância calculada
    • Para rotas com mais de 23 pontos, o sistema divide o cálculo em segmentos

  3. Manipulação de Pontos:

    • Um ponto pode ser removido da rota
    • Um ponto pode ser movido para cima ou para baixo na sequência
    • O primeiro ponto não pode ser movido para cima
    • O último ponto não pode ser movido para baixo

  4. Otimização de Rotas:

    • A otimização total reorganiza todos os pontos
    • A otimização de intermediárias mantém fixos os pontos de início e fim
    • A otimização requer pelo menos 2 pontos na rota

  5. Criação de Perímetro:

    • Requer que a rota tenha nome definido
    • Requer que a rota esteja visualizada no mapa
    • A distância mínima é de 400 metros da linha da rota
    • Uma cor deve ser definida para o perímetro

Instruções Passo a Passo

Como Criar uma Nova Rota

  1. Na tela de pesquisa, clique no botão com ícone de adição (Novo)
  2. Na tela de edição, digite um nome para a rota no campo "Nome"
  3. Adicione pontos usando um dos métodos:
    • Digite um endereço no campo "Endereço do Local" e pressione Enter ou o botão de adição
    • Selecione um ponto de interesse no dropdown e clique no botão de adição
  4. Observe os pontos sendo adicionados à tabela e ao mapa
  5. Verifique a distância calculada e ajuste a rota se necessário
  6. Clique em "Gravar" para salvar a rota

Como Editar uma Rota Existente

  1. Na tela de pesquisa, localize a rota desejada (use o filtro se necessário)
  2. Clique na linha da rota para abrir a tela de edição
  3. Modifique o nome se necessário
  4. Adicione novos pontos ou remova pontos existentes
  5. Reorganize os pontos usando os botões de movimento ou otimização
  6. Clique em "Gravar" para salvar as alterações

Como Otimizar uma Rota

  1. Na tela de edição, adicione todos os pontos desejados na rota
  2. Para otimizar toda a rota, clique em "Otimizar Todas"
  3. Para manter os pontos inicial e final e otimizar apenas os intermediários, clique em "Otimizar Intermediárias"
  4. Observe a reorganização dos pontos na tabela e no mapa
  5. Verifique a nova distância calculada
  6. Caso esteja satisfeito, clique em "Gravar"

Como Criar um Perímetro a partir da Rota

  1. Na tela de edição, verifique se a rota está nomeada e visualizada no mapa
  2. Clique no botão "Criar Perímetro"
  3. Digite a distância desejada em metros (mínimo 400)
  4. Selecione uma cor para o perímetro
  5. Clique em "Criar Perímetro"
  6. Aguarde a mensagem de confirmação

Como Imprimir a Lista de Pontos da Rota

  1. Na tela de edição, clique no botão "Imprimir lista"
  2. Na nova tela, verifique se a lista está correta
  3. Clique no botão "Imprimir"
  4. Selecione sua impressora e configure as opções de impressão
  5. Confirme a impressão

Perguntas Frequentes

Gerais

P: Qual é o limite máximo de pontos que posso adicionar em uma rota?
R: Uma rota pode ter no máximo 45 pontos. O sistema exibirá um erro se você tentar adicionar mais pontos.

P: Como faço para ver a distância total de uma rota incluindo retorno?
R: A distância ida/volta é calculada automaticamente e exibida abaixo da distância simples na tela de edição.

P: Posso adicionar o mesmo local mais de uma vez na rota?
R: Sim, o sistema permite adicionar o mesmo local (endereço ou ponto de interesse) múltiplas vezes em uma rota.

Pontos e Endereços

P: Como adiciono um endereço que não está na lista de pontos de interesse?
R: Digite o endereço no campo "Endereço do Local" e pressione Enter ou clique no botão de adição. O sistema tentará geocodificar o endereço.

P: O que acontece se um endereço não for encontrado?
R: O sistema exibirá uma mensagem informando que o endereço não foi encontrado. Tente especificar melhor o endereço ou use coordenadas.

P: Como reorganizo a ordem dos pontos na rota?
R: Use os botões de seta para cima e para baixo na tabela de pontos para mover cada ponto individualmente, ou use os botões de otimização para reorganizar automaticamente.

Otimização

P: Qual a diferença entre "Otimizar Todas" e "Otimizar Intermediárias"?
R: "Otimizar Todas" reorganiza todos os pontos da rota para encontrar o caminho mais eficiente. "Otimizar Intermediárias" mantém os pontos inicial e final fixos, reorganizando apenas os pontos intermediários.

P: A otimização garante sempre o caminho mais curto?
R: A otimização busca o caminho mais eficiente considerando as estradas disponíveis e restrições de tráfego, mas pode haver variações dependendo de condições específicas.

Perímetros

P: O que é um perímetro de rota e para que serve?
R: Um perímetro é uma área ao redor da rota que pode ser usada para monitoramento ou análise. Por exemplo, pode ser usado para alertas quando veículos saem do perímetro esperado.

P: Por que a distância mínima para criar um perímetro é de 400 metros?
R: Esta é uma restrição do sistema para garantir que o perímetro seja amplo o suficiente para cobrir variações normais de rota e possíveis desvios pequenos.

P: O que acontece com o perímetro quando modifico a rota?
R: Perímetros são entidades separadas. Se você modificar a rota, precisará criar um novo perímetro baseado na rota atualizada.

Impressão e Exportação

P: Como exporto minha lista de rotas para Excel?
R: Na tela de pesquisa, clique no botão "Exportar para CSV". O arquivo gerado pode ser aberto no Excel.

P: A impressão da lista inclui o mapa?
R: Não, a impressão da lista inclui apenas os nomes dos pontos na ordem da rota, sem o mapa.

P: Posso imprimir o mapa com a rota traçada?
R: Sim, na tela de edição há um botão para imprimir o mapa atual com a rota traçada e os pontos marcados.

Eventos do Monitriip

Visão Geral

O modulo "Eventos Monitriip" é uma ferramenta essencial para empresas de transporte que precisam monitorar eventos de seus veículos para o Monitriip. Este módulo permite o acompanhamento de jornadas de trabalho, paradas e outras operações realizadas pelos motoristas utilizando o aplicativo do Monitriip disponível para dispositivos ANDROID, mantendo conformidade com as exigências da ANTT (Agência Nacional de Transportes Terrestres).

Para acessar clique no menu VIAGENS opção EVENTOS DO MONITRIIP

Interface Principal - Tela de Pesquisa

Descrição

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

  1. Seção de Filtros - Localizada na parte superior da tela, permite refinar os resultados da pesquisa.
  2. Tabela de Resultados - Exibe os eventos encontrados de acordo com os filtros aplicados.

Elementos da Interface

Seção de Filtros

Tabela de Resultados

A tabela apresenta os seguintes campos:

Paginação

Tela de Detalhes do Evento

Ao selecionar um registro na tabela, o sistema abre uma tela de detalhes com informações completas sobre o evento.

Elementos da Tela de Detalhes

A tela de detalhes apresenta todas as informações do evento selecionado em formato de visualização (não editável), organizadas em blocos de dados:

Bloco 1:

Bloco 2:

Bloco 3:

Bloco 4:

Bloco 5:

Controles:

Fluxo de Trabalho

  1. Acesso à Tela Principal: O usuário acessa a interface de pesquisa
  2. Aplicação de Filtros: Seleciona um veículo e/ou período específico
  3. Pesquisa: Clica no botão de pesquisa para obter os resultados
  4. Visualização dos Resultados: Analisa os eventos na tabela
  5. Acesso aos Detalhes: Clica em um registro para ver informações completas
  6. Retorno à Pesquisa: Utiliza o botão Voltar para retornar à tela principal
  7. Exportação de Dados: Opcionalmente exporta os resultados para CSV

Regras de Negócio

  1. Filtro Padrão de Data: Ao acessar a tela pela primeira vez, o sistema define automaticamente:

    • Data inicial: primeiro dia do mês corrente
    • Data final: último dia do mês corrente

  2. Persistência de Filtros: Os filtros são armazenados na sessão do usuário, sendo recuperados em acessos subsequentes à tela.

  3. Pesquisa de Veículos: A busca de veículos pode ser realizada por:

    • Placa
    • Marca
    • Modelo
    • Condutor
    • Identificação interna (labelVeiculo)

  4. Formato de Coordenadas: As coordenadas geográficas são clicáveis e abrem o Google Maps com a localização exata do evento.

  5. Exportação para CSV: Os dados podem ser exportados no formato CSV utilizando ponto-e-vírgula como separador.

  6. Paginação: Os resultados são paginados automaticamente para melhor desempenho.

Instruções Passo a Passo

Como Pesquisar Eventos

  1. Acesse a tela de eventos Monitriip
  2. Na seção de filtros, selecione um veículo específico (opcional)
  3. Defina o período desejado nos campos de data de início e fim
  4. Clique no botão de pesquisa (ícone de lupa)
  5. Aguarde a exibição dos resultados na tabela

Como Visualizar Detalhes de um Evento

  1. Na tabela de resultados, clique em qualquer linha para selecionar o evento
  2. O sistema abrirá automaticamente a tela de detalhes
  3. Navegue pelas informações organizadas em blocos
  4. Para visualizar a localização no mapa, clique nas coordenadas de latitude/longitude
  5. Para retornar à tela de pesquisa, clique no botão "Voltar"

Como Exportar Dados para CSV

  1. Aplique os filtros desejados e realize a pesquisa
  2. Clique no botão "Exportar para CSV" (ícone de salvar)
  3. Escolha o local para salvar o arquivo
  4. O arquivo será salvo com o nome "EventosMonitriip.csv"

Como Limpar os Filtros

  1. Clique no botão "Limpar Filtros" (ícone de arquivo)
  2. Os campos serão redefinidos para:
    • Veículo: vazio
    • Data inicial: primeiro dia do mês corrente
    • Data final: último dia do mês corrente

Perguntas Frequentes

O que é o Monitriip?

O Monitriip é um sistema de controle obrigatório para empresas de transporte rodoviário regulamentado pela ANTT. Ele registra informações sobre jornada de trabalho, paradas e outras operações realizadas pelos motoristas.

Como identificar eventos que ainda não foram enviados à ANTT?

Verifique a coluna "ENVIO ANTT" na tabela de resultados. Se estiver vazia, o evento ainda não foi transmitido.

É possível visualizar a localização exata de um evento?

Sim. Nos detalhes do evento, clique nas coordenadas de latitude e longitude para abrir o Google Maps com a localização exata.

Por que alguns eventos mostram "Detecção Parada" enquanto outros mostram "Log Jornada Trabalho"?

"Detecção Parada" indica que o veículo parou por um tempo suficiente para ser considerado em pausa, enquanto "Log Jornada Trabalho" representa registros regulares de atividade.

Como sei se um evento foi processado corretamente?

Verifique a coluna "PROCESSADO". Se mostrar "SIM", o evento foi processado com sucesso.

O sistema armazena meus filtros para a próxima vez que eu acessar?

Sim, o sistema salva os últimos filtros utilizados e os restaura automaticamente em seu próximo acesso.

Qual o período máximo que posso pesquisar de uma vez?

Não há limitação técnica específica, mas para melhor desempenho, recomenda-se pesquisar períodos de até 90 dias.

É possível editar os dados de um evento?

Não, a tela de detalhes é apenas para visualização. Os eventos Monitriip são registros oficiais e não podem ser alterados após o envio.