Skip to main content

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

  • Título da Seção: "Filtros" (com opção de expandir/recolher)
  • Seleção de Veículo: Campo dropdown para escolher um veículo específico
  • Número do Pedido: Campo de texto para buscar por número de pedido
  • Tipo de Roteirização: Dropdown com opções "Pedidos" e "Visitas"
  • Período: Dois campos de data (Data Início e Data Fim) com o formato DD-MM-AAAA, conectados por "à"
  • Status: Dropdown para filtrar por status do itinerário
  • Botões de Ação:
    • Exportar para CSV (ícone de tabela)
    • Pesquisar (ícone de lupa)
    • Recuperar roteirizações anteriores (ícone de arquivo)
    • Limpar filtros (ícone de arquivo em branco)
    • Adicionar todos os itinerários (ícone de adicionar)
    • Ver selecionados (ícone de carrinho de compras com contador)

Tabela de Resultados

  • Contador de Registros: Exibe o número total de registros encontrados
  • Colunas da Tabela:
    • Botões de ações (adicionar e editar)
    • Alerta de ocorrências (representado por asterisco quando há pendências)
    • Veículo (placa)
    • Pedido/Visita (número)
    • Data do Itinerário (data e hora)
    • Data do Pedido
    • Valor
    • Status
    • Vendedor/Loja/Zona
    • Endereço
    • Roteirização (ID)

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

  • Título: "Itinerário da Roteirização"
  • Informações Básicas:
    • Número do Pedido: Campo obrigatório (texto)
    • Data do Pedido: Campo obrigatório (data e hora)
    • Data do Itinerário: Campo obrigatório (data e hora)
    • Nota Fiscal: Campo de texto opcional
    • Carregamento: Campo de texto opcional
    • Veículo: Campo obrigatório (dropdown com busca)
    • Motorista: Campo obrigatório (texto)
    • Status: Campo obrigatório (dropdown)
    • Data de Entrega: Campo condicional, exibido e obrigatório quando o status é "ENTREGUE"
    • Quantidade: Campo obrigatório (numérico, decimal)
    • Valor: Campo obrigatório (numérico, decimal)
    • Peso: Campo obrigatório (numérico, decimal)
    • Volume: Campo obrigatório (numérico, decimal)
    • Descrição: Campo obrigatório (texto)

Seção de Localização

  • Cliente: Campo obrigatório (dropdown com busca paginada)
  • Endereço: Campo obrigatório (texto com botão de busca)
  • Vendedor: Campo obrigatório (dropdown)
  • Loja: Campo obrigatório (dropdown)
  • Zona: Campo obrigatório (dropdown)

Seção de Restrições

  • Hora Início: Campo obrigatório (hora)
  • Hora Fim: Campo obrigatório (hora)
  • Tempo p/ atender: Campo obrigatório (numérico, minutos)

Informações Adicionais

  • Botão de Ocorrências: Exibe o número de ocorrências existentes
  • Botão de Fotos: Permite visualizar e gerenciar fotos do itinerário
  • Observação: Campo de texto (opcional)

Botões de Ação

  • Atualizar Lat/Lon: Visível quando o status não é "ABERTA" e há coordenadas de alteração de status
  • Ver Assinatura: Visível quando o itinerário está assinado
  • Gravar: Salva as alterações
  • Excluir: Remove o itinerário (visível apenas para registros existentes)
  • Voltar: Retorna à tela anterior

Mapa

  • Visualização de Mapa: Exibe a localização do itinerário com marcador
  • Controles: Zoom, alternância entre mapa e satélite

Janelas Modais

Modal de Registros Selecionados

  • Título: "Registros selecionados"
  • Novo Status: Dropdown para selecionar o novo status
  • Data e Hora da Entrega: Campo de data e hora, exibido quando "ENTREGUE" é selecionado
  • Botões de Ação:
    • Alterar status dos pedidos selecionados
    • Limpar lista de seleção
  • Tabela de Itinerários Selecionados:
    • Colunas: Pedido, Data, Vendedor, Botão de remoção
    • Paginação na parte inferior

Modal de Ocorrências

  • Título: "Ocorrências"
  • Seleção de Tipo de Ocorrência: Dropdown
  • Botão Adicionar: Para incluir nova ocorrência
  • Botões de Ação: Pesquisar, Gravar
  • Tabela de Ocorrências:
    • Colunas: Tipo, Cadastrado, Tratado, Status
    • Edição inline para tratativa e status

Modal de Fotos

  • Título: "Fotos" (com contador)
  • Tabela de Fotos:
    • Colunas: Foto (com imagem em miniatura), Cadastrado, Botões de ação (Download, Rotacionar, Excluir)
  • Seção de Upload: Para adicionar novas fotos

Modal de Rotas

  • Título: "Rotas"
  • Filtros:
    • Veículo: Dropdown
    • Período: Data início e fim
    • Pedido: Campo de texto
    • Botão de pesquisa
  • Tabela de Rotas:
    • Colunas: Identificador, Veículo, Data, Início, Status, Itinerários, Saída, Retorno, Data/Hora Retorno, Peso, Volume
  • Botões: OK, Fechar

Modal para Exibir Veículos Próximos

  • Título: "Listar veículos próximos"
  • Campo de Busca: Para localizar endereço
  • Botão de Busca: Para iniciar a pesquisa
  • Área de Alerta: Para mensagens de erro
  • Tabela de Resultados: Lista de endereços encontrados

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

  • Campos Obrigatórios: Número do Pedido, Data do Pedido, Data do Itinerário, Veículo, Motorista, Status, Quantidade, Valor, Peso, Volume, Descrição, Cliente, Endereço, Vendedor, Loja, Zona, Hora Início, Hora Fim, Tempo para atender
  • Data de Entrega: Obrigatória apenas quando o status é "ENTREGUE"
  • Restrições de Horário: A Hora Fim deve ser posterior à Hora Início
  • Coordenadas: Latitude e Longitude devem ser válidas para permitir a gravação do itinerário
  • Limitações de Status: Não é possível alterar um itinerário em uma viagem com status "CANCELADA" ou "FINALIZADA"
  • Roteirização: Ao editar horários ou localização, o sistema pode reprocessar a roteirização para ajustar a rota

Funcionalidades de SMS e Notificações

  • O sistema envia SMS para o cliente quando o status do pedido é alterado para "ENTREGUE"
  • É necessário que o cliente tenha um número de celular válido e serviço de SMS configurado
  • O SMS inclui um link para avaliação da entrega, que é registrada no sistema

Ocorrências e Inconsistências

  • O sistema pode criar automaticamente ocorrências quando detecta inconsistências de localização
  • Ocorrências têm status "PENDENTE" ou "TRATADO"
  • A tratativa de ocorrências é obrigatória para alterar o status para "TRATADO"

Fotos e Anexos

  • As fotos são armazenadas com associação ao itinerário
  • É possível rotacionar, baixar e excluir fotos
  • A data e hora de cadastro da foto são registradas automaticamente

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

  • Ao criar ou editar um itinerário, o sistema verifica se já existe uma viagem para aquela data e veículo
  • Caso exista, o itinerário é incluído na viagem; caso contrário, uma nova viagem é criada
  • Quando há alterações em horários ou localizações, o sistema pode reprocessar a roteirização usando serviços externos

Geolocalização e Mapas

  • O sistema utiliza APIs de geocodificação para converter endereços em coordenadas e vice-versa
  • Há validações para garantir que as coordenadas são válidas
  • O sistema pode detectar inconsistências entre a localização informada e a posição real do veículo

Controle de Permissões

  • As ações são controladas com base no perfil do usuário
  • As permissões incluem:
    • Cadastro e edição de itinerários
    • Exclusão de itinerários
    • Alteração de status
    • Gestão de ocorrências
    • Acesso a roteirizações históricas

Gestão de Ocorrências

  • Ocorrências podem ser criadas manualmente ou automaticamente
  • O sistema mantém um histórico completo de ocorrências e suas tratativas
  • Ocorrências pendentes são destacadas na interface

Notificações e SMS

  • O sistema pode enviar SMS automáticos para clientes quando o status do pedido é alterado
  • Há integração com serviços de SMS externos
  • As respostas dos clientes (avaliações) são processadas e armazenadas no sistema
Back to top