Itinerários

Visão Geral

O módulo "Itinerários" é uma ferramenta integrada para controle logístico que permite aos usuários gerenciar, criar e monitorar itinerários de entrega associados a roteirizações de veículos. Este sistema proporciona uma visão completa dos itinerários, suas localizações, status e demais informações relevantes para a gestão eficiente da frota e das entregas.

Para acessar clique no menu ROTEIRIZAÇÃO opção ITINERÁRIOS.

Interface Principal

Tela de Itinerários

A interface principal apresenta uma lista de itinerários com múltiplas funcionalidades de filtro e ações. Esta tela é dividida em duas seções principais:

  1. Seção de Filtros: Localizada na parte superior, permite refinar a consulta de itinerários.
  2. Tabela de Resultados: Exibe os itinerários encontrados com suas informações detalhadas.

Seção de Filtros

Tabela de Resultados

Tela de Edição de Itinerário

Acessada ao clicar no botão de edição de um itinerário específico, esta tela permite visualizar e modificar todos os detalhes de um itinerário.

Seção Principal

Seção de Localização

Seção de Restrições

Informações Adicionais

Botões de Ação

Mapa

Janelas Modais

Modal de Registros Selecionados

Modal de Ocorrências

Modal de Fotos

Modal de Rotas

Modal para Exibir Veículos Próximos

Fluxos de Trabalho

Fluxo Principal de Gerenciamento de Itinerários

  1. Consulta de Itinerários:

    • O usuário define filtros (período, veículo, status, etc.)
    • Clica em "Pesquisar" para visualizar os itinerários
    • O sistema exibe os resultados na tabela

  2. Edição de Itinerário Existente:

    • O usuário clica no botão de edição do itinerário desejado
    • O sistema abre a tela de edição com os dados preenchidos
    • O usuário modifica os campos necessários
    • Clica em "Gravar" para salvar as alterações

  3. Criação de Novo Itinerário:

    • O usuário acessa a tela de edição através de um botão de adicionar
    • Preenche todos os campos obrigatórios
    • Define a localização do itinerário (cliente/endereço)
    • Configura as restrições de horário
    • Clica em "Gravar" para criar o itinerário

  4. Alteração de Status em Lote:

    • O usuário seleciona múltiplos itinerários na tabela principal
    • Clica no ícone de carrinho para abrir o modal de seleção
    • Escolhe o novo status a ser aplicado
    • Se o status for "ENTREGUE", informa a data e hora da entrega
    • Confirma a alteração

Fluxo de Gerenciamento de Ocorrências

  1. Na tela de edição do itinerário, o usuário clica no botão "Ocorrências"
  2. No modal aberto, visualiza as ocorrências existentes
  3. Para adicionar uma nova ocorrência:
    • Seleciona o tipo de ocorrência
    • Clica no botão de adicionar
  4. Para tratar uma ocorrência:
    • Edita o campo de tratativa
    • Altera o status para "TRATADO"
  5. Clica em "Gravar" para salvar as alterações

Fluxo de Gestão de Fotos

  1. Na tela de edição do itinerário, o usuário clica no botão "Fotos"
  2. No modal aberto, visualiza as fotos existentes
  3. Para visualizar uma foto em tamanho maior, clica na miniatura
  4. Para baixar uma foto, clica no botão de download
  5. Para rotacionar uma foto, utiliza o botão específico
  6. Para excluir uma foto, clica no botão de exclusão
  7. Para adicionar uma nova foto, utiliza a seção de upload

Fluxo de Recuperação de Roteirizações Anteriores

  1. Na tela principal, o usuário clica no botão de "Recuperar roteirizações anteriores"
  2. No modal aberto, define os filtros para buscar roteirizações
  3. Clica em "Pesquisar" para visualizar as opções
  4. Seleciona a roteirização desejada
  5. Confirma a seleção para carregar os itinerários relacionados

Instruções Passo a Passo

Como Criar um Novo Itinerário

  1. Na tela principal de itinerários, clique no botão de adicionar
  2. Preencha os campos obrigatórios:
    • Número do Pedido
    • Data do Pedido
    • Data do Itinerário
    • Veículo
    • Motorista
    • Status
    • Quantidade
    • Valor
    • Peso
    • Volume
    • Descrição
  3. Na seção de Localização:
    • Selecione o Cliente ou utilize a busca
    • Preencha o Endereço ou utilize o botão de busca para localizar
    • Selecione Vendedor, Loja e Zona
  4. Na seção de Restrições:
    • Defina a Hora Início (formato HH:MM)
    • Defina a Hora Fim (formato HH:MM)
    • Informe o Tempo para atender (em minutos)
  5. Opcionalmente, adicione uma Observação
  6. Clique em "Gravar" para criar o itinerário

Como Alterar o Status de Múltiplos Itinerários

  1. Na tela principal, utilize os filtros para localizar os itinerários desejados
  2. Para cada itinerário que deseja incluir, clique no botão de adicionar (ou use o botão "Adicionar todos os itinerários")
  3. Clique no ícone de carrinho para abrir o modal de seleção
  4. No modal, selecione o novo status a ser aplicado
  5. Se o status for "ENTREGUE", preencha a data e hora da entrega
  6. Clique no botão de salvar para confirmar a alteração

Como Gerenciar Ocorrências de um Itinerário

  1. Na tela de edição do itinerário, clique no botão "Ocorrências"
  2. Para adicionar uma nova ocorrência:
    • Selecione o tipo de ocorrência no dropdown
    • Clique no botão de adicionar
  3. Para tratar uma ocorrência existente:
    • Clique na linha da ocorrência para editar
    • Preencha o campo de tratativa
    • Altere o status para "TRATADO"
  4. Clique em "Gravar" para salvar as alterações

Como Buscar Veículos Próximos a um Endereço

  1. Na tela de edição do itinerário, clique no botão de busca ao lado do campo Veículo
  2. No modal aberto, digite o endereço desejado no campo de busca
  3. Clique no botão de pesquisa ou pressione Enter
  4. Selecione o endereço na lista de resultados
  5. O sistema exibirá os veículos próximos com as respectivas distâncias e tempos
  6. Clique no veículo desejado para selecioná-lo

Como Visualizar e Adicionar Fotos

  1. Na tela de edição do itinerário, clique no botão "Fotos"
  2. Para visualizar uma foto em tamanho maior, clique na miniatura
  3. Para adicionar uma nova foto:
    • Na seção de upload, clique em "Anexar..."
    • Selecione o arquivo de imagem desejado
    • A foto será enviada automaticamente
  4. Para rotacionar uma foto, clique no botão de rotação
  5. Para fazer download de uma foto, clique no botão correspondente
  6. Para excluir uma foto, clique no botão de exclusão

Regras de Negócio

Validações de Campos

Funcionalidades de SMS e Notificações

Ocorrências e Inconsistências

Fotos e Anexos

Perguntas Frequentes

Gerais

  1. Como faço para filtrar itinerários de um período específico?

    • Na seção de filtros, defina as datas de início e fim no campo "Período" e clique em "Pesquisar".

  2. Como altero o status de vários pedidos ao mesmo tempo?

    • Selecione os pedidos desejados usando o botão de adicionar, clique no ícone de carrinho, escolha o novo status e confirme.

  3. Posso exportar a lista de itinerários para um arquivo?

    • Sim, clique no botão "Exportar para CSV" (ícone de tabela) na barra de ações.

Edição de Itinerários

  1. Por que não consigo alterar um itinerário?

    • Verifique se a viagem não está com status "CANCELADA" ou "FINALIZADA", pois nestes casos a edição é bloqueada.

  2. Como atualizo a localização de um itinerário no mapa?

    • No campo de endereço, clique no botão de busca, digite o endereço correto e selecione-o na lista de resultados.

  3. Como verifico se há veículos próximos a um endereço?

    • Na tela de edição, clique no botão de busca ao lado do campo Veículo, digite o endereço e pesquise.

Ocorrências e Status

  1. O que significa o asterisco (*) ao lado de um itinerário?

    • Indica que existem ocorrências pendentes associadas ao itinerário.

  2. Como trato uma ocorrência pendente?

    • Clique no botão "Ocorrências", preencha o campo de tratativa da ocorrência e altere o status para "TRATADO".

  3. Por que preciso informar a data e hora ao marcar como "ENTREGUE"?

    • O sistema registra o momento exato da entrega para fins de rastreabilidade e envia notificações ao cliente.

Fotos e Documentos

  1. Que tipos de fotos posso anexar ao itinerário?

    • Você pode anexar imagens em formato PNG, com limite de uma por upload.

  2. Como faço para ver uma foto em tamanho maior?

    • Clique na miniatura da foto para abri-la em tamanho completo em uma nova aba.

  3. Posso rotacionar uma foto que foi enviada na orientação errada?

    • Sim, clique no botão de rotação para girar a foto em 90 graus no sentido horário.

Considerações sobre o Funcionamento Técnico

O sistema utiliza uma arquitetura cliente-servidor onde a interface é construída com componentes reativos que se atualizam conforme as ações do usuário e os dados do servidor. As principais funcionalidades são:

Gerenciamento de Pedidos e Roteirização

Geolocalização e Mapas

Controle de Permissões

Gestão de Ocorrências

Notificações e SMS

Revision #2
Created 17 March 2025 23:34:52 by Moises Reis Filho
Updated 25 March 2025 10:57:43 by Moises Reis Filho