Menu - Roteirizador

• Roteirizações Automáticas
• Zonas de Roteirização
• Vendedor de Roteirização
• Lojas de Roteirização
• Tipo Ocorrência
• Importação de Pedidos por Arquivo Excel
• Pedidos
• Itinerários
• Log Importação Webservice
• Status Itinerário Customizado
• Gerenciamento de Pedidos
• Registro de Parada
• Histórico de Roteirizações
• Monitorar Roteirizações
• Roteirizações
• Roteirizador de Pedidos
• Roteirizador de Visistas

Roteirizações Automáticas

Visão Geral

O módulo de "Roteirizações Automatizadas" permite configurar, programar e gerenciar roteiros repetitivos para veículos da frota. Este módulo possibilita que roteiros sejam executados de forma automática conforme uma periodicidade configurada (semanal ou mensal), reduzindo a necessidade de criação manual de roteiros recorrentes. 

Para acessar clique no menu ROTEIRIZAÇÃO opção AGENDAMENTO ROTEIRIZAÇÕES

Interface Principal de Listagem

Descrição

A tela inicial apresenta uma lista de todas as roteirizações automatizadas cadastradas no sistema, exibindo suas configurações de periodicidade, datas e status de execução.

Elementos da Interface

Seção de Filtros

• Título: "Filtros" (expansível/retrátil)
• Veículo: Campo de seleção (dropdown) que permite filtrar por veículo específico
• Periodicidade: Campo de seleção (dropdown) com opções para filtrar por tipo de periodicidade
• Botões de Ação:
  • Pesquisar: Botão azul com ícone de lupa para aplicar os filtros
  • Limpar Filtros: Botão cinza com ícone de arquivo para resetar os campos de filtro
  • Novo: Botão amarelo com ícone de adição para criar nova roteirização automatizada
  • Exportar para CSV: Botão verde com ícone de salvamento para exportar dados em formato CSV

Tabela de Roteirizações

• Colunas:
  • Roteirização: Exibe a placa do veículo e data/hora de início da roteirização
  • Periodicidade: Mostra a configuração da repetição (semanal/mensal) e dias selecionados
  • Repetir Até: Data limite para repetição da roteirização
  • Última Execução: Data e hora da última execução da roteirização automatizada
  • N. vezes: Número de vezes que a roteirização automática foi executada

Paginação

• Controles para navegar entre páginas de resultados
• Indicador de registros mostrados (ex: "1 - 1 de 1")

Interface de Edição e Criação

Descrição

Esta tela permite configurar uma nova roteirização automatizada ou editar uma existente. Divide-se em dois painéis principais: um para configuração da roteirização e periodicidade, e outro para visualização dos itinerários incluídos.

Elementos da Interface

Seção de Seleção de Roteirização (criação)

• Veículo: Campo de seleção que mostra modelos e placas de veículos disponíveis
• Botões:
  • Roteirização Pedidos: Abre popup para selecionar roteirização de pedidos existente
  • Roteirização Visitas: Abre popup para selecionar roteirização de visitas existente

Seção de Informações da Roteirização (visualização)

• Veículo: Campo de seleção (desabilitado na edição) mostrando o veículo selecionado
• Motorista: Campo de texto mostrando o nome do condutor do veículo
• Data Início Planejada: Campo de texto mostrando data e hora de início
• Data Fim Planejada: Campo de texto mostrando data e hora de término
• Distância Prevista: Campo numérico mostrando a quilometragem prevista (em km)
• Tempo Estimado: Campo de texto mostrando o tempo estimado para a rota
• De: Campo de texto indicando o ponto de saída da rota
• Para: Campo de texto indicando o ponto de retorno da rota

Seção de Periodicidade

• A cada: Campo numérico para definir intervalo de repetição
• Periodicidade: Seleção do tipo (Semanal/Mensal)
• Para periodicidade Semanal:
  • Dias da semana: Caixas de seleção para cada dia (Segunda a Domingo)
• Para periodicidade Mensal:
  • No dia: Seleção numérica do dia do mês (1-30)
• Até o dia: Seletor de data para definir limite de repetição

Seção de Itinerários

• Tabela de Itinerários:

  • Para roteirizações de pedidos:

    • Número do Pedido: Identificador numérico do pedido
    • Valor: Valor monetário do pedido
    • Loja: Nome da loja associada
    • Zona: Zona geográfica
    • Vendedor: Nome do vendedor

  • Para roteirizações de visitas:

    • Código: Identificador da visita
    • Loja: Nome do estabelecimento
    • Zona: Zona geográfica
    • Vendedor: Nome do responsável

Botões de Ação

• Gravar: Salva a configuração da roteirização automatizada
• Excluir: Remove a configuração (disponível apenas na edição)
• Voltar: Retorna à tela de listagem

Fluxo de Trabalho

Processo de Configuração de Roteirização Automatizada

1. Acesso ao Sistema

   • O usuário acessa o módulo de "Roteirizações Automatizadas" pelo menu principal

2. Visualização de Roteirizações Existentes

   • Na tela inicial, o usuário pode visualizar todas as roteirizações automatizadas cadastradas
   • Pode filtrar por veículo ou tipo de periodicidade para facilitar a busca

3. Criação de Nova Roteirização Automatizada

   • Ao clicar no botão "Novo", o usuário é direcionado para a tela de criação
   • Seleciona um veículo disponível
   • Escolhe entre roteirização de pedidos ou visitas e seleciona uma roteirização existente como modelo

4. Configuração de Periodicidade

   • Define o intervalo de repetição (semanalmente ou mensalmente)
   • Para repetição semanal: seleciona os dias da semana
   • Para repetição mensal: define o dia do mês
   • Estabelece uma data limite para a repetição automática

5. Revisão e Salvamento

   • Visualiza os itinerários incluídos na roteirização
   • Salva a configuração, que passa a gerar roteirizações automaticamente conforme a periodicidade definida

6. Acompanhamento

   • Na tela de listagem, o usuário pode acompanhar quantas vezes cada roteirização automática foi executada e quando ocorreu a última execução

Instruções Passo a Passo

Como Criar uma Nova Roteirização Automatizada

1. Na tela de listagem, clique no botão amarelo com ícone de adição (Novo)
2. Na nova tela, selecione o veículo desejado no campo "Veículo"
3. Clique em "ROTEIRIZAÇÃO PEDIDOS" ou "ROTEIRIZAÇÃO VISITAS" conforme o tipo desejado
4. No popup que aparece, selecione uma roteirização existente para servir como modelo
5. Clique em "OK" para confirmar a seleção
6. Configure a periodicidade:
   • Digite o número de intervalo em "A cada"
   • Selecione "SEMANAL" ou "MENSAL" no campo ao lado
   • Se for semanal: marque os dias da semana desejados
   • Se for mensal: defina o dia do mês desejado
7. Defina uma data limite no campo "até o dia"
8. Revise as informações e os itinerários listados
9. Clique em "Gravar" para salvar a configuração

Como Editar uma Roteirização Automatizada Existente

1. Na tabela da tela principal, clique na linha da roteirização que deseja editar
2. Na tela de edição, modifique os parâmetros de periodicidade conforme necessário
3. Ajuste o limite de repetição se desejar
4. Clique em "Gravar" para salvar as alterações

Como Excluir uma Roteirização Automatizada

1. Na tabela da tela principal, clique na linha da roteirização que deseja excluir
2. Na tela de edição, clique no botão "Excluir" (vermelho)
3. Confirme a exclusão quando solicitado

Como Filtrar Roteirizações Automatizadas

1. Na seção de filtros da tela principal, selecione um veículo específico (opcional)
2. Selecione um tipo de periodicidade (opcional)
3. Clique no botão azul com ícone de lupa para aplicar os filtros
4. Para limpar os filtros, clique no botão cinza com ícone de arquivo

Como Exportar Dados para CSV

1. Na tela principal, aplique os filtros desejados (opcional)
2. Clique no botão verde com ícone de salvamento
3. Selecione o local para salvar o arquivo CSV gerado

Perguntas Frequentes

Geral

1. O que é uma roteirização automatizada?

   • É uma funcionalidade que permite configurar roteiros para serem executados automaticamente com base em uma periodicidade definida, sem necessidade de criação manual a cada ocorrência.

2. Quais são os tipos de roteirização que posso automatizar?

   • É possível automatizar roteirizações de pedidos e roteirizações de visitas.

3. Posso modificar os itinerários de uma roteirização automatizada?

   • Não diretamente na tela de automação. Os itinerários são definidos pela roteirização original selecionada como modelo.

4. É possível configurar múltiplas roteirizações automatizadas para o mesmo veículo?

   • Sim, desde que não haja conflito nos horários de execução das rotas.

Periodicidade

5. Qual a diferença entre periodicidade semanal e mensal?

   • Na periodicidade semanal, você seleciona dias específicos da semana para repetição
   • Na periodicidade mensal, você seleciona um dia específico do mês para repetição

6. O que significa o campo "A cada"?

   • Define o intervalo entre repetições. Por exemplo, "A cada 2 semanas" significa que a roteirização será executada a cada duas semanas, nos dias selecionados.

7. Posso configurar uma roteirização para ser executada em dias alternados?

   • Sim, utilizando a periodicidade semanal e selecionando os dias específicos desejados.

8. O que acontece se eu configurar uma roteirização mensal para o dia 31?

   • O sistema permite configurar apenas dias de 1 a 30. Para meses com menos de 30 dias, a regra de negócio ajustará para o último dia do mês.

Operação

9. Como sei se uma roteirização automatizada foi executada?

   • Na tabela da tela principal, a coluna "Última Execução" mostra a data e hora da última execução, e "N. vezes" indica quantas vezes foi executada.

10. O que acontece quando chega a data limite de repetição?

    • O sistema para de gerar novas roteirizações automaticamente após a data especificada no campo "até o dia".

11. É possível pausar temporariamente uma roteirização automatizada?

    • O sistema não possui função de pausa. É necessário excluir a configuração e recriá-la posteriormente.

12. Os dados do motorista podem ser diferentes a cada execução?

    • Não. O sistema utiliza o motorista associado ao veículo no momento da configuração para todas as execuções.

13. Como altero a rota utilizada como modelo para uma automatização existente?

    • Não é possível alterar a rota modelo. É necessário excluir a configuração atual e criar uma nova.

14. O sistema notifica quando uma roteirização automática é executada?

    • O sistema não envia notificações automáticas, mas registra a execução no histórico disponível na interface.

Zonas de Roteirização

Descrição Geral

O módulo "Zonas" de Roteirização é uma ferramenta dedicada ao gerenciamento geográfico operacional, permitindo que empresas definam áreas específicas para planejamento logístico. O módulo facilita a organização territorial da operação, possibilitando a criação de zonas delimitadas no mapa e a atribuição de veículos específicos para cada área.

Através desta funcionalidade, os usuários podem visualizar, criar, editar e excluir zonas de roteirização, bem como definir parâmetros operacionais para cada zona, como peso mínimo, percentuais de capacidade de veículos e associação com veículos da frota.

Para acessar clique no menu ROTEIRIZAÇÃO opção ZONAS.

Elementos da Interface

Tela de Listagem de Zonas

Cabeçalho:

• Título: "Zonas de Roteirização"
• Seção de filtros (expansível/retrátil)

Filtros:

• Campo "Nome": Campo de texto para filtrar zonas pelo nome
• Botões de ação:
  • Pesquisar (ícone de lupa): Executa a pesquisa com os filtros informados
  • Limpar filtros (ícone de documento): Limpa todos os filtros aplicados
  • Novo (ícone de "+", cor amarela): Cria uma nova zona de roteirização
  • Exportar para CSV (ícone de disquete, cor verde): Exporta os dados da tabela para um arquivo CSV
  • Importar (botão verde com texto "Importar"): Abre o modal para importação de zonas através de CSV

Tabela de Zonas:

• Colunas:
  • CÓDIGO: Identificador único da zona
  • NOME: Nome da zona
• Paginação:
  • Indicador de registros exibidos (ex: "1-24 de 109")
  • Navegação por páginas numeradas (1, 2, 3, 4, 5)
  • Botões para anterior e próxima página

Modal de Importação de Zonas

• Título: "Arquivo de zonas para importação"
• Área de upload: Com botão "Anexar..."
• Instruções: Informações sobre o formato esperado do arquivo CSV
  • Separador de campos: ponto e vírgula (;)
  • Sequência de colunas: CÓDIGO, NOME
  • Primeira linha considerada como cabeçalho
• Botão de fechamento: "×" no canto superior direito

Tela de Edição/Criação de Zona

Seção de Formulário (lado esquerdo):

• Campos principais:

  • Código: Campo de texto para identificador da zona
  • Nome: Campo de texto para o nome da zona
  • Peso Mínimo: Campo numérico para definir o peso mínimo da zona (formato numérico com separador decimal vírgula)
  • % Mínimo Peso Veículo: Campo numérico percentual (formato numérico com separador decimal vírgula)
  • % Máximo Peso Veículo: Campo numérico percentual (formato numérico com separador decimal vírgula)
  • Desconsiderar deslocamento viagem?: Checkbox para ativar/desativar esta opção

• Seção de Veículos Permitidos:

  • Seletor de veículos: Campo dropdown para selecionar veículos da frota
  • Botão "Incluir Veículo": Adiciona o veículo selecionado à lista de veículos permitidos
  • Lista de veículos: Exibe os veículos associados à zona, com botão para remover cada veículo

• Botões de ação:

  • Gravar: Salva as alterações (verde)
  • Excluir: Remove a zona (vermelho, apenas visível em edição)
  • Voltar: Retorna à listagem de zonas (branco)

Seção de Mapa (lado direito):

• Mapa interativo: Permite definir a área geográfica da zona
• Controles de zoom: Permitem aumentar e diminuir o zoom do mapa
• Alternância entre visualização de mapa e satélite

Fluxo de Trabalho

Listagem e Filtro de Zonas

1. Ao acessar a tela principal, o usuário visualiza todas as zonas de roteirização cadastradas.
2. O usuário pode filtrar as zonas pelo nome usando o campo de filtro correspondente.
3. Após preencher os critérios de filtro, o usuário clica no botão de pesquisa para aplicar os filtros.
4. O sistema exibe os resultados de acordo com os critérios especificados.
5. O usuário pode limpar os filtros aplicados clicando no botão "Limpar filtros".
6. Os resultados são paginados, permitindo navegação entre as páginas.

Criação de Nova Zona

1. Na tela de listagem, o usuário clica no botão "Novo" (+).
2. O sistema direciona para a tela de criação de zona, exibindo um formulário em branco.
3. O usuário preenche os campos obrigatórios e opcionais:
   • Código da zona (obrigatório)
   • Nome da zona (obrigatório)
   • Peso mínimo (opcional)
   • Percentual mínimo de capacidade do veículo (opcional)
   • Percentual máximo de capacidade do veículo (opcional)
   • Opção de desconsiderar deslocamento na viagem (opcional)
4. Para definir a área da zona, o usuário clica em pontos no mapa para criar um polígono (mínimo de 3 pontos).
5. Para adicionar veículos à zona:
   • Seleciona um veículo na lista suspensa
   • Clica em "Incluir Veículo"
   • Repete o processo para cada veículo desejado
6. Após preencher todos os campos, o usuário clica em "Gravar".
7. O sistema valida os dados e, se corretos, salva a nova zona.
8. O usuário é redirecionado para a tela de listagem.

Edição de Zona Existente

1. Na tela de listagem, o usuário clica na linha correspondente à zona que deseja editar.
2. O sistema carrega a tela de edição com os dados da zona selecionada.
3. O usuário altera os campos desejados.
4. Para modificar a área geográfica, o usuário pode:
   • Adicionar novos pontos clicando no mapa
   • Mover pontos existentes arrastando-os no mapa
5. Para gerenciar veículos, o usuário pode:
   • Adicionar novos veículos
   • Remover veículos existentes clicando no botão "-" correspondente
6. Após realizar as alterações, o usuário clica em "Gravar".
7. O sistema valida e salva as modificações.

Exclusão de Zona

1. Na tela de edição de uma zona existente, o usuário clica no botão "Excluir".
2. O sistema verifica se a exclusão é possível (não há dependências).
3. Se não houver impedimentos, a zona é excluída.
4. O usuário é redirecionado para a tela de listagem.

Importação de Zonas via CSV

1. Na tela de listagem, o usuário clica no botão "Importar".
2. O sistema exibe o modal de importação.
3. O usuário seleciona ou arrasta o arquivo CSV formatado adequadamente.
4. O sistema processa o arquivo e importa as zonas.
5. O resultado da importação é exibido no modal.

Validações e Regras de Negócio

Validações de Formulário

• Nome: Campo obrigatório
• Código: Campo obrigatório, deve ser único
• Área Geográfica: É necessário definir pelo menos 3 pontos no mapa para formar um polígono válido
• Veículos: Não é possível adicionar o mesmo veículo mais de uma vez à mesma zona
• Valores Numéricos: Campos numéricos aceitam apenas números com vírgula como separador decimal

Regras para Exclusão

• Não é possível excluir uma zona que tenha rotas associadas (o sistema exibe mensagem solicitando a transferência das rotas para outra zona)
• Não é possível excluir uma zona que tenha pedidos associados (o sistema exibe mensagem solicitando a transferência dos pedidos para outra zona)

Importação de CSV

• O arquivo CSV deve usar ponto e vírgula (;) como separador
• O arquivo deve conter as colunas CÓDIGO e NOME
• A primeira linha é considerada cabeçalho

Instruções Passo a Passo

Como Filtrar Zonas

1. Acesse a tela "Zonas de Roteirização"
2. Digite o nome ou parte do nome da zona no campo "Nome"
3. Clique no botão de pesquisa (ícone de lupa)
4. Os resultados filtrados serão exibidos na tabela
5. Para limpar os filtros, clique no botão "Limpar filtros" (ícone de documento)

Como Criar uma Nova Zona

1. Acesse a tela "Zonas de Roteirização"
2. Clique no botão "Novo" (ícone de +)
3. Preencha o campo "Código" com o identificador da zona
4. Preencha o campo "Nome" com a descrição da zona
5. Se necessário, preencha os campos opcionais:
   • Peso Mínimo
   • % Mínimo Peso Veículo
   • % Máximo Peso Veículo
   • Marque "Desconsiderar deslocamento viagem?" se aplicável
6. Defina a área geográfica clicando em pelo menos 3 pontos no mapa (cada clique cria um vértice do polígono)
7. Para adicionar veículos:
   • Selecione um veículo no dropdown
   • Clique em "Incluir Veículo"
   • Repita para adicionar múltiplos veículos
8. Clique no botão "Gravar"
9. Verifique se há mensagens de erro e corrija se necessário

Como Editar uma Zona Existente

1. Acesse a tela "Zonas de Roteirização"
2. Clique na linha da zona que deseja editar
3. Altere os campos desejados
4. Para modificar a área geográfica:
   • Clique em pontos no mapa para adicionar novos vértices
   • Arraste os pontos existentes para reposicioná-los
5. Para gerenciar veículos:
   • Para adicionar: selecione um veículo e clique em "Incluir Veículo"
   • Para remover: clique no botão "-" ao lado do veículo
6. Clique no botão "Gravar"

Como Excluir uma Zona

1. Acesse a tela "Zonas de Roteirização"
2. Clique na linha da zona que deseja excluir
3. Na tela de edição, clique no botão "Excluir"
4. Se houver mensagens de impedimento, siga as instruções para resolver as dependências
5. Confirme a exclusão quando solicitado

Como Importar Zonas via CSV

1. Prepare um arquivo CSV com as colunas CÓDIGO e NOME, usando ponto e vírgula (;) como separador
2. Acesse a tela "Zonas de Roteirização"
3. Clique no botão "Importar"
4. No modal exibido, clique em "Anexar..." e selecione o arquivo CSV
5. Aguarde o processamento do arquivo
6. Verifique a mensagem de resultado da importação

Como Exportar Zonas para CSV

1. Acesse a tela "Zonas de Roteirização"
2. Aplique os filtros desejados, se necessário
3. Clique no botão "Exportar para CSV" (ícone de disquete)
4. O arquivo será baixado automaticamente

Perguntas Frequentes

1. O que são Zonas de Roteirização?

Zonas de Roteirização são áreas geográficas delimitadas que auxiliam no planejamento logístico e na organização de rotas. Elas permitem segmentar o território de operação em regiões específicas, facilitando a distribuição de veículos e otimizando o planejamento de entregas.

2. Como são utilizados os percentuais de capacidade do veículo?

Os percentuais mínimo e máximo de capacidade do veículo definem os limites operacionais para cada zona. O percentual mínimo estabelece a ocupação mínima necessária para que um veículo opere na zona, enquanto o percentual máximo define o limite superior. Estes parâmetros ajudam a otimizar a utilização da frota e evitar que veículos circulem com carga insuficiente ou excessiva.

3. O que significa "Desconsiderar deslocamento viagem"?

Esta opção, quando marcada, indica ao sistema que o tempo de deslocamento para a zona não deve ser considerado nos cálculos de roteirização. Isso pode ser útil quando o veículo já se encontra na região ou quando outros fatores específicos fazem com que o deslocamento não deva ser contabilizado no planejamento.

4. Posso atribuir o mesmo veículo a múltiplas zonas?

Sim, é possível atribuir um veículo a várias zonas diferentes. Isso permite flexibilidade no planejamento logístico, especialmente quando a empresa trabalha com áreas que podem se sobrepor ou quando veículos específicos precisam atender a diferentes regiões.

5. Como definir adequadamente o perímetro de uma zona?

Para definir o perímetro, clique em pontos estratégicos no mapa para formar um polígono que represente a área desejada. É importante incluir pelo menos 3 pontos para formar um polígono válido. Considere usar limites naturais ou administrativos (como bairros, cidades ou regiões) para facilitar a compreensão e gestão das zonas.

6. O que acontece com os pedidos e rotas quando uma zona é excluída?

O sistema impede a exclusão direta de zonas que tenham pedidos ou rotas associados. Antes de excluir uma zona com dependências, é necessário transferir esses pedidos e rotas para outra zona existente. O sistema exibirá mensagens orientando sobre este procedimento quando você tentar excluir uma zona com dependências.

7. Quais são os formatos aceitos para importação de zonas?

A importação de zonas aceita apenas arquivos no formato CSV (valores separados por ponto e vírgula). O arquivo deve conter as colunas CÓDIGO e NOME, sendo a primeira linha considerada como cabeçalho. Não é possível importar definições de perímetro através do CSV; estes devem ser configurados manualmente após a importação.

8. É possível editar o perímetro de uma zona após sua criação?

Sim, é possível editar o perímetro a qualquer momento. Na tela de edição da zona, você pode adicionar novos pontos clicando no mapa ou reposicionar pontos existentes arrastando-os para novas posições. Isso permite ajustar a área da zona conforme necessário.

9. Qual é o peso mínimo e para que serve?

O peso mínimo define o volume mínimo de carga (geralmente em kg) necessário para que uma entrega seja alocada para essa zona. Este parâmetro ajuda a garantir que apenas cargas significativas sejam direcionadas para determinadas áreas, otimizando a eficiência operacional.

10. As alterações nas zonas afetam roteirizações já realizadas?

Não, as alterações em zonas não afetam roteirizações já concluídas ou em andamento. As modificações serão aplicadas apenas para novas roteirizações criadas após as alterações, preservando a integridade de operações já em curso.

Vendedor de Roteirização

Visão Geral

O módulo de "Vendedores" de Roteirização é uma ferramenta que permite cadastrar, gerenciar e manter informações dos vendedores que utilizam o sistema de roteirização. As telas apresentadas permitem visualizar, filtrar, adicionar, editar e importar vendedores. Cada vendedor pode ter acesso ao sistema para visualizar pedidos através de credenciais específicas.

Para acessar clique no menu ROTEIRIZAÇÃO opção VENDEDORES.

Tela Principal - Listagem de Vendedores

Descrição

A tela principal exibe uma lista de vendedores cadastrados no sistema com seus respectivos códigos e nomes. A interface possui uma seção de filtros no topo, uma tabela de dados no centro e controles de paginação na parte inferior.

Elementos da Interface

Seção de Filtros

• Título: "Vendedores de Roteirização"
• Campo de texto - Nome: Permite filtrar vendedores pelo nome
• Checkbox - Somente ativo?: Quando marcado, exibe apenas vendedores ativos
• Botões de Ação:
  • Pesquisar: Ícone de lupa, aplica os filtros selecionados
  • Limpar Filtros: Ícone de arquivo, limpa todos os filtros aplicados
  • Novo: Ícone de adição, abre a tela de cadastro de novo vendedor
  • Exportar para CSV: Ícone de salvar, exporta a lista em formato CSV
  • Importar: Abre a janela para importação em massa de vendedores

Tabela de Dados

• Colunas:
  • CÓDIGO: Identificador único do vendedor
  • NOME: Nome completo do vendedor
• Comportamento:
  • Registros inativos aparecem em vermelho
  • Clique em qualquer linha abre a tela de edição daquele vendedor

Paginação

• Indicador de registros: Exibe o intervalo de registros sendo mostrados e o total
• Controles de página: Botões para navegar entre as páginas de resultados

Tela de Cadastro/Edição de Vendedor

Descrição

Esta tela permite adicionar um novo vendedor ou editar as informações de um vendedor existente. Inclui campos para código, nome, status e senha de acesso.

Elementos da Interface

• Título: "Vendedor de Roteirização"
• Campo de texto - Código: Identificador único do vendedor (obrigatório quando se define uma senha)
• Campo de texto - Nome: Nome completo do vendedor (obrigatório)
• Checkbox - Status ativo?: Define se o vendedor está ativo no sistema
• Campo de senha - Senha: Senha para acesso ao sistema de vendedores (mínimo 6 caracteres)
• Alerta informativo: Exibe o endereço para acesso do vendedor ao sistema após cadastro
• Botões de Ação:
  • Gravar: Salva as alterações realizadas
  • Excluir: Remove o vendedor do sistema (visível apenas ao editar vendedores existentes)
  • Voltar: Retorna para a tela de listagem sem salvar alterações

Validações

• O campo Nome é obrigatório
• Quando se define uma senha, o campo Código torna-se obrigatório
• A senha deve ter no mínimo 6 caracteres
• Não podem existir dois vendedores com o mesmo código
• Não podem existir dois vendedores com a mesma senha

Janela de Importação de Vendedores

Descrição

Esta janela modal permite a importação em massa de vendedores através de um arquivo CSV.

Elementos da Interface

• Título: "Arquivo de vendedores para importação"
• Checkbox - Arquivo do Control?: Define o formato específico do arquivo de importação
• Área de upload: Permite anexar um arquivo CSV
• Mensagem informativa: Instrução sobre o formato esperado do arquivo CSV
• Indicação de resultado: Exibe o resultado da importação após o processamento

Fluxos de Trabalho

Consultar Vendedores

1. Acesse a tela principal de Vendedores de Roteirização
2. Utilize os filtros de Nome e/ou Status para refinar a busca (opcional)
3. Clique no botão de Pesquisar (ícone de lupa) para aplicar os filtros
4. Navegue entre as páginas para visualizar todos os resultados

Adicionar Novo Vendedor

1. Na tela principal, clique no botão Novo (ícone de adição)
2. Preencha o Nome do vendedor (obrigatório)
3. Preencha o Código do vendedor (obrigatório se definir senha)
4. Defina o Status (ativo por padrão)
5. Defina uma Senha de acesso (opcional, mínimo 6 caracteres)
6. Clique em Gravar para salvar o novo vendedor

Editar Vendedor Existente

1. Na tela principal, clique sobre a linha do vendedor que deseja editar
2. Modifique os campos necessários
3. Clique em Gravar para salvar as alterações

Excluir Vendedor

1. Na tela de edição de vendedor, clique no botão Excluir
2. Confirme a exclusão quando solicitado
   • Nota: Não é possível excluir vendedores que possuem rotas ou pedidos associados

Importar Vendedores

1. Na tela principal, clique no botão Importar
2. Marque a opção "Arquivo do Control?" se o arquivo estiver neste formato específico
3. Clique em "Anexar..." para selecionar o arquivo CSV
4. Aguarde o processamento e confirmação da importação
   • O arquivo CSV deve ter como delimitador o ponto e vírgula (;)
   • A estrutura esperada é: CÓDIGO;NOME
   • A primeira linha é considerada cabeçalho
   • Vendedores com códigos já existentes serão atualizados

Exportar para CSV

1. Na tela principal, clique no botão de Exportar para CSV (ícone de salvar)
2. O arquivo será gerado com os dados filtrados atualmente exibidos na tela

Regras de Negócio

1. Unicidade de Código: Não é permitido cadastrar dois vendedores com o mesmo código.
2. Unicidade de Senha: Não é permitido cadastrar dois vendedores com a mesma senha.
3. Tamanho da Senha: Quando informada, a senha deve ter no mínimo 6 caracteres.
4. Obrigatoriedade de Código: O código é obrigatório quando se define uma senha.
5. Exclusão de Vendedores: Não é possível excluir vendedores que possuem rotas ou pedidos associados.
6. Importação de Vendedores:
   • Vendedores com códigos já existentes terão seus nomes atualizados
   • Novos vendedores serão cadastrados automaticamente como ativos
7. Acesso do Vendedor: Vendedores com código e senha definidos podem acessar o sistema de pedidos através de um link específico.
8. Status Inativo: Vendedores inativos são mostrados em vermelho na listagem e não podem acessar o sistema.

Funcionalidades Adicionais

1. Formatos de Importação: O sistema suporta dois formatos de importação:
   • Formato padrão: CÓDIGO;NOME
   • Formato Control: Formato específico com mais campos, onde o código é precedido por "00000"
2. Controle de Permissões: O acesso às funcionalidades de gravação e exclusão depende das permissões do usuário logado, sendo respeitadas as capacidades de Master ou permissões de grupo.
3. Navegação Facilitada: A interface permite rápida alternância entre listagem e edição, mantendo os filtros aplicados.
4. Feedback Visual: O sistema exibe mensagens claras de erro ou sucesso para todas as operações realizadas.

Perguntas Frequentes

Como faço para que o vendedor acesse o sistema?

Para permitir que um vendedor acesse o sistema, é necessário cadastrar um código único e uma senha com pelo menos 6 caracteres. Após o cadastro, o vendedor poderá acessar o sistema através do link fornecido na tela de cadastro.

Posso excluir um vendedor que já está associado a pedidos ou rotas?

Não. Para manter a integridade dos dados, o sistema não permite excluir vendedores que possuem pedidos ou rotas associados. É necessário primeiro transferir esses itens para outro vendedor antes de proceder com a exclusão.

Como importar vendedores em lote?

Clique no botão "Importar" na tela principal, prepare um arquivo CSV com as colunas CÓDIGO e NOME separadas por ponto e vírgula (;), e faça o upload do arquivo. Se estiver importando de um sistema Control, marque a opção correspondente.

O que acontece se eu importar um vendedor com código já existente?

O sistema irá atualizar o nome do vendedor existente, mantendo todas as outras informações e associações intactas.

Como filtrar apenas os vendedores ativos?

Na seção de filtros da tela principal, marque a opção "Somente ativo?" e clique no botão de pesquisa (ícone de lupa).

Por que alguns vendedores aparecem em vermelho na listagem?

Os vendedores que aparecem em vermelho na listagem são aqueles que estão inativos (com o campo "Status ativo?" desmarcado).

É possível ter dois vendedores com o mesmo código?

Não. O código é um identificador único e o sistema não permite a duplicidade.

É possível ter dois vendedores com a mesma senha?

Não. Para garantir a segurança, o sistema não permite que dois vendedores utilizem a mesma senha de acesso.

Lojas de Roteirização

Visão Geral

O módulo de "Lojas" de Roteirização é uma parte integrada do sistema de gerenciamento de frota "CONCEPT RASTREAMENTO", responsável pelo cadastro e administração de lojas que participam do processo de roteirização de entregas e coletas. Este módulo permite que os usuários gerenciem informações das lojas, incluindo códigos, senhas e nomes, facilitando a organização logística e o planejamento de rotas.

Para acessar clique no menu ROTEIRIZAÇÃO opção LOJAS.

Elementos da Interface e Funcionalidades

Tela Principal de Listagem

A tela principal apresenta uma listagem de lojas cadastradas no sistema, com os seguintes elementos:

• Cabeçalho: "Lojas de Roteirização"

• Seção de Filtros: Área expansível/retrátil para aplicação de filtros

  • Campo de texto "Nome": Permite filtrar lojas pelo nome
  • Botões de ação:
    • Botão de Pesquisa (ícone de lupa): Executa a busca com o filtro aplicado
    • Botão de Limpar Filtros (ícone de documento): Limpa os critérios de filtro
    • Botão de Novo Registro (ícone de +): Abre a tela de cadastro de nova loja
    • Botão de Exportar para CSV (ícone de disco): Exporta a listagem para um arquivo CSV
    • Botão de Importar (ícone de upload): Abre a tela de importação em lote

• Tabela de Lojas:

  • Colunas:
    • CÓDIGO: Código identificador da loja
    • NOME: Nome da loja
  • Registros paginados com indicador de quantidade na parte inferior
  • Controles de paginação (página atual, próxima, anterior)

Tela de Cadastro/Edição de Loja

Esta tela permite criar novos registros de loja ou editar registros existentes:

• Cabeçalho: "Loja de Roteirização"
• Formulário:
  • Campo "Código": Texto/número identificador único da loja
  • Campo "Nome": Nome completo da loja
  • Campo "Senha": Senha de acesso da loja (opcional)
• Botões de Ação:
  • Gravar: Salva as alterações (cor verde)
  • Excluir: Remove o registro (aparece apenas na edição, cor vermelha)
  • Voltar: Retorna à tela de listagem sem salvar alterações

Tela de Importação de Lojas

Popup para importação em lote de lojas via arquivo CSV:

• Cabeçalho: "Arquivo de lojas para importação"
• Área de Upload: Componente para seleção e upload de arquivo
  • Botão "Anexar..."
• Instruções: Informações sobre o formato esperado do arquivo CSV
  • Texto informativo indicando que o separador deve ser ponto-e-vírgula
  • Sequência das colunas: CÓDIGO;NOME
  • Aviso de que a primeira linha é considerada cabeçalho
• Área de Resposta: Espaço para exibição do resultado da importação

Validações e Regras de Negócio

1. Unicidade de Código:

   • Não é permitido cadastrar duas lojas com o mesmo código
   • Mensagem de erro: "Já existe uma loja com o código informado. Favor informar outro código"

2. Unicidade de Senha:

   • Não é permitido cadastrar duas lojas com a mesma senha
   • Mensagem de erro: "Já existe uma loja com a senha informada. Favor informar outra senha"

3. Obrigatoriedade de Nome:

   • O campo nome é obrigatório para cadastro/edição
   • Validação no cliente antes de enviar ao servidor

4. Restrições para Exclusão:

   • Não é possível excluir lojas que possuem rotas associadas
   • Mensagem: "Para excluir a loja atribua as rotas para outra loja"
   • Não é possível excluir lojas que possuem pedidos associados
   • Mensagem: "Para excluir a loja atribua os pedidos para outra loja"

5. Formato de Importação CSV:

   • O arquivo CSV deve usar ponto-e-vírgula como separador
   • A primeira linha é considerada cabeçalho
   • Ordem das colunas: CÓDIGO;NOME
   • Se a loja já existir (mesmo código), seus dados serão atualizados

Fluxo de Trabalho (Workflow)

O sistema permite as seguintes operações sobre lojas de roteirização:

1. Consulta/Pesquisa:

   • Visualização das lojas existentes
   • Filtragem por nome
   • Paginação para navegação entre resultados

2. Cadastro:

   • Criação de novas lojas com código, nome e senha opcional
   • Validação de unicidade de código e senha

3. Edição:

   • Alteração de dados de lojas existentes
   • Validação de unicidade ao atualizar código ou senha

4. Exclusão:

   • Remoção de lojas (com validação de vínculos existentes)
   • Verificação de dependências (rotas e pedidos)

5. Exportação:

   • Geração de arquivo CSV com os dados listados

6. Importação:

   • Carregamento em lote de lojas via arquivo CSV
   • Atualização automática de registros existentes
   • Criação de novos registros

Instruções Passo a Passo

Como Cadastrar uma Nova Loja

1. Na tela de listagem, clique no botão com ícone "+" (Novo)
2. No formulário que se abre, preencha:
   • Código: Identificador único da loja
   • Nome: Nome completo da loja (obrigatório)
   • Senha: Senha de acesso (opcional)
3. Clique no botão "Gravar" para salvar o registro
4. Se houver algum erro de validação, o sistema exibirá uma mensagem explicativa
5. Após o cadastro bem-sucedido, você retornará à tela de listagem

Como Editar uma Loja Existente

1. Na tela de listagem, clique sobre a linha da loja que deseja editar
2. No formulário de edição, modifique os campos necessários
3. Clique em "Gravar" para salvar as alterações
4. Se houver erros de validação, o sistema exibirá mensagens explicativas
5. Após a edição bem-sucedida, você retornará à tela de listagem

Como Excluir uma Loja

1. Na tela de listagem, clique sobre a linha da loja que deseja excluir
2. No formulário de edição, clique no botão "Excluir"
3. Se a loja tiver rotas ou pedidos associados, o sistema impedirá a exclusão e exibirá uma mensagem explicativa
4. Após a exclusão bem-sucedida, você retornará à tela de listagem

Como Filtrar Lojas

1. Na tela de listagem, verifique se a seção de filtros está expandida
2. Digite o nome ou parte do nome da loja no campo "Nome"
3. Clique no botão com ícone de lupa para aplicar o filtro
4. Para limpar o filtro, clique no botão com ícone de documento ou deixe o campo vazio e clique na lupa

Como Exportar Lojas para CSV

1. Na tela de listagem, aplique os filtros desejados (opcional)
2. Clique no botão com ícone de disco (Exportar para CSV)
3. O sistema gerará e fará o download de um arquivo chamado "Loja.csv"
4. O arquivo incluirá todas as lojas exibidas na tela atual, com as colunas código e nome

Como Importar Lojas via CSV

1. Na tela de listagem, clique no botão "Importar"
2. Na janela popup, clique em "Anexar..."
3. Selecione um arquivo CSV de seu computador
   • O arquivo deve usar ponto-e-vírgula como separador
   • A primeira linha deve conter os cabeçalhos: CÓDIGO;NOME
   • As linhas seguintes devem conter os dados das lojas
4. Após selecionar o arquivo, o upload começará automaticamente
5. Aguarde o processamento e observe a mensagem de resultado
6. O sistema informará quantas lojas foram inseridas e quantas foram atualizadas
7. Clique fora da janela ou no "X" para fechá-la

Perguntas Frequentes (FAQ)

1. Posso cadastrar duas lojas com o mesmo código?

Não. O código é um identificador único para cada loja. Se tentar cadastrar ou editar uma loja com um código já existente, o sistema exibirá uma mensagem de erro.

2. Posso cadastrar duas lojas com a mesma senha?

Não. As senhas das lojas devem ser únicas. Se tentar cadastrar ou editar uma loja com uma senha já utilizada, o sistema exibirá uma mensagem de erro.

3. O campo senha é obrigatório?

Não. Ao cadastrar ou editar uma loja, o campo senha é opcional.

4. Como excluir uma loja que possui rotas associadas?

Antes de excluir a loja, é necessário transferir todas as rotas associadas para outra loja. O sistema não permite a exclusão direta de lojas com rotas vinculadas.

5. Como excluir uma loja que possui pedidos associados?

Antes de excluir a loja, é necessário transferir todos os pedidos associados para outra loja. O sistema não permite a exclusão direta de lojas com pedidos vinculados.

6. O que acontece quando importo um arquivo CSV com lojas já existentes?

Se o código da loja já existe no sistema, os dados serão atualizados com as informações do arquivo CSV. Se o código não existe, uma nova loja será criada.

7. Como sei se a importação de lojas foi bem-sucedida?

Após o upload do arquivo CSV, o sistema exibirá uma mensagem indicando o resultado da importação, incluindo quantas lojas foram inseridas e quantas foram atualizadas.

8. Posso editar o código de uma loja existente?

Sim, mas se o novo código já estiver sendo usado por outra loja, o sistema exibirá uma mensagem de erro e impedirá a alteração.

9. Existem restrições para o formato do código da loja?

O campo código aceita caracteres alfanuméricos sem validação de formato específico. Recomenda-se usar um padrão consistente para facilitar a identificação.

10. A ordem das colunas no arquivo CSV de importação pode ser alterada?

Não. O arquivo CSV deve seguir estritamente a ordem: CÓDIGO;NOME. A alteração desta ordem resultará em erros na importação.

Tipo Ocorrência

Descrição Geral

O módulo "TIPO OCORRÊNCIA" gerencia os tipos de ocorrências relacionadas à roteirização no sistema de gestão de frotas "CONCEPT RASTREAMENTO". É compostO por duas telas principais: uma tela de listagem (grid) que apresenta todos os tipos de ocorrências cadastrados e uma tela de cadastro/edição que permite adicionar novos tipos ou modificar os existentes.

O módulo está focado na categorização e atribuição de responsabilidades para diferentes tipos de ocorrências que podem acontecer durante operações logísticas, permitindo definir se o erro é de responsabilidade do motorista, vendedor ou conferente, além de atribuir um peso numérico para cada tipo de erro.

Para acessar clique no menu ROTEIRIZAÇÃO opção TIPOS DE OCORRÊNCIAS.

Elementos da Interface

Tela de Listagem (Tipo de Ocorrências)

Seção de Filtros

• Nome: Campo de texto para filtrar ocorrências pelo nome
• Botões de Ação:
  • Botão de Pesquisa (ícone de lupa): Executa a pesquisa com base no filtro
  • Botão Limpar Filtros (ícone de arquivo): Limpa o campo de filtro
  • Botão Novo (ícone de adição): Abre a tela de cadastro para novo registro
  • Botão Exportar para CSV (ícone de salvar): Exporta os dados em formato CSV
  • Botão Importar: Abre um popup para importação de dados via CSV

Tabela de Dados

• Colunas:
  • NOME: Nome do tipo de ocorrência
  • ERRO MOTORISTA: Indica se a ocorrência é atribuída ao motorista (SIM ou -)
  • ERRO VENDEDOR: Indica se a ocorrência é atribuída ao vendedor (SIM ou -)
  • ERRO CONFERENTE: Indica se a ocorrência é atribuída ao conferente (SIM ou -)
  • PESO MOTORISTA: Valor numérico do peso do erro para o motorista
  • PESO VENDEDOR: Valor numérico do peso do erro para o vendedor
  • PESO CONFERENTE: Valor numérico do peso do erro para o conferente

Controles de Paginação

• Indicador de páginas (ex: "1 - 9 de 9")
• Navegação entre páginas com setas e números

Tela de Cadastro/Edição (Tipo de Ocorrência)

Campos de Formulário

• Nome: Campo de texto obrigatório para o nome da ocorrência
• Erro do Motorista: Checkbox que indica se o erro é atribuído ao motorista
  • Campo numérico "Peso Motorista" (visível apenas quando o checkbox está marcado)
• Erro do Vendedor: Checkbox que indica se o erro é atribuído ao vendedor
  • Campo numérico "Peso Vendedor" (visível apenas quando o checkbox está marcado)
• Erro do Conferente: Checkbox que indica se o erro é atribuído ao conferente
  • Campo numérico "Peso Conferente" (visível apenas quando o checkbox está marcado)

Botões de Ação

• Gravar: Salva o registro atual (habilitado apenas para usuários com permissão)
• Excluir: Remove o registro atual (visível apenas ao editar um registro existente)
• Voltar: Retorna à tela de listagem

Validações e Regras de Negócio

1. Campo Nome:

   • Obrigatório
   • Texto livre

2. Checkboxes de Erro:

   • Pelo menos um tipo de erro deve ser selecionado (Motorista, Vendedor ou Conferente)

3. Campos de Peso:

   • Numéricos com casas decimais (formato 0,00)
   • Valor mínimo: 0
   • Separador decimal: vírgula
   • Separador de milhar: ponto
   • Apenas visíveis quando o checkbox correspondente está marcado

4. Permissões:

   • Usuários são classificados como "Acesso Master", "Acesso Grupo" ou "Acesso Individual"
   • Os botões Gravar e Excluir são habilitados apenas para:
     • Usuários com "Acesso Master" (sempre)
     • Usuários com "Acesso Grupo" que possuem "capacidadeMaster" ou "grupoPodeSeAlterar"

Fluxo de Trabalho

O fluxo de trabalho desta interface segue um padrão típico de consulta-edição (CRUD):

1. Na tela de listagem, o usuário pode:
   • Visualizar todos os tipos de ocorrência cadastrados
   • Filtrar a lista pelo nome da ocorrência
   • Selecionar um registro para edição (clicando na linha)
   • Adicionar um novo registro (botão Novo)
   • Exportar os dados para CSV
   • Importar dados de um arquivo CSV
2. Na tela de cadastro/edição, o usuário pode:
   • Preencher/alterar os dados do tipo de ocorrência
   • Salvar o registro (botão Gravar)
   • Excluir o registro (botão Excluir - apenas registros existentes)
   • Retornar à tela de listagem sem salvar (botão Voltar)

Instruções Passo a Passo

Como Consultar Tipos de Ocorrência

1. Acesse a tela de listagem "Tipo de Ocorrências"
2. Para filtrar a lista, digite o nome ou parte do nome no campo "Nome"
3. Clique no botão de pesquisa (ícone de lupa)
4. A tabela exibirá os resultados conforme o filtro aplicado
5. Para limpar o filtro, clique no botão "Limpar Filtros" (ícone de arquivo)
6. Navegue entre as páginas usando os controles de paginação, se necessário

Como Adicionar um Novo Tipo de Ocorrência

1. Na tela de listagem, clique no botão "Novo" (ícone de adição)
2. Preencha o campo "Nome" com o nome do tipo de ocorrência
3. Selecione pelo menos um dos checkboxes:
   • "Erro do Motorista?"
   • "Erro do Vendedor?"
   • "Erro do Conferente?"
4. Para cada checkbox selecionado, informe o "Peso" correspondente
5. Clique no botão "Gravar" para salvar o registro
6. O sistema retornará à tela de listagem e o novo registro estará visível

Como Editar um Tipo de Ocorrência

1. Na tela de listagem, localize o registro a ser editado
2. Clique na linha do registro para abrir a tela de edição
3. Modifique os campos desejados
4. Clique no botão "Gravar" para salvar as alterações
5. O sistema retornará à tela de listagem com as alterações aplicadas

Como Excluir um Tipo de Ocorrência

1. Na tela de listagem, localize o registro a ser excluído
2. Clique na linha do registro para abrir a tela de edição
3. Clique no botão "Excluir"
4. Confirme a exclusão quando solicitado
5. O sistema retornará à tela de listagem e o registro não estará mais disponível

Como Exportar Dados para CSV

1. Na tela de listagem, aplique os filtros desejados (opcional)
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. O arquivo CSV será gerado e baixado para o seu computador

Como Importar Dados de um CSV

1. Na tela de listagem, clique no botão "Importar"
2. Selecione o arquivo CSV a ser importado
3. Siga as instruções para mapear as colunas, se necessário
4. Confirme a importação
5. Os dados serão importados e exibidos na tabela

Perguntas Frequentes

O que são os "Pesos" associados a cada tipo de erro?

Os pesos são valores numéricos que representam a gravidade ou importância de cada tipo de erro. Eles podem ser utilizados para cálculos de performance, gerar relatórios estatísticos ou para determinar prioridades de resolução de problemas.

É possível atribuir um tipo de ocorrência a mais de um responsável?

Sim, é possível selecionar qualquer combinação de responsáveis (Motorista, Vendedor e Conferente) para um mesmo tipo de ocorrência. No entanto, pelo menos um responsável deve ser selecionado.

Como o sistema utiliza estas informações de tipos de ocorrência?

Estas informações são utilizadas para categorizar e analisar ocorrências durante operações logísticas. O sistema pode gerar relatórios de desempenho com base nos pesos atribuídos a cada tipo de erro, ajudando a identificar áreas problemáticas e oportunidades de melhoria.

Quem tem permissão para criar ou alterar tipos de ocorrência?

Usuários com "Acesso Master" sempre têm permissão. Usuários com "Acesso Grupo" precisam ter a capacidade "capacidadeMaster" ou a permissão "grupoPodeSeAlterar" habilitada. Usuários com "Acesso Individual" não podem criar ou alterar tipos de ocorrência.

É possível ter dois tipos de ocorrência com o mesmo nome?

Embora não haja uma validação explícita na interface, recomenda-se utilizar nomes únicos para facilitar a identificação e evitar confusões. O banco de dados pode ter restrições que impedem nomes duplicados.

O que acontece se eu tentar excluir um tipo de ocorrência que está sendo usado no sistema?

Se o tipo de ocorrência estiver vinculado a registros existentes, o sistema pode impedir a exclusão e exibir uma mensagem de erro. Isso evita inconsistências de dados.

Posso alterar o responsável por um tipo de ocorrência depois de criado?

Sim, é possível editar qualquer aspecto do tipo de ocorrência, incluindo os responsáveis e seus respectivos pesos, desde que o usuário tenha as permissões adequadas.

Como funcionam as importações e exportações via CSV?

A exportação cria um arquivo CSV com todos os dados exibidos na tabela. A importação permite carregar dados de um arquivo CSV, desde que o formato seja compatível com a estrutura esperada pelo sistema.

Importação de Pedidos por Arquivo Excel

Descrição da Interface

O módulo "Importação de Pedidos" é uma ferramenta do sistema de gerenciamento de frota "CONCEPT RASTREAMENTO" que permite aos usuários importar dados de pedidos a partir de arquivos externos (XLSX, XLS ou CSV) para o sistema. A tela é dividida em três seções principais:

1. Uma seção superior com um título "Importação de Pedidos" e um mapa interativo que ocupa aproximadamente 40% da altura da tela.
2. Uma barra de ferramentas com botões de ação e opções de filtro.
3. Uma tabela de dados que exibe os pedidos importados com múltiplas colunas para visualização e validação dos dados.

O layout é moderno e funcional, otimizado para facilitar a visualização e validação de dados de pedidos antes da importação final.

Para acessar clique no menu ROTEIRIZAÇÃO opção IMPORTAÇÃO DE PEDIDOS.

Elementos da Interface

Mapa Interativo

• Tipo: Componente de mapa do Google
• Funcionalidade: Exibe a localização geográfica dos pedidos com marcadores
• Controles: Zoom in/out, arrastar para navegar
• Propósito: Validação visual das coordenadas dos pedidos

Botões de Ação

• Importar: Abre um diálogo para selecionar e carregar arquivos de pedidos
• Planilha Modelo: Permite baixar um modelo de planilha para preenchimento

Opções de Filtro

• Exibir somente pedidos com erro: Checkbox que filtra a visualização para mostrar apenas os pedidos com erros de validação
• Aceitar Todos Duplicados: Botão que marca todos os pedidos duplicados como aceitos
• Aceitar Duplicado: Botão que marca o pedido selecionado como aceito (ativo apenas quando um pedido duplicado está selecionado)
• Gravar Pedidos: Botão que inicia o processo de salvar os pedidos validados no sistema

Tabela de Pedidos

A tabela contém as seguintes colunas:

1. Seleção: Coluna para selecionar pedidos individuais
2. Status: Ícone indicando o estado de validação do pedido
3. Pedido: Número identificador do pedido
4. Data: Data do pedido (formato YYYY-MM-DD)
5. Hora: Horário do pedido (formato HH:MM)
6. Qtd: Quantidade de itens no pedido
7. R$: Valor monetário total do pedido
8. Descrição: Descrição textual do pedido
9. Ponto Interesse: Código do ponto de interesse associado
10. Endereço: Endereço de entrega do pedido
11. Zona: Área geográfica de entrega
12. Vendedor: Nome do vendedor responsável
13. Loja: Estabelecimento de origem
14. Peso: Peso total do pedido
15. Volume: Volume total do pedido
16. Hora Inicial: Horário inicial da janela de entrega
17. Hora Final: Horário final da janela de entrega
18. T. Atendimento: Tempo estimado de atendimento
19. Carregamento: Número do carregamento
20. Nota Fiscal: Número da nota fiscal
21. Latitude: Coordenada geográfica (latitude)
22. Longitude: Coordenada geográfica (longitude)

Diálogos (Popups)

1. Diálogo de Importação de Arquivo:

   • Título: "Selecione o arquivo que deseja importar"
   • Checkbox: "Arquivo do Control?" - para indicar se o arquivo vem do sistema Control
   • Componente de upload de arquivo: Aceita arquivos .xlsx, .xls, ou .csv
   • Área de mensagem: Exibe feedback sobre o resultado do upload

2. Diálogo de Gravação de Pedidos:

   • Título: "Informe o número do lote"
   • Campo de entrada: Para o número do lote
   • Botão: "Gravar Pedidos" - ativado apenas quando a entrada é válida e não há erros nos pedidos

Paginação

• Indicador de número de registros: Mostra o intervalo atual e total de registros
• Controles de navegação: Botões para avançar/retroceder páginas
• Contador: "1 - 0 de 0" (quando não há dados)

Validações e Tipos de Dados

Campos da Tabela e Suas Validações

1. Pedido:

   • Tipo: Texto/Numérico
   • Validação: Deve ser único no sistema (gera erro de duplicação)
   • Obrigatório: Sim

2. Data:

   • Tipo: Data
   • Formato: YYYY-MM-DD
   • Validação: Data válida
   • Obrigatório: Sim

3. Hora:

   • Tipo: Hora
   • Formato: HH:MM
   • Validação: Horário válido entre 00:00 e 23:59
   • Obrigatório: Sim

4. Qtd:

   • Tipo: Numérico
   • Validação: Número inteiro positivo
   • Obrigatório: Sim

5. R$:

   • Tipo: Monetário
   • Validação: Valor numérico com até duas casas decimais
   • Obrigatório: Sim

6. Descrição:

   • Tipo: Texto
   • Obrigatório: Não

7. Ponto Interesse:

   • Tipo: Texto/Código
   • Validação: Deve existir no cadastro de pontos de interesse
   • Obrigatório: Não, mas recomendado

8. Endereço:

   • Tipo: Texto
   • Obrigatório: Sim, se não houver ponto de interesse

9. Zona:

   • Tipo: Referência
   • Validação: Deve existir no cadastro de zonas
   • Obrigatório: Sim

10. Vendedor:

    • Tipo: Referência
    • Validação: Deve existir no cadastro de vendedores
    • Obrigatório: Sim

11. Loja:

    • Tipo: Referência
    • Validação: Deve existir no cadastro de lojas
    • Obrigatório: Sim

12. Peso:

    • Tipo: Numérico
    • Validação: Valor positivo
    • Obrigatório: Não

13. Volume:

    • Tipo: Numérico
    • Validação: Valor positivo
    • Obrigatório: Não

14. Hora Inicial:

    • Tipo: Hora
    • Formato: HH:MM
    • Validação: Horário válido entre 00:00 e 23:59
    • Obrigatório: Não

15. Hora Final:

    • Tipo: Hora
    • Formato: HH:MM
    • Validação: Horário válido entre 00:00 e 23:59, deve ser posterior à Hora Inicial
    • Obrigatório: Não

16. T. Atendimento:

    • Tipo: Numérico
    • Validação: Valor positivo (em minutos)
    • Obrigatório: Não

17. Carregamento:

    • Tipo: Texto/Numérico
    • Obrigatório: Não

18. Nota Fiscal:

    • Tipo: Texto/Numérico
    • Obrigatório: Não

19. Latitude:

    • Tipo: Coordenada geográfica
    • Validação: Valor decimal válido entre -90 e 90
    • Obrigatório: Sim

20. Longitude:

    • Tipo: Coordenada geográfica
    • Validação: Valor decimal válido entre -180 e 180
    • Obrigatório: Sim

Status de Validação de Pedidos

Os pedidos podem ter os seguintes estados de validação:

• Válido: Sem erros de validação
• Erro: Problemas com campos obrigatórios ou formatos inválidos
• Erro de Latitude/Longitude: Coordenadas inválidas ou ausentes
• Duplicado: Número de pedido já existente no sistema

Propósito e Fluxo de Trabalho

O propósito desta tela é permitir a importação eficiente e validação de pedidos a partir de arquivos externos. O sistema está projetado para validar os dados antes da importação final, ajudando a garantir a integridade dos dados.

Fluxo de Trabalho Principal:

1. O usuário clica no botão "Importar" para iniciar o processo.
2. No diálogo de importação, o usuário pode marcar se o arquivo é proveniente do sistema Control.
3. O usuário seleciona um arquivo para upload (.xlsx, .xls ou .csv).
4. O sistema processa o arquivo e apresenta os dados na tabela, realizando validações automáticas.
5. Os pedidos com erros são destacados, e o usuário pode filtrar para visualizar apenas esses registros.
6. O usuário pode resolver problemas, como aceitar pedidos duplicados.
7. Os pontos de entrega são exibidos no mapa para verificação visual.
8. Após validar todos os pedidos, o usuário clica em "Gravar Pedidos".
9. No diálogo de gravação, o usuário insere um número de lote (ou usa o gerado automaticamente).
10. O sistema salva os pedidos e oferece a opção de iniciar o processo de roteirização.

Regras de Negócio:

• Os pedidos com o mesmo número são tratados como duplicados e precisam de aprovação manual.
• Os pedidos sem coordenadas geográficas válidas são marcados com erro.
• As referências (Zona, Vendedor, Loja) devem existir no cadastro do sistema.
• O sistema pode gerar automaticamente um número de lote para organizar os pedidos.
• Após a gravação, o sistema permite iniciar imediatamente o processo de roteirização.

Instruções Passo a Passo

Como Importar Pedidos

1. Preparação do Arquivo:

   • Recomenda-se usar o modelo de planilha baixado através do botão "Planilha Modelo".
   • Preencha todos os campos obrigatórios para cada pedido.
   • Salve o arquivo em formato Excel (.xlsx ou .xls) ou CSV (.csv).

2. Upload do Arquivo:

   • Clique no botão "Importar" na barra de ferramentas.
   • No diálogo exibido, marque a opção "Arquivo do Control?" se aplicável.
   • Clique na área de upload ou no botão "Anexar..." para selecionar o arquivo.
   • Selecione o arquivo desejado em seu computador.

3. Validação dos Dados:

   • Após o upload, o sistema processará o arquivo e exibirá os pedidos na tabela.
   • Verifique as mensagens de feedback na área de resultado.
   • Os pedidos com erros terão um ícone de status indicativo.
   • Utilize o checkbox "Exibir somente pedidos com erro" para filtrar problemas.

4. Resolução de Problemas:

   • Para pedidos duplicados, selecione o registro e clique em "Aceitar Duplicado".
   • Para aceitar todos os pedidos duplicados de uma vez, clique em "Aceitar Todos Duplicados".
   • Para pedidos com erros de coordenadas, verifique os valores de latitude e longitude.
   • Observe o mapa para confirmar visualmente a localização dos pedidos.

5. Gravação dos Pedidos:

   • Após validar todos os pedidos, clique no botão "Gravar Pedidos".
   • No diálogo exibido, insira um número de lote ou use o gerado automaticamente.
   • Clique em "Gravar Pedidos" para confirmar.
   • Após a gravação bem-sucedida, o sistema oferecerá a opção de iniciar a roteirização.

Como Baixar o Modelo de Planilha

1. Clique no botão "Planilha Modelo" na barra de ferramentas.
2. O arquivo modelo MODELO_IMPORTACAO_PEDIDOS.xlsx será baixado para seu computador.
3. Abra o arquivo e preencha-o com os dados dos pedidos a serem importados.

Perguntas Frequentes

1. Quais formatos de arquivo são aceitos para importação?

O sistema aceita arquivos nos formatos Excel (.xlsx, .xls) e CSV (.csv). É recomendável utilizar o modelo de planilha fornecido pelo sistema para garantir a compatibilidade.

2. O que significa a opção "Arquivo do Control"?

Esta opção deve ser marcada quando o arquivo de importação é proveniente do sistema Control, que possui um formato específico. O sistema adaptará a leitura do arquivo para esse formato especial.

3. Como resolver pedidos com erro de coordenadas?

Pedidos com erros de latitude e longitude precisam ter esses valores corrigidos. Você pode verificar visualmente no mapa se as coordenadas estão corretas. Se necessário, corrija os valores no arquivo original e faça o upload novamente, ou ajuste manualmente os registros com problemas.

4. Por que alguns pedidos aparecem como duplicados?

Pedidos são considerados duplicados quando seu número já existe no sistema ou quando há múltiplos pedidos com o mesmo número no arquivo de importação. Você pode usar as opções "Aceitar Duplicado" ou "Aceitar Todos Duplicados" para prosseguir com a importação mesmo assim.

5. O que é o número de lote?

O número de lote é um identificador único para o conjunto de pedidos importados. Ele é utilizado para organizar os pedidos e facilitar a roteirização posterior. O sistema pode gerar automaticamente um número de lote, ou você pode especificar um de sua preferência.

6. Como funciona a roteirização após a importação?

Após gravar os pedidos com sucesso, o sistema oferece a opção de iniciar o processo de roteirização. Se aceito, você será redirecionado para a tela de roteirização, onde poderá definir rotas otimizadas para entrega dos pedidos importados.

7. Posso importar pedidos sem coordenadas geográficas?

Não. As coordenadas de latitude e longitude são obrigatórias para todos os pedidos, pois são essenciais para o processo de roteirização. Pedidos sem coordenadas válidas serão marcados com erro e não poderão ser importados até que esses dados sejam fornecidos.

8. Quais são os campos obrigatórios para importação?

Os campos obrigatórios são: Número do Pedido, Data, Hora, Quantidade, Valor, Zona, Vendedor, Loja, Latitude e Longitude. Além disso, é necessário fornecer um Endereço se não houver um Ponto de Interesse associado.

9. Como corrigir erros de referência (Zona, Vendedor, Loja)?

Esses erros ocorrem quando as referências no arquivo não existem no cadastro do sistema. Você precisa verificar os códigos ou nomes utilizados e ajustá-los para corresponder aos registros válidos no sistema. Consulte as listas de Zonas, Vendedores e Lojas disponíveis se necessário.

10. O que acontece se eu fechar a tela antes de gravar os pedidos?

Se você fechar a tela antes de gravar os pedidos, todos os dados importados e validações realizadas serão perdidos. É necessário completar o processo de importação e gravação para que os pedidos sejam salvos no sistema.

Considerações Técnicas

A tela de "Importação de Pedidos" foi implementada com Vue.js para o frontend e Java para o backend. A comunicação entre cliente e servidor ocorre via requisições HTTP, com troca de dados em formato JSON ou XML.

O sistema realiza validações tanto no cliente quanto no servidor para garantir a integridade dos dados. O mapa interativo utiliza a API do Google Maps para exibir visualmente a localização dos pedidos.

A interface foi projetada para ser responsiva e funcionar em diferentes tamanhos de tela, com foco na usabilidade e eficiência operacional. A tabela de dados utiliza o componente AgGrid para exibição dos pedidos, permitindo ordenação, filtragem e seleção de registros.

O processo de importação foi otimizado para lidar com grandes volumes de dados, realizando o processamento em lotes quando necessário.

Pedidos

Descrição da Interface

O módulo "Pedidos" tem o com foco em roteirização e logística. Nessa tela você pode consultar todos os pedidos que podem ser objetos da roteirização. Os pedidos podem ser cadastrados de forma manual, ou serem importados através de API de Importação de Pedidos ou pela módulo de IMPORTAÇÃO DE PEDIDOS. A interface possui três seções principais visualizáveis: uma tela de listagem de pedidos com filtros avançados, uma tela de edição/cadastro de pedido detalhada, e uma modal para operações em lote com pedidos selecionados.

O design usa um esquema de cores suave com tons de cinza, branco e destaques em azul, verde e vermelho para ações importantes. A interface segue um padrão responsivo com distribuição em colunas que se adaptam ao tamanho da tela, e utiliza componentes modernos como dropdowns, datepickers, checkboxes e tabelas interativas.

Para acessar clique no menu ROTEIRIZAÇÃO opção PEDIDOS.

Elementos da Interface

Tela de Listagem de Pedidos

Seção de Filtros

• Vendedor: Dropdown para selecionar vendedor
• Loja: Dropdown para selecionar loja
• Zona: Dropdown para selecionar zona geográfica
• Pedido: Campo de texto para buscar por número de pedido
• Carregamento: Campo de texto para buscar por número de carregamento
• Lote: Campo de texto para buscar por número de lote
• Tipo de Data: Dropdown com opções: "Dt. Venda", "Compr. Entrega", "Dt. Renegociação"
• Período: Dois campos de data para filtrar por intervalo de datas
• Status: Dropdown para selecionar o status do pedido/itinerário
• Sem celular?: Checkbox para filtrar pedidos sem número de celular
• Não roteirizados?: Checkbox para filtrar pedidos não roteirizados
• Botões de Ação:
  • Botão para abrir seleção de pedidos (ícone de carrinho)
  • Botão de pesquisa (lupa)
  • Botão para limpar filtros (ícone de documento)
  • Botão para novo registro (ícone de adição)
  • Botão para exportar para CSV (ícone de salvar)

Tabela de Pedidos

• Colunas:
  • Ação (+): Para adicionar pedido à seleção
  • Pedido: Número do pedido
  • Data: Data do pedido
  • Compromisso: Data de compromisso/renegociação
  • Valor Pedido: Valor em moeda
  • Vendedor/Loja: Nome do vendedor e loja
  • Zona: Zona geográfica
  • Celular: Número de contato
  • Carregamento/Lote: Número de carregamento e lote
  • Itinerário: Status e data/hora de entrega

Paginação

• Indicação de registros exibidos (Ex: "1 - 11 de 14")
• Botões de navegação entre páginas

Modal de Pedidos Selecionados

• Título: "Lista de Pedidos Selecionados"
• Tabela de Pedidos Selecionados:
  • Colunas: Pedido, Data, Vendedor
  • Botão para remover pedido da seleção (-)
• Campo Número do Carregamento: Para inserir ou gerar número de carregamento
• Botões de Ação:
  • Excluir em Lote: Para excluir todos os pedidos selecionados
  • Criar Carregamento: Para agrupar pedidos em um carregamento
  • Limpar (ícone X): Para limpar a seleção

Tela de Edição/Cadastro de Pedido

Seção Principal

• Botões de Ação Superior:
  • Gravar: Para salvar o pedido
  • Excluir: Para remover o pedido (visível apenas para registros existentes)
  • Voltar: Para retornar à listagem
  • Ocultar campos opcionais?: Checkbox para simplificar o formulário

Dados do Pedido

• Número do Pedido: Campo de texto (obrigatório)
• Número Nota Fiscal: Campo de texto (opcional)
• Carregamento: Campo de texto (opcional)
• Lote: Campo de texto (opcional)
• Data: Seletor de data e hora (obrigatório)
• Compromisso de Entrega: Seletor de data e hora (opcional)
• Renegociação da Entrega: Seletor de data e hora (opcional)
• Quantidade: Campo numérico (obrigatório)
• Valor: Campo numérico (obrigatório)
• Peso: Campo numérico (obrigatório)
• Volume: Campo numérico (obrigatório)
• Descrição: Campo de texto (obrigatório)

Seção de Localização

• Cliente: Dropdown para selecionar cliente/ponto de interesse
• Endereço: Campo de texto com botão de busca para geolocalização
• Vendedor: Dropdown (obrigatório)
• Loja: Dropdown (obrigatório)
• Zona: Dropdown (obrigatório)

Seção de Restrições

• Horário Inicial: Seletor de hora (obrigatório)
• Horário Final: Seletor de hora (obrigatório)
• T. Atendimento: Campo numérico em minutos (obrigatório)
• Número Celular: Campo de texto com botão para WhatsApp (opcional)
• Liberado para Separação?: Checkbox (opcional)
• Liberado para Roteirização?: Checkbox (opcional)
• Observação: Campo de texto longo (opcional)

Mapa

• Um mapa interativo ocupa aproximadamente 1/3 da tela à direita
• Permite visualizar e definir a localização do pedido
• Mostra o endereço geolocalizado com marcador

Propósito e Fluxo de Trabalho

O sistema serve para gerenciar o ciclo de vida de pedidos desde o registro até a entrega, com foco em operações de distribuição e logística. O fluxo de trabalho típico inclui:

1. Cadastro de Pedidos: Os usuários registram novos pedidos com informações detalhadas sobre o cliente, produtos, quantidades, valores e localização.

2. Gestão de Status: Os pedidos seguem um fluxo de processamento com status como:

   • Venda Finalizada
   • Liberado para Separação
   • Em Separação
   • Separados
   • Liberados para Roteirização
   • Em rota (com vários status possíveis: Aberto, Adiado, Entregue, etc.)

3. Organização em Lotes e Carregamentos: Os pedidos podem ser agrupados em carregamentos para facilitar a logística.

4. Roteirização: Os pedidos são atribuídos a rotas de entrega com base em localização, zona, horários e outras restrições.

5. Acompanhamento: O sistema permite acompanhar o status de cada pedido durante todo o ciclo.

Instruções Passo a Passo para Operações Principais

Pesquisar Pedidos

1. Acesse a tela de listagem de pedidos
2. Na seção de filtros, preencha os campos desejados:
   • Selecione um vendedor, loja ou zona (opcional)
   • Digite um número de pedido ou carregamento específico (opcional)
   • Escolha o tipo de data (Venda, Compromisso, Renegociação)
   • Defina o período de datas a ser pesquisado
   • Selecione um status (opcional)
   • Marque os checkboxes desejados (Sem celular, Não roteirizados)
3. Clique no botão de pesquisa (ícone de lupa)
4. Os resultados serão exibidos na tabela abaixo
5. Use os controles de paginação para navegar entre as páginas de resultados

Cadastrar Novo Pedido

1. Na tela de listagem, clique no botão de novo registro (ícone +)
2. Preencha os campos obrigatórios:
   • Número do Pedido
   • Data
   • Quantidade
   • Valor
   • Peso
   • Volume
   • Descrição
   • Vendedor
   • Loja
   • Zona
   • Horário de Atendimento Inicial e Final
   • Tempo de Atendimento
3. Defina a localização de entrega:
   • Selecione um cliente existente, ou
   • Digite um endereço e use o botão de busca para geolocalização
4. Preencha os campos opcionais conforme necessário
5. Clique no botão "Gravar" para salvar o pedido

Editar um Pedido Existente

1. Na tela de listagem, localize o pedido desejado
2. Clique na linha do pedido para abrir a tela de edição
3. Modifique os campos necessários
4. Clique no botão "Gravar" para salvar as alterações

Criar um Carregamento com Múltiplos Pedidos

1. Na tela de listagem, clique no botão "+" ao lado de cada pedido que deseja incluir
2. Clique no ícone de carrinho de compras para abrir a modal de pedidos selecionados
3. Verifique se todos os pedidos desejados estão na lista
4. No campo "Número do Carregamento":
   • Digite manualmente um número, ou
   • Clique no ícone de tag para gerar um número automaticamente
5. Clique no botão "Criar Carregamento"
6. Confirme a operação quando solicitado

Excluir Pedidos em Lote

1. Na tela de listagem, clique no botão "+" ao lado de cada pedido que deseja excluir
2. Clique no ícone de carrinho de compras para abrir a modal de pedidos selecionados
3. Verifique se todos os pedidos a serem excluídos estão na lista
4. Clique no botão "Excluir em Lote"
5. Confirme a operação quando solicitado

Exportar Dados para CSV

1. Aplique os filtros desejados para restringir os dados a serem exportados
2. Clique no botão de exportar para CSV (ícone de salvar)
3. Selecione o local para salvar o arquivo
4. Confirme a operação

Regras de Negócio e Validações

Validações de Pedido

• Número do Pedido: Obrigatório e deve ser único
• Data: Obrigatória
• Endereço: Obrigatório e deve ter coordenadas válidas (latitude/longitude)
• Vendedor: Obrigatório
• Loja: Obrigatório
• Zona: Obrigatório
• Valor: Obrigatório e deve ser numérico
• Quantidade: Obrigatória e deve ser numérica
• Peso: Obrigatório e deve ser numérico
• Volume: Obrigatório e deve ser numérico
• Descrição: Obrigatória

Status de Pedido

O pedido pode passar pelos seguintes estados:

1. Venda Finalizada: Estado inicial após cadastro
2. Liberado para Separação: Pedido disponível para ser separado no estoque
3. Em Separação: Processo de separação iniciado
4. Separados: Produtos separados e prontos para roteirização
5. Liberados para Roteirização: Disponível para ser incluído em uma rota
6. Em itinerário: Atribuído a uma rota com diferentes sub-estados:
   • Aberto: Incluído na rota mas não iniciado
   • Adiado: Entrega adiada
   • Devolvido: Produto retornou ao depósito
   • Entregue: Entrega realizada com sucesso
   • Pendente: Aguardando resolução de alguma pendência
   • Endereço Fechado: Tentativa de entrega sem sucesso por local fechado
   • Endereço Errado: Endereço incorreto
   • Endereço Não Localizado: Endereço não encontrado
   • Não Informado: Status não atualizado

Funcionamento do Carregamento

• Um carregamento agrupa múltiplos pedidos para otimizar a logística
• O número de carregamento pode ser gerado automaticamente ou definido manualmente
• Pedidos no mesmo carregamento geralmente são entregues na mesma rota

Geolocalização

• O sistema utiliza Google Maps para geolocalização de endereços
• É possível localizar um endereço através de busca textual
• As coordenadas (latitude/longitude) são armazenadas para cada pedido
• O mapa permite ajuste manual da localização através de arrasto do marcador

Perguntas Frequentes

Como filtrar pedidos de um período específico?

Na seção de filtros, selecione o tipo de data que deseja considerar (Venda, Compromisso ou Renegociação), depois defina as datas de início e fim no período desejado e clique no botão de pesquisa.

Como associar múltiplos pedidos a um único carregamento?

Selecione os pedidos desejados clicando no botão "+" ao lado de cada um, depois abra a modal de pedidos selecionados através do ícone de carrinho, defina um número de carregamento e clique em "Criar Carregamento".

Como encontrar pedidos que ainda não foram roteirizados?

Na seção de filtros, marque a opção "Não roteirizados?" e clique no botão de pesquisa.

Como localizar um endereço de entrega no mapa?

Na tela de edição de pedido, digite o endereço no campo "Endereço" e clique no botão de busca (lupa). O sistema irá geocodificar o endereço e posicionar o marcador no mapa.

Como exportar uma lista de pedidos para trabalhar em outro sistema?

Aplique os filtros desejados para obter a lista específica, depois clique no botão de exportar para CSV (ícone de salvar).

Como estabelecer as restrições de horário para entrega?

Na seção de restrições ao editar um pedido, defina o horário inicial e final disponível para entrega, bem como o tempo estimado de atendimento em minutos.

É possível excluir múltiplos pedidos de uma vez?

Sim, selecione os pedidos desejados, abra a modal de pedidos selecionados e clique em "Excluir em Lote".

Como liberar um pedido para roteirização?

Abra o pedido para edição, marque a opção "Liberado para Roteirização?" e salve, ou utilize as funcionalidades em lote para liberar múltiplos pedidos simultaneamente.

Por que não consigo excluir um pedido?

Se o pedido já foi incluído em um itinerário ou rota, o sistema não permitirá sua exclusão para manter a integridade dos dados.

Como posso rapidamente contatar o cliente?

Se o número de celular estiver cadastrado, na tela de edição do pedido aparecerá um ícone do WhatsApp ao lado do campo de celular, que abrirá uma conversa diretamente.

Observações Adicionais

O sistema implementa um fluxo logístico completo que permite o acompanhamento detalhado de cada pedido desde o momento da venda até a entrega final. Com recursos de geolocalização, agrupamento em carregamentos e roteirização, o sistema oferece ferramentas para otimizar a operação logística e reduzir custos.

A interface foi projetada para ser intuitiva e eficiente, permitindo que o usuário execute rapidamente as tarefas mais comuns, como cadastrar pedidos, criar carregamentos e acompanhar entregas, enquanto fornece flexibilidade para casos especiais através de filtros avançados e operações em lote.

A estrutura de dados subjacente mantém relacionamentos entre pedidos, rotas, vendedores, lojas e zonas, permitindo análises detalhadas e relatórios logísticos abrangentes.

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

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

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

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

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

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

8. 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".

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

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

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

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

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

Log Importação Webservice

Visão Geral

O módulo "Log Importação WEBSERVICE" faz parte do sistema de gerenciamento de frota "CONCEPT RASTREAMENTO" e tem como objetivo principal exibir registros de log relacionados ao uso da API de Integração de Importação de Pedidos. Esta interface permite aos usuários visualizar, filtrar e exportar registros de atividades do roteirizador, fornecendo um histórico detalhado das operações realizadas no sistema.

Para acessar clique no menu ROTEIRIZAÇÃO opção LOG IMPORTAÇÃO WEBSERVICE.

Elementos da Interface

Cabeçalho

• Título da página: "Log Importação" - Indica o módulo atual do sistema
• Card de Filtros: Seção colapsável que contém opções para refinar a visualização dos dados

Seção de Filtros

• Botão de Busca: Ícone de lupa que permite aplicar os filtros selecionados
• Botão de Exportar: Ícone de download que permite exportar os dados para CSV

Tabela de Dados

• Colunas:
  • DATA/HORA: Exibe a data e hora formatada do registro de log
  • DESCRIÇÃO: Exibe o conteúdo detalhado do log
• Características da tabela:
  • Ordenação por colunas (clicando no cabeçalho)
  • Redimensionamento de colunas
  • Seleção de linhas individuais
  • Animação ao carregar novos dados
  • Paginação automática

Controles de Paginação

• Contador de registros: Exibe o intervalo atual e total de registros (exemplo: "1 - 20 de 100")
• Navegador de páginas: Permite navegar entre as páginas de resultados
• Exibição máxima: Mostra até 7 números de página por vez

Fluxo de Trabalho

O fluxo principal desta tela envolve a consulta e análise dos registros de log do roteirizador. As operações típicas incluem:

1. Carregamento inicial: Ao acessar a tela, o sistema carrega automaticamente todos os logs disponíveis
2. Visualização: O usuário pode percorrer os registros para analisar as operações realizadas
3. Exportação: Os dados podem ser exportados para formato CSV para análise externa ou arquivamento

Instruções Passo a Passo

Como Consultar Logs

1. Acesse a tela "Log Importação" no menu principal
2. A tela carregará automaticamente os logs disponíveis
3. Utilize a paginação na parte inferior da tela para navegar entre as páginas
4. Clique nos cabeçalhos das colunas para ordenar os registros conforme necessário

Como Exportar Dados para CSV

1. Aplique os filtros desejados (se necessário)
2. Clique no botão verde com ícone de download (salvar)
3. O sistema exportará os dados em formato CSV com o nome "LogImportacao.csv"
4. O arquivo utilizará ponto e vírgula (;) como separador de colunas

Funcionalidades e Regras de Negócio

• O sistema consulta logs específicos do usuário atual (identificado pela session)
• A listagem é realizada através de uma requisição POST para o endpoint "/rest/LogRoteirizador/Listar"
• O sistema verifica se a resposta contém um código de erro "99", redirecionando para a tela de login se necessário
• A tabela tem tratamento para diferentes quantidades de registros retornados (nenhum, um único ou múltiplos)
• A altura da tabela é calculada dinamicamente com base na altura da janela (calc(100vh - 285px))
• As colunas da tabela se ajustam automaticamente ao tamanho disponível

Perguntas Frequentes

Por que não vejo nenhum registro na tabela?

Se não houver registros visíveis, pode ser que não existam logs para o período selecionado ou que seu usuário não tenha permissões para visualizar esses registros. Verifique se você está logado com o usuário correto.

Como posso ordenar os registros por data?

Clique no cabeçalho da coluna "DATA/HORA" para ordenar os registros. Clique novamente para alternar entre ordem crescente e decrescente.

É possível filtrar os logs por tipo específico de operação?

A implementação atual não inclui filtros por tipo específico de operação, mas você pode exportar os dados para CSV e utilizar ferramentas como Excel para filtros mais avançados.

Como posso analisar um grande volume de logs?

Para analisar grandes volumes, recomenda-se exportar os dados para CSV e utilizar ferramentas específicas de análise de dados como Excel, Power BI ou outras ferramentas de análise.

O que significam os diferentes tipos de mensagens nos logs?

As mensagens de log contêm informações sobre operações do roteirizador, como início e término de processamentos, erros encontrados, e ações realizadas. Consulte a documentação específica do roteirizador para detalhes sobre cada tipo de mensagem.

Por que fui redirecionado para a tela de login?

Se você foi redirecionado para a tela de login durante a consulta, provavelmente sua sessão expirou. Isso ocorre quando o sistema retorna o código "99", indicando necessidade de nova autenticação.

Observações Adicionais

• A interface utiliza o componente AgGrid para exibição de dados tabulares
• O design segue o padrão visual do sistema, com cards e tabelas estilizadas
• A responsividade da interface permite adaptação a diferentes tamanhos de tela
• As operações de backend são realizadas de forma assíncrona, com indicadores visuais de carregamento

---

Esta documentação fornece uma visão abrangente da tela de "Log Importação", cobrindo seus elementos, funcionalidades e fluxos de trabalho principais, servindo como referência para usuários do sistema de gerenciamento de frota.

Status Itinerário Customizado

Visão Geral

O módulo "Status de Itinerário Customizado" permite a personalização das descrições dos diferentes status de itinerário utilizados no módulo de roteirização. Esta funcionalidade possibilita adaptar a terminologia padrão do sistema para termos que façam mais sentido para a operação específica de cada empresa.

Através desta interface, usuários podem:

• Visualizar os status padrão do sistema
• Personalizar as descrições destes status
• Definir descrições específicas para visitas
• Determinar quais status são aplicáveis a visitas

Para acessar clique no menu ROTEIRIZAÇÃO opção STATUS ITINERÁRIO

Elementos da Interface

Tela Principal (Listagem)

A tela principal apresenta uma listagem dos status de itinerário existentes com suas configurações atuais.

Cabeçalho:

• Título: "Status Itinerários Customizado"
• Seção de filtros (colapsável)
• Botões de ação no canto superior direito:
  • Botão de pesquisa (ícone de lupa)
  • Botão de adicionar novo registro (ícone de +)

Tabela de Status:

• Colunas:
  • DESCRIÇÃO: Mostra o nome padrão do status no sistema
  • CUSTOMIZADA: Exibe a descrição personalizada configurada
  • VISITA: Apresenta a descrição específica para visitas
  • STATUS PARA VISITA?: Indica se o status pode ser utilizado para visitas (SIM ou -)

Status disponíveis:

1. Aberta
2. Adiado
3. Devolvido
4. Endereço Errado
5. Endereço Fechado
6. Endereço Não Localizado
7. Entregue
8. Não Informado
9. Pendente

Tela de Edição

A tela de edição permite configurar os detalhes de cada status.

Cabeçalho:

• Título: "Status Itinerários Customizado - Edição"

Formulário: Para cada status disponível, são apresentados os seguintes campos:

• Status: Nome do status no sistema (somente leitura, em destaque)
• Descrição Customizada: Campo de texto para definir nome personalizado
• Descrição para Visita: Campo de texto para definir descrição específica para visitas
• Para visita: Checkbox para definir se o status é aplicável a visitas

Botões de Ação:

• Gravar: Salva as modificações realizadas
• Voltar: Retorna à tela de listagem sem salvar alterações

Fluxo de Trabalho

Processo Principal

1. O usuário acessa a tela principal de "Status Itinerários Customizado"
2. Visualiza os status existentes e suas configurações atuais
3. Clica no botão de adicionar novo ou seleciona um registro existente
4. Na tela de edição, personaliza as descrições conforme necessário
5. Define quais status são aplicáveis a visitas
6. Salva as alterações

Instruções Passo a Passo

Como Customizar Status de Itinerário

1. Acesse o módulo "Status Itinerários Customizado" no menu principal
2. Clique no botão com ícone de lupa para pesquisar registros existentes, ou no botão "+" para criar uma nova configuração
3. Na tela de edição, para cada status:
   • Digite a "Descrição Customizada" desejada no campo correspondente
   • Se aplicável, digite a "Descrição para Visita" específica
   • Marque o checkbox "Para visita" se este status deve ser disponível para classificação de visitas
4. Clique no botão "Gravar" para salvar as alterações
5. Verifique na tela de listagem se as modificações foram aplicadas corretamente

Como Redefinir Status para Configuração Padrão

1. Acesse a tela de edição dos status
2. Apague o conteúdo dos campos "Descrição Customizada" e "Descrição para Visita"
3. Desmarque todos os checkboxes "Para visita"
4. Clique em "Gravar" para salvar

Regras de Negócio e Validações

1. Validação de Campos Obrigatórios:

   • Se o checkbox "Para visita" estiver marcado, o campo "Descrição para Visita" torna-se obrigatório
   • Uma mensagem de erro será exibida caso essa condição não seja atendida

2. Persistência de Dados:

   • Ao salvar as alterações, o sistema exclui todas as configurações anteriores e salva as novas definições
   • Se um campo de descrição customizada for deixado em branco, o sistema utilizará o nome padrão do status
   • Se um campo de descrição para visita for deixado em branco, o sistema utilizará a descrição padrão para visita

3. Controle de Acesso:

   • Apenas usuários com perfil de administrador ou com permissão específica podem gravar alterações
   • Usuários sem permissão podem visualizar mas não modificar as configurações

Perguntas Frequentes

O que são os Status de Itinerário?

Os status de itinerário são classificações utilizadas para indicar a situação atual de uma entrega ou visita. Exemplos incluem "Entregue", "Pendente", "Endereço Fechado", entre outros.

Por que customizar os Status de Itinerário?

A customização permite adaptar a terminologia do sistema à linguagem utilizada na operação diária da empresa, facilitando o entendimento e uso por parte dos colaboradores.

Qual a diferença entre "Descrição Customizada" e "Descrição para Visita"?

A "Descrição Customizada" substitui o nome padrão do status em todo o sistema, enquanto a "Descrição para Visita" é utilizada especificamente quando o status é aplicado a visitas (e não a entregas comuns).

O que acontece se eu deixar um campo de descrição em branco?

Se um campo de descrição customizada for deixado em branco, o sistema utilizará o nome padrão original. O mesmo princípio se aplica para as descrições de visita.

É possível ter diferentes configurações de status para diferentes filiais?

Não, a customização de status de itinerário é aplicada em nível global para toda a empresa no sistema.

Por que alguns status não aparecem como opção para visitas mesmo quando marco o checkbox?

Para que um status seja disponibilizado para classificação de visitas, é necessário não apenas marcar o checkbox "Para visita", mas também preencher a "Descrição para Visita".

O que acontece com registros históricos ao alterar as descrições dos status?

As alterações nas descrições dos status são aplicadas a todo o sistema, incluindo registros históricos. Portanto, relatórios antigos exibirão as novas descrições.

Notas Importantes

• A customização dos status afeta a visualização em todo o sistema, incluindo relatórios e interfaces móveis
• É recomendável escolher descrições claras e consistentes para facilitar o entendimento de todos os usuários
• Alterações nas descrições dos status não modificam a lógica de funcionamento do sistema, apenas a terminologia exibida

Gerenciamento de Pedidos

Visão Geral do Sistema

O módulo de Gerenciamento de Pedidos é uma ferramenta completa para controlar o fluxo de pedidos desde a venda até a entrega. Esta interface centraliza as operações de separação, roteirização e monitoramento de pedidos, permitindo uma gestão eficiente da cadeia logística.

O módulo trabalha com um fluxo definido de estados pelos quais os pedidos transitam:

1. Venda Finalizada (inicial)
2. Liberado para Separação
3. Em Separação
4. Separados
5. Liberados para Roteirização
6. Não Entregues

Para acessar clique no menu ROTEIRIZAÇÃO opção GERENCIAMENTO DE PEDIDOS.

Elementos da Interface

Área de Filtros

No topo da tela, existe uma área de filtros que permite ao usuário refinar a visualização dos pedidos:

• Vendedor: Campo de seleção que lista todos os vendedores cadastrados no sistema
• Loja: Campo de seleção para escolher a loja específica
• Zona: Campo de seleção para filtrar por zona de entrega
• Pedido: Campo de texto para buscar por número específico de pedido
• Carregamento: Campo de texto para filtrar por número de carregamento
• Dt. Venda: Menu suspenso com opções "Dt. Venda", "Compr. Entrega" e "Dt. Renegociação"
• Intervalo de Data: Dois campos de data para definir período de busca
• Botões de Ação:
  • Botão de pesquisa (ícone de lupa)
  • Botão de limpar filtros (ícone de documento)
  • Botão de sair (ícone de porta) - visível apenas quando logado como vendedor

Abas de Navegação

O sistema organiza os pedidos em seis abas, representando os diferentes estágios do fluxo:

1. Venda Finalizada: Pedidos com venda concluída que ainda não foram liberados
2. Liberado para Separação: Pedidos aprovados para iniciar o processo de separação
3. Em Separação: Pedidos sendo processados pelo setor de separação
4. Separados: Pedidos com separação concluída
5. Liberados para Roteirização: Pedidos prontos para planejamento de rotas
6. Não Entregues: Pedidos com problemas de entrega

Grade de Dados

A grade principal exibe os pedidos filtrados com as seguintes colunas:

• Seleção: Coluna com checkbox para seleção individual de pedidos
• Pedido: Número identificador único do pedido
• Cliente: Nome do ponto de interesse (cliente)
• Data Venda: Data e hora do registro da venda
• Compromisso: Data e horário programados para entrega
• Vendedor: Nome do vendedor responsável
• Loja: Estabelecimento de origem
• Zona: Região de entrega
• Peso: Valor numérico com duas casas decimais (em kg)
• Volume: Valor numérico com três casas decimais (em m³)
• Valor: Montante financeiro do pedido formatado com vírgula decimal
• Carregamento: Número de identificação do carregamento
• Observação: Campo de texto com anotações sobre o pedido
• Tempo Separação: (Visível na aba "Em Separação") Duração do processo
• Compromisso Separação: (Visível na aba "Em Separação") Data e hora programada

Indicadores Visuais

• Ícones de status: Indicadores visuais (círculos coloridos) que mostram o estado dos pedidos
  • Vermelho: Pedidos com atraso (compromisso de entrega vencido)
  • Amarelo: Alerta para prazos próximos do vencimento
  • Verde: Pedidos dentro do prazo
• Contador de pedidos: Exibe a quantidade total de pedidos na aba atual
• Filtros de visualização:
  • Checkbox "Pedidos Atrasados": Filtra apenas pedidos com compromisso vencido
  • Checkbox "Atraso Separação": Filtra pedidos com prazo de separação vencido (aba "Em Separação")
  • Checkbox "Exibir Somente sem Celular": Filtra pedidos sem número de celular cadastrado

Modal de Pedidos Selecionados

Ao clicar no ícone de carrinho ou ao selecionar pedidos, um modal é apresentado com:

• Lista de Pedidos Selecionados: Tabela com pedidos escolhidos (Pedido, Data, Vendedor)
• Campo Número do Carregamento: Para associar um carregamento aos pedidos
• Botão Gerar Carregamento: Para gerar automaticamente um número sequencial
• Botões de Ação: Variam conforme a aba atual, podendo incluir:
  • Criar Carregamento
  • Liberar para Separação
  • Iniciar Separação
  • Finalizar Separação
  • Liberar para Roteirização
  • Cancelar operações diversas

Fluxo de Trabalho e Propósito

O sistema gerencia o ciclo de vida completo dos pedidos, desde a venda até a entrega:

1. Registro da Venda: O pedido inicia na aba "Venda Finalizada"
2. Liberação para Separação: Aprovação para iniciar o processo de separação de mercadorias
3. Separação em Andamento: Acompanhamento do processo de separação física dos produtos
4. Confirmação de Separação: Registro da conclusão da separação
5. Roteirização: Planejamento das rotas de entrega
6. Acompanhamento de Entregas: Monitoramento de pedidos que não foram entregues

O propósito principal é garantir um fluxo eficiente e rastreável dos pedidos em cada etapa, permitindo o controle de prazos, a gestão de carregamentos e o monitoramento de desempenho logístico.

Instruções Passo a Passo

Filtrar Pedidos

1. Selecione os critérios desejados na área de filtros (Vendedor, Loja, Zona, etc.)
2. Defina o tipo de data para filtro (Venda, Compromisso ou Renegociação)
3. Informe o intervalo de datas se necessário
4. Clique no botão com ícone de lupa para aplicar os filtros
5. Para limpar todos os filtros, clique no botão com ícone de documento

Liberar Pedidos para Separação

1. Na aba "Venda Finalizada", selecione os pedidos desejados clicando nos checkboxes
2. Clique no ícone de carrinho na parte superior direita
3. No modal que se abre, você pode:
   • Clicar em "Liberar" para simplesmente liberar os pedidos
   • Informar um número de carregamento e clicar em "Criar Carregamento"
   • Combinar ambas as ações clicando em "Liberar e Criar Carregamento"
4. Os pedidos serão movidos para a aba "Liberado para Separação"

Iniciar Processo de Separação

1. Na aba "Liberado para Separação", selecione os pedidos desejados
2. Clique no ícone de carrinho
3. No modal, informe a data e hora previstas para conclusão da separação
4. Clique em "Iniciar Separação"
5. Os pedidos serão movidos para a aba "Em Separação"

Finalizar Separação

1. Na aba "Em Separação", selecione os pedidos com separação concluída
2. Clique no ícone de carrinho
3. No modal, escolha entre:
   • "Finalizar Separação" para apenas registrar a conclusão
   • "Finalizar Separação + Liberar Roteirização" para avançar para a próxima etapa
4. Os pedidos serão movidos para "Separados" ou "Liberados para Roteirização"

Liberar para Roteirização

1. Na aba "Separados", selecione os pedidos que deseja roteirizar
2. Clique no ícone de carrinho
3. No modal, escolha entre:
   • "Liberar" para ativar a roteirização
   • Informar um número de carregamento e clicar em "Criar Carregamento"
   • "Liberar e Criar Carregamento" para ambas as ações
4. Os pedidos serão movidos para a aba "Liberados para Roteirização"

Exportar Dados

1. Em qualquer aba, clique no botão com ícone de download
2. Os dados da grade serão exportados em formato CSV

Regras de Negócio

Validações e Transições de Estado

1. Liberação para Separação:

   • Verifica se o pedido está no estado "Venda Finalizada"
   • Atualiza o status para "Liberado para Separação"
   • Opcional: associa a um número de carregamento

2. Início de Separação:

   • Verifica se o pedido está liberado para separação
   • Registra data/hora de início
   • Armazena compromisso de conclusão da separação
   • Atualiza status para "Em Separação"
   • Calcula e monitora tempo de separação

3. Finalização de Separação:

   • Verifica se o pedido está em separação
   • Registra conclusão
   • Atualiza status para "Separado"
   • Opcional: libera automaticamente para roteirização

4. Liberação para Roteirização:

   • Verifica se o pedido está separado
   • Atualiza status para "Liberado para Roteirização"
   • Opcional: associa a um número de carregamento

Monitoramento de Prazos

• O sistema calcula automaticamente atrasos com base nos compromissos registrados
• Pedidos atrasados são sinalizados com indicadores visuais
• Filtros específicos permitem localizar rapidamente pedidos críticos

Carregamentos

• O sistema permite agrupar pedidos em carregamentos para otimizar a logística
• Números de carregamento podem ser gerados automaticamente ou informados manualmente
• Um pedido só pode pertencer a um único carregamento

Perguntas Frequentes

1. Como liberar vários pedidos de uma vez?

Utilize a funcionalidade de seleção múltipla marcando os checkboxes correspondentes aos pedidos desejados. Alternativamente, você pode clicar no botão "+" (adicionar todos) para selecionar todos os pedidos visíveis na tela.

2. O que fazer quando um pedido tem separação interrompida?

Na aba "Em Separação", selecione o pedido com problema, abra o modal e use a opção "Cancelar Separação". O pedido voltará para a aba "Liberado para Separação" e poderá ser processado novamente.

3. Como funcionam os filtros de atrasados?

Os filtros "Pedidos Atrasados" e "Atraso Separação" limitam a visualização apenas a itens com prazos vencidos, facilitando a priorização. O sistema calcula automaticamente o atraso com base nos compromissos registrados.

4. É possível cancelar a liberação de um pedido?

Sim. Nas abas correspondentes, existem opções para cancelar liberações. Na aba "Liberado para Separação", utilize a função "Cancelar Liberação Separação"; na aba "Liberados para Roteirização", use "Cancelar Liberação".

5. Como gerar um número de carregamento automaticamente?

Ao abrir o modal de ações, clique no ícone ao lado do campo "Número do Carregamento". O sistema gerará automaticamente um número sequencial usando um padrão predefinido.

6. Quais são as permissões necessárias para cada operação?

As operações de liberação, separação e roteirização dependem de permissões específicas. Usuários com capacidade "Master" têm acesso total, enquanto outros precisam de permissões "Gravar" atribuídas ao seu grupo. Vendedores têm acesso limitado à visualização dos próprios pedidos.

7. Como identificar pedidos sem número de celular?

Na aba "Venda Finalizada", marque o checkbox "Exibir Somente sem Celular" para filtrar pedidos que precisam de atualização de contato antes da entrega.

8. É possível reliberar um pedido não entregue?

Sim. Na aba "Não Entregues", selecione o pedido e utilize as opções "Liberar para Separação" ou "Liberar para Roteirização", dependendo do fluxo necessário para o reprocessamento.

Conclusão

O Sistema de Gerenciamento de Pedidos oferece uma visão completa e detalhada do fluxo logístico, permitindo acompanhar cada etapa do processo. Com funcionalidades para filtragem, agrupamento, monitoramento de prazos e ações em lote, a ferramenta otimiza a gestão de pedidos e contribui para a eficiência operacional.

A interface é projetada para facilitar a visualização do estado de cada pedido e permitir ações rápidas para avançar no fluxo de processamento, resultando em melhor controle do processo logístico e maior satisfação do cliente.

Registro de Parada

Descrição da Interface

O módulo"Registro de Paradas" é uma ferramenta que permite aos usuários monitorar e analisar as paradas registradas no aplicativo MINHA ROTA. A tela está dividida em duas seções principais: à esquerda, um painel de filtros e uma tabela de resultados; à direita, um mapa interativo que mostra a localização geográfica das paradas registradas.

O layout é limpo e organizado, seguindo um fluxo lógico de trabalho que permite ao usuário facilmente selecionar os parâmetros de pesquisa e visualizar os resultados tanto em formato tabular quanto geográfico.

Para acessar clique no menu ROTEIRIZAÇÃO opção REGISTRO DE PARADAS.

Elementos da Interface

Painel de Filtros

1. Cabeçalho da Tela

   • Título: "Visualização de Registro de Paradas"

2. Seleção de Veículo

   • Rótulo: "1. Selecione o veículo:"
   • Tipo: Menu suspenso (dropdown)
   • Obrigatório: Sim
   • Valores: Lista de veículos ativos do cliente
   • Formato de exibição: Marca, modelo, placa, identificação opcional (labelVeiculo) e nome do condutor
   • Funcionalidade de pesquisa: Filtra por marca, modelo, placa, condutor ou identificação do veículo

3. Seleção de Tipo de Parada

   • Rótulo: "2. Escolha o tipo de parada (opcional):"
   • Tipo: Menu suspenso (dropdown)
   • Obrigatório: Não
   • Valores possíveis:
     • Parada programada
     • Solicitação de motorista
     • Solicitação externa
     • Solicitação agente rodoviário
     • Acidente na Via
     • Acidente com o veículo
     • Defeito no veículo
     • Troca programada de veículo
     • Outro

4. Seleção de Data

   • Rótulo: "3. Informe a Data (opcional):"
   • Tipo: Seletor de data (date picker)
   • Obrigatório: Não
   • Formato: Dia/Mês/Ano
   • Configuração: Calendário interativo para seleção da data

5. Botão de Pesquisa

   • Rótulo: "Pesquisar"
   • Ícone: Lupa (feather icon "icon-search")
   • Estado: Desabilitado quando nenhum veículo está selecionado
   • Função: Realiza a pesquisa com os parâmetros configurados

6. Botão Ver Todos

   • Rótulo: "Ver Todos"
   • Ícone: "select_all"
   • Visibilidade: Aparece apenas quando um aviso está selecionado
   • Função: Exibe todos os marcadores no mapa

Tabela de Resultados

1. Tabela de Paradas

   • Colunas:
     • Número da ordem (contagem regressiva)
     • Ícone do tipo de parada
     • Detalhes da parada
   • Funcionalidade: Selecionar uma linha destaca a respectiva parada no mapa
   • Rolagem: Possui barra de rolagem vertical quando há muitos registros
   • Mensagem quando não há dados: "Não existem dados para os parâmetros informados."

2. Detalhes na Coluna de Parada:

   • Tipo de parada
   • Data e hora da parada
   • Informações do veículo (modelo, placa, condutor)
   • Descrição/localização (quando disponível)

Mapa Interativo

1. Mapa

   • Tipo: Google Maps
   • Posição: Ocupa a metade direita da tela
   • Funcionalidades:
     • Marcadores indicando a localização das paradas
     • Zoom ajustável
     • Modo de visualização alternável (Mapa/Satélite)
     • Ajuste automático de zoom para mostrar todos os pontos
     • Centralização automática ao selecionar uma parada na tabela

2. Marcadores do Mapa

   • Representação visual: Ícones diferenciados por tipo de parada
   • Informações ao passar o mouse: Tipo de parada, condutor, descrição, data/hora

Propósito e Fluxo de Trabalho

Propósito

A ferramenta "Visualização de Registro de Paradas" permite aos gestores de frota monitorar e analisar as paradas não planejadas e programadas dos veículos. Isso ajuda a:

• Identificar padrões de paradas não autorizadas
• Monitorar o cumprimento de rotas planejadas
• Avaliar tempos de descanso e paradas de motoristas
• Analisar ocorrências de problemas mecânicos ou acidentes
• Verificar pontos de abastecimento ou manutenção

Fluxo de Trabalho

1. O usuário seleciona um veículo da frota (campo obrigatório)
2. Opcionalmente, o usuário pode filtrar por tipo específico de parada
3. Opcionalmente, o usuário pode especificar uma data para a pesquisa
4. Ao clicar em "Pesquisar", o sistema:
   • Consulta o banco de dados por registros que correspondam aos filtros
   • Exibe os resultados na tabela à esquerda
   • Posiciona marcadores no mapa para cada parada encontrada
   • Ajusta o zoom do mapa para mostrar todos os marcadores
5. O usuário pode selecionar uma parada específica na tabela para:
   • Centralizar o mapa nessa localização
   • Mostrar apenas esse marcador no mapa
6. O usuário pode clicar em "Ver Todos" para exibir novamente todos os marcadores no mapa

Instruções Passo a Passo

Como Visualizar Registros de Paradas

1. Selecionar um Veículo

   • Clique no campo dropdown "1. Selecione o veículo"
   • Digite para filtrar a lista ou selecione diretamente um veículo da lista exibida
   • Confirme a seleção clicando no veículo desejado

2. Aplicar Filtros Opcionais

   • Para filtrar por tipo de parada:

     • Clique no campo dropdown "2. Escolha o tipo de parada (opcional)"
     • Selecione um dos tipos de parada disponíveis

   • Para filtrar por data:

     • Clique no campo de data "3. Informe a Data (opcional)"
     • Selecione a data desejada no calendário que aparece

3. Realizar a Pesquisa

   • Clique no botão "Pesquisar" (com ícone de lupa)
   • Aguarde o carregamento dos resultados

4. Analisar os Resultados

   • Verifique a tabela à esquerda para uma lista das paradas encontradas
   • Observe o mapa à direita para a localização geográfica das paradas
   • Note que o sistema automaticamente ajusta o zoom do mapa para mostrar todos os pontos

5. Examinar uma Parada Específica

   • Clique em uma linha da tabela para selecionar uma parada específica
   • O mapa centralizará automaticamente nesse ponto e ocultará os demais marcadores
   • Para voltar a ver todos os marcadores, clique no botão "Ver Todos"

Como Interpretar os Marcadores no Mapa

1. Os marcadores no mapa representam as paradas registradas
2. A cor e ícone do marcador indicam o tipo de parada
3. Ao passar o mouse sobre um marcador, uma dica de contexto exibirá:
   • Tipo de parada
   • Nome do condutor
   • Descrição da localização (quando disponível)
   • Data e hora da parada

Validações e Regras de Negócio

1. Seleção de Veículo

   • É obrigatória para realizar a pesquisa
   • O botão "Pesquisar" permanece desabilitado até que um veículo seja selecionado

2. Filtros Opcionais

   • Tipo de parada e data são opcionais
   • Se nenhum filtro opcional for aplicado, o sistema retornará todos os registros de parada do veículo selecionado

3. Exibição de Resultados

   • Se não houver registros correspondentes aos filtros aplicados, uma mensagem de alerta será exibida: "Não existem dados para os parâmetros informados."
   • A tabela e o mapa são atualizados apenas após clicar no botão "Pesquisar"

4. Integração com o Mapa

   • Os marcadores no mapa são sincronizados com a tabela de resultados
   • Selecionar um registro na tabela afeta a visualização do mapa, mas não vice-versa

5. Permissões

   • Apenas usuários com acesso à funcionalidade "REGISTRO_PARADAS" podem visualizar esta tela
   • Os veículos listados são filtrados conforme as permissões do usuário logado

Perguntas Frequentes

Por que o botão "Pesquisar" está desabilitado?

O botão "Pesquisar" permanecerá desabilitado até que um veículo seja selecionado, pois este é um campo obrigatório para a consulta. Selecione um veículo na primeira lista suspensa para habilitar o botão.

Como posso ver paradas de um período específico?

A tela atual permite filtrar por uma data específica. Se você precisa visualizar um intervalo de datas, será necessário realizar pesquisas individuais para cada dia e analisar os resultados separadamente.

Por que alguns veículos não aparecem na lista de seleção?

A lista exibe apenas veículos ativos associados ao seu usuário e que possuem pelo menos um registro de parada. Verifique se o veículo está ativo no sistema e se você tem as permissões necessárias para visualizá-lo.

Como distinguir entre diferentes tipos de paradas no mapa?

Cada tipo de parada é representado por um ícone diferente no mapa. A legenda específica não está visível na interface, mas ao passar o mouse sobre um marcador, você verá o tipo de parada na dica de contexto.

É possível exportar os dados das paradas?

A funcionalidade de exportação não está disponível diretamente nesta tela. Para obter relatórios exportáveis, você precisará utilizar o módulo de relatórios do sistema.

Por que o mapa mostra apenas um marcador depois que selecionei uma parada?

Quando você seleciona uma parada específica na tabela, o sistema oculta temporariamente os outros marcadores para facilitar a visualização do ponto selecionado. Para voltar a ver todos os marcadores, clique no botão "Ver Todos".

Posso visualizar a rota que o veículo percorreu entre as paradas?

Esta funcionalidade não está disponível nesta tela, que mostra apenas os pontos de parada. Para visualizar o trajeto completo do veículo, utilize a funcionalidade de histórico de posições ou de rastreamento do sistema.

Como sei se uma parada foi autorizada ou não?

O tipo de parada indica a natureza da parada (programada, solicitação do motorista, etc.). Para determinar se foi autorizada, compare com o planejamento de rota e as políticas da empresa.

Histórico de Roteirizações

Descrição da Interface

O módulo  "Histórico de Roteirizações" é uma ferramenta robusta para gerenciamento e monitoramento de roteirizações de veículos da frota. O layout é dividido em duas seções principais: um painel de controle e filtros à esquerda e um mapa interativo à direita que exibe as rotas geograficamente. Esta visualização dual permite que os usuários vejam tanto os dados tabulares das roteirizações quanto sua representação espacial simultaneamente.

O módulo trabalha com conceitos de viagens, itinerários, e ocorrências, oferecendo ferramentas para acompanhar o progresso das entregas e resolver problemas que possam surgir durante as roteirizações. Há também um modo de dashboard que oferece métricas de desempenho e visualizações gráficas para análise estatística das operações.

Para acessar clique no menu ROTEIRIZAÇÃO opção HISTÓRICO DE ROTEIRIZAÇÕES.

Elementos da Interface

Cabeçalho e Filtros

• Título: "Visualização Roteirização"
• Filtros de Pesquisa:
  • Veículo: Campo de seleção dropdown para filtrar por veículo específico
  • Status: Campo de seleção com opções para filtragem por status (AGENDADA, ABERTA, EM_ANDAMENTO, CANCELADA, FINALIZADA)
  • Período: Dois campos de data (início e fim) com formato DD-MM-YYYY
  • Botão de Busca: Ícone de lupa para executar a pesquisa
  • Botão de Limpar: Ícone para limpar os filtros aplicados

Controles de Visualização

• Checkbox "ATUALIZAR": Habilita atualização automática dos dados a cada 10 segundos
• Checkbox "DASHBOARD": Alterna entre visualização de lista e dashboard com métricas
• Contador de Roteirizações: Mostra o número total de roteirizações listadas

Lista de Roteirizações

• Cabeçalhos de Coluna:
  • VEÍCULO: Exibe o veículo designado para a rota, com ícone e placa
  • INÍCIO: Data e hora de início programada (formato DD/MM/YYYY HH:MM)
  • FIM: Data e hora de fim programada (formato DD/MM/YYYY HH:MM)
  • Status (ícone): Ícone representando o status atual da rota
  • Contadores de Itinerários: Frações mostrando itinerários entregues/total (0/5)
  • Ações: Botões para visualizar itinerários e percurso

Detalhes Expandidos da Roteirização

Ao expandir uma linha, são exibidos:

• Distância: Valor em quilômetros estimado para a rota
• Tempo: Duração estimada da rota
• Peso: Peso total da carga em kg
• Volume: Volume total da carga em m³
• Dados de realização: Se disponíveis, horários reais de início/fim e distância percorrida

Visualização de Dashboard

Quando ativado, exibe:

• Cartões de Métricas:
  • Itinerários: Total de itinerários nas roteirizações
  • Entregues: Número de itinerários entregues com sucesso
  • Renegociadas: Itinerários com entregas renegociadas
  • Pendentes: Itinerários ainda não entregues
  • Sucesso Entregas: Percentual de entregas bem-sucedidas
  • Ocorrências: Número total de problemas registrados
• Gráfico de Barras: Visualização comparativa das métricas acima

Mapa

• Controles de Mapa: Opções para alternar entre visualização de mapa e satélite
• Zoom: Botões de zoom in/out
• Área de Visualização: Exibe rotas e pontos de entrega geograficamente
• Marcadores: Representam pontos de interesse, como locais de entrega
• Linhas de Rota: Caminhos planejados para os veículos
• Tooltip: "Clique para visualizar o percurso dessa roteirização"

Modal de Itinerários

Ao clicar no botão de visualizar itinerários, é exibido:

• Cabeçalho: "Itinerários"
• Tabela de Itinerários com colunas:
  • PEDIDO: Número do pedido/visita
  • VALOR: Valor monetário do pedido
  • STATUS: Status atual do itinerário (Aberto, Entregue, etc.)
  • PREVISÃO: Data e hora previstas para entrega
  • CHECKIN: Data e hora de checkin, se realizado
  • CHECKOUT: Data e hora de checkout, se realizado
  • EXECUTADO: Hora da execução, se realizada
  • ORDEM: Ordem numérica do itinerário na rota
  • Ações: Botão para registrar ocorrências

Modal de Ocorrências

Ao clicar no botão de ocorrências, é exibido:

• Cabeçalho: "Ocorrências"
• Seleção de Tipo de Ocorrência: Campo dropdown com tipos pré-definidos
• Botão de Adicionar: Para registrar nova ocorrência
• Tabela de Ocorrências:
  • Tipo: Categoria da ocorrência
  • Cadastrado: Data e hora do cadastro
  • Tratado: Data e hora do tratamento
  • Status: Status atual (PENDENTE, TRATADO)
• Campo de Tratativa: Área de texto para descrever ações tomadas
• Opções de Status: Rádio buttons para alternar entre PENDENTE e TRATADO
• Botões de Ação: "Pesquisar" e "Gravar"

Propósito e Fluxo de Trabalho

Propósito Principal

O sistema de Visualização de Roteirização serve para monitorar e gerenciar o progresso das entregas e roteiros planejados para a frota de veículos. Permite que gestores e operadores acompanhem em tempo real o andamento das rotas, identifiquem gargalos, e registrem e resolvam ocorrências.

Fluxo de Trabalho Básico

1. Filtrar Roteirizações: O usuário começa selecionando os filtros desejados (veículo, período, status)
2. Visualizar Lista: O sistema exibe as roteirizações que atendem aos critérios
3. Monitorar Progresso: O usuário pode ver o status e métricas de cada roteirização
4. Visualizar Detalhes: Ao clicar em uma roteirização, o usuário pode:
   • Ver o percurso no mapa
   • Examinar a lista de itinerários
   • Consultar detalhes como distâncias e tempos
5. Gerenciar Ocorrências: Registrar e tratar problemas que surgiram durante as entregas
6. Analisar Métricas: Alternar para a visão de dashboard para analisar o desempenho geral

Instruções Passo a Passo

Como Filtrar Roteirizações

1. Na seção superior da tela, localize os filtros
2. Selecione o veículo desejado no campo "Veículo" (opcional)
3. Escolha o status no campo "Status" (opcional)
4. Defina o período de início e fim usando os seletores de data
5. Clique no botão com ícone de lupa para aplicar os filtros
6. Para limpar todos os filtros, clique no botão com ícone de arquivo

Como Visualizar o Percurso de uma Roteirização

1. Na lista de roteirizações, localize a rota de interesse
2. Clique no botão com ícone de navegação (à direita da linha)
3. O mapa será atualizado para mostrar o percurso desta roteirização
4. Os pontos de parada serão exibidos como marcadores numerados
5. A linha do percurso mostrará o caminho planejado
6. Você pode clicar nos marcadores para ver detalhes de cada parada

Como Visualizar Itinerários

1. Na lista de roteirizações, localize a rota de interesse
2. Clique no botão com ícone de lista (à direita da linha)
3. Um modal será aberto com a lista de todos os itinerários da rota
4. Verifique informações como número do pedido, valor, status e horários
5. Para fechar, clique no "X" no canto superior direito do modal

Como Registrar uma Ocorrência

1. Na visualização de itinerários, localize o itinerário específico
2. Clique no botão com ícone de sino para abrir o modal de ocorrências
3. No campo dropdown, selecione o tipo de ocorrência
4. Clique no botão verde com ícone de "+" para adicionar a ocorrência
5. A ocorrência aparecerá na tabela com status "PENDENTE"
6. Para adicionar tratativa, clique na ocorrência para editar
7. Digite a descrição da tratativa no campo de texto
8. Selecione o status apropriado (PENDENTE ou TRATADO)
9. Clique em "Gravar" para salvar as alterações

Como Usar o Dashboard

1. Ative o toggle "DASHBOARD" no topo da tela
2. A visualização mudará para mostrar cartões de métricas e um gráfico
3. Verifique as estatísticas consolidadas como:
   • Total de itinerários
   • Itinerários entregues
   • Itinerários renegociados
   • Itinerários pendentes
   • Percentual de sucesso
   • Total de ocorrências
4. O gráfico de barras mostrará uma comparação visual das métricas
5. Para voltar à visualização de lista, desative o toggle "DASHBOARD"

Como Ativar Atualização Automática

1. Localize o toggle "ATUALIZAR?" no topo da tela
2. Ative-o para iniciar a atualização automática a cada 10 segundos
3. O sistema buscará novos dados regularmente e atualizará a lista
4. Para desativar, desmarque o toggle

Regras de Negócio

Status de Viagem

• AGENDADA: Roteirização programada para uma data futura
• ABERTA: Roteirização pronta para começar, com veículo e motorista designados
• EM_ANDAMENTO: Roteirização iniciada e em execução
• FINALIZADA: Roteirização concluída com todos os itinerários processados
• CANCELADA: Roteirização cancelada antes da conclusão

Status de Itinerário

• Aberta/Visita Aberta: Itinerário ainda não iniciado
• Entregue/Visita Realizada: Entrega concluída com sucesso
• Outros estados: Podem incluir Adiada, Pendente, Devolvido, etc.

Visualização de Percurso

• O sistema consulta o histórico de rastreamento do veículo entre as datas de início e fim da roteirização
• Marcadores são coloridos para indicar estados diferentes:
  • Verde: Veículo em movimento
  • Amarelo: Veículo parado com ignição ligada
  • Vermelho: Veículo com ignição desligada
• As linhas do trajeto são geradas com base nos dados de localização GPS

Ocorrências

• Cada itinerário pode ter múltiplas ocorrências registradas
• Ocorrências podem ter dois estados: PENDENTE ou TRATADO
• Ocorrências pendentes são destacadas com ícones de alerta na interface
• As tratativas são obrigatórias para marcar uma ocorrência como TRATADA

Indicadores de Desempenho

• Percentual de Sucesso: Calculado como (Itinerários Entregues / Total de Itinerários) * 100
• Itinerários Pendentes: Calculado como (Total - Entregues - Renegociados)

Perguntas Frequentes

Gerais

1. Como faço para ver apenas as roteirizações de um veículo específico? Utilize o filtro "Veículo" no topo da tela para selecionar o veículo desejado.

2. O que significa quando o ícone do status está verde? O ícone verde (checkmark) indica que a roteirização foi finalizada com sucesso.

3. Por que o mapa não mostra a rota mesmo após eu selecionar uma roteirização? Pode ser que o veículo não tenha gerado pontos de rastreamento no período da roteirização. Verifique se a roteirização foi realmente iniciada.

4. O que significa "0/5" na listagem de roteirizações? Significa que, de um total de 5 itinerários naquela rota, 0 foram entregues até o momento.

5. Como posso identificar roteirizações com problemas? Roteirizações com ícone de sino (indicando ocorrências pendentes) requerem atenção.

Dashboard

1. Por que minha porcentagem de sucesso está baixa mesmo com poucas ocorrências? A porcentagem de sucesso é baseada nos itinerários efetivamente entregues, não na ausência de ocorrências.

2. O dashboard se atualiza automaticamente? Sim, se você ativar o toggle "ATUALIZAR?", o dashboard também será atualizado a cada 10 segundos.

3. Como posso exportar os dados do dashboard? Atualmente, o sistema não oferece exportação direta. Considere fazer capturas de tela ou solicitar esta funcionalidade.

Itinerários e Ocorrências

1. Posso alterar a ordem dos itinerários depois que a roteirização já começou? Não, a ordem dos itinerários não pode ser alterada depois que uma roteirização está em andamento ou finalizada.

2. Como registro que um cliente se recusou a receber um pedido? Abra o modal de ocorrências para o itinerário específico, selecione o tipo de ocorrência apropriado (ex: "Cliente Ausente"), adicione, forneça detalhes no campo de tratativa e salve.

3. O que acontece com itinerários não entregues ao final da roteirização? Eles permanecem registrados como não entregues e precisam ser reprogramados em uma nova roteirização.

4. É possível transferir um itinerário de uma roteirização para outra? Não diretamente desta interface. Seria necessário cancelar o itinerário na roteirização atual e incluí-lo em uma nova.

5. Como vejo quais ocorrências ainda precisam de tratativa? As ocorrências com status "PENDENTE" na tabela de ocorrências precisam de tratativa.

Técnico

1. O sistema funciona offline? Não, o sistema requer conexão com internet para buscar dados de roteirizações e exibir o mapa.

2. Como sei se a atualização automática está funcionando? Quando ativada, você notará atualizações automáticas nos dados (como contadores e status) sem precisar recarregar manualmente.

3. Posso ter acesso às informações históricas de roteirizações mais antigas? Sim, basta ajustar o período nos filtros de data para abranger o período histórico desejado.

4. Qual a frequência de atualização dos dados de localização no mapa? Os dados são atualizados conforme a frequência de transmissão do rastreador do veículo, geralmente a cada poucos minutos.

5. O sistema funciona em tablets e smartphones? Sim, a interface é responsiva e funciona em dispositivos móveis, embora seja otimizada para desktop.

Monitorar Roteirizações

Descrição da Interface

O módulo "Monitorar de Roteirizações" apresenta uma interface moderna e estruturada para o gerenciamento de roteirizações de entregas ou visitas. A interface foi projetada para proporcionar uma visão abrangente das roteirizações programadas, permitindo o monitoramento em tempo real do status das visitas, sua organização cronológica, e a gestão de ocorrências relacionadas.

A interface apresenta um layout responsivo com uma área superior para filtragem, uma seção central para visualização de rotas em formato de linha do tempo, e uma área inferior que alterna entre um painel de estatísticas (dashboard) ou uma tabela detalhada das roteirizações.

Os elementos visuais utilizam um esquema de cores intuitivo que facilita a compreensão do status das rotas, com indicadores visuais como ícones e cores diferenciadas para representar diferentes estados de entrega.

Para acessar clique no menu ROTEIRIZAÇÃO opção MONITORAR ROTEIRIZAÇÕES.

Elementos da Interface

Tela Principal - Monitoramento de Rotas

Área de Filtros (Superior)

1. Campo Veículo

   • Tipo: Dropdown (v-select)
   • Função: Permite filtrar por veículo específico
   • Valores possíveis: Lista de veículos cadastrados no sistema
   • Dados mostrados: Placa, modelo e identificação opcional (labelVeiculo)

2. Campo Status

   • Tipo: Dropdown (v-select)
   • Função: Filtrar por status da roteirização
   • Valores possíveis: ABERTA, AGENDADA, EM_ANDAMENTO, FINALIZADA, CANCELADA

3. Campos de Data (Período)

   • Tipo: Datepicker (flatPickr)
   • Função: Filtrar por período de datas
   • Formato: DD-MM-YYYY
   • Configuração: Intervalo com data inicial e final

4. Botões de Ação

   • Botão de Pesquisa (ícone de lupa)
   • Botão Limpar Filtros (ícone de arquivo)

Controles de Exibição

1. Toggle "ATUALIZAR?"

   • Tipo: Switch (vs-switch)
   • Função: Ativa/desativa atualização automática dos dados a cada 10 segundos
   • Estados: Ligado/Desligado

2. Toggle "DASHBOARD"

   • Tipo: Switch (vs-switch)
   • Função: Alterna entre visualização de tabela e dashboard estatístico
   • Estados: Ligado/Desligado

3. Contador de Roteirizações

   • Exibe o número total de roteirizações encontradas

Área de Timeline (Linha do Tempo)

• Visualização gráfica das rotas
• Cada linha representa uma rota com:
  • Número sequencial
  • Horário inicial (ex: 12:00)
  • Linha com pontos representando os itinerários
  • Horário final (ex: 14:36)
• Cada ponto na linha representa uma parada/visita
• Numerados de 1 a 5 (ou conforme quantidade de itinerários)

Tabela de Roteirizações

• Colunas:
  1. #: Número sequencial
  2. Status: Ícone representando status (CheckCircle, ArrowRightCircle, MoreHorizontal, Calendar, XCircle)
  3. Placa do Veículo: Identificação do veículo
  4. Qtd. Itinerários: Formato "entregues/total [renegociados]"
  5. ID: Identificador único da roteirização
  6. Início: Data e hora do início previsto
  7. Coluna vazia: Separador
  8. Fim: Data e hora do fim previsto
  9. KM: Distância estimada em quilômetros
  10. Tempo: Tempo estimado para conclusão
  11. Peso: Peso total da carga
  12. Volume: Volume total da carga
  13. Ações: Botões para visualizar itinerários e indicadores de ocorrências

Painéis de Dashboard (Quando ativado)

• Cards Estatísticos:

  1. Itinerários: Total de itinerários programados
  2. Entregues: Total de itinerários entregues
  3. Renegociadas: Total de itinerários renegociados
  4. Pendentes: Total de itinerários pendentes
  5. Percentual de Sucesso: Taxa de entregas realizadas
  6. Ocorrências: Total de ocorrências registradas

• Gráfico de Barras: Visualização gráfica dos dados estatísticos

Popup de Itinerários

Cabeçalho da Tabela

1. #: Ordem planejada
2. VISITA/PEDIDO: Número da visita ou pedido (depende do tipo de roteirização)
3. VALOR: Valor do pedido (apenas para roteirização de pedidos)
4. STATUS: Estado atual do itinerário
5. PREVISÃO: Data e hora prevista para a visita
6. CHECKIN: Data e hora do checkin
7. CHECKOUT: Data e hora do checkout
8. EXECUTADO: Horário de execução
9. CODIGO: Código do ponto de interesse
10. NOME: Nome do ponto de interesse
11. ORDEM: Ordem de execução
12. Ações: Botão para registrar ocorrências

Dados dos Itinerários

• Lista de itinerários com todos os dados relacionados
• Botão para registrar ocorrências para cada itinerário

Popup de Ocorrências

Área de Cadastro

1. Dropdown Tipo de Ocorrência

   • Tipo: Dropdown (v-select)
   • Função: Selecionar o tipo de ocorrência
   • Valores: Lista de tipos de ocorrências cadastradas

2. Botão Adicionar

   • Tipo: Botão (vs-button)
   • Função: Adicionar nova ocorrência

Tabela de Ocorrências

• Colunas:
  1. Tipo: Tipo da ocorrência
  2. Cadastrado: Data e hora de cadastro
  3. Tratado: Data e hora de tratamento
  4. Status: Status da ocorrência (PENDENTE/TRATADO)

Botões de Ação

1. Pesquisar: Atualiza a lista de ocorrências
2. Gravar: Salva as alterações nas ocorrências

Propósito e Fluxo de Trabalho

O Sistema de Monitoramento de Rotas foi desenvolvido para gerenciar e acompanhar roteirizações de entregas ou visitas técnicas. Ele permite visualizar o progresso das rotas, identificar problemas e gerir ocorrências de forma eficiente.

Fluxo de Trabalho Principal:

1. Filtrar Roteirizações:

   • O usuário seleciona os critérios de filtro (veículo, status, período)
   • Sistema exibe as roteirizações que correspondem aos critérios

2. Monitorar Progresso:

   • A visualização de timeline permite acompanhar o progresso das rotas
   • A tabela ou dashboard apresenta informações detalhadas sobre cada roteirização

3. Gerenciar Itinerários:

   • Ao selecionar uma roteirização, o usuário pode visualizar seus itinerários
   • Os detalhes de cada parada são exibidos, incluindo checkins e checkouts

4. Registrar e Gerenciar Ocorrências:

   • Para itinerários com problemas, o usuário pode registrar ocorrências
   • As ocorrências podem ser tratadas e ter seu status atualizado

5. Análise de Desempenho:

   • O dashboard apresenta métricas de desempenho como taxa de sucesso de entregas
   • Os gráficos facilitam a visualização de indicadores chave

Regras de Negócio Importantes:

1. Auto-atualização: Quando ativada, a tela é atualizada a cada 10 segundos para refletir o status atual das roteirizações.

2. Estados da Roteirização: Uma roteirização pode passar pelos estados:

   • AGENDADA: Programada mas ainda não iniciada
   • ABERTA: Disponível para início
   • EM_ANDAMENTO: Em execução
   • FINALIZADA: Concluída
   • CANCELADA: Cancelada sem conclusão

3. Status dos Itinerários: Os itinerários podem ter diferentes status, como:

   • Visita Aberta
   • Visita Adiada
   • Visita Pendente
   • Visita Realizada
   • Entregue
   • Devolvido
   • Endereço Fechado
   • Endereço Errado
   • Endereço Não Localizado

4. Gestão de Ocorrências: Ocorrências podem ser cadastradas, consultadas e tratadas, mantendo registro de quem e quando foram tratadas.

5. Restrições de Edição: Não é possível modificar roteirizações finalizadas ou canceladas.

Instruções Passo a Passo

Como Filtrar Roteirizações

1. Acesse a tela de Monitoramento de Rotas
2. Selecione um veículo no campo "Veículo" (opcional)
3. Selecione um status no campo "Status" (opcional)
4. Defina um período nas datas de início e fim
5. Clique no botão de pesquisa (ícone de lupa)
6. O sistema exibirá as roteirizações que correspondem aos critérios

Como Ativar a Atualização Automática

1. Localize o switch "ATUALIZAR?" na parte superior da tela
2. Clique no switch para ativá-lo
3. A tela será atualizada automaticamente a cada 10 segundos
4. Para desativar, clique novamente no switch

Como Visualizar Itinerários de uma Roteirização

1. Nas linhas da tabela de roteirizações, localize a roteirização desejada
2. Clique no botão de lista (ícone) na coluna de ações
3. O popup de itinerários será exibido com a lista de todas as paradas
4. Verifique os detalhes de cada itinerário na tabela

Como Registrar uma Ocorrência

1. No popup de itinerários, localize o itinerário que necessita de registro de ocorrência
2. Clique no botão de sino (ícone) na linha do itinerário
3. No popup de ocorrências, selecione o tipo de ocorrência no dropdown
4. Clique no botão de adicionar (ícone +)
5. A ocorrência será adicionada à tabela
6. Se necessário, edite o status da ocorrência entre "PENDENTE" e "TRATADO"
7. Clique no botão "Gravar" para salvar as alterações

Como Alternar entre Visualização de Tabela e Dashboard

1. Localize o switch "DASHBOARD" na parte superior da tela
2. Clique no switch para ativar a visualização de dashboard
3. A tela exibirá cards estatísticos e gráficos em vez da tabela detalhada
4. Para voltar à visualização de tabela, clique novamente no switch

Perguntas Frequentes

1. Como identifico roteirizações com problemas?

Roteirizações com ocorrências pendentes são indicadas por um ícone de sino na coluna de ações. Você também pode filtrar por status para localizar roteirizações que não foram finalizadas conforme o cronograma.

2. O que significa a exibição "3/5 [1]" na coluna de itinerários?

Esta notação indica que, de um total de 5 itinerários, 3 foram entregues/realizados com sucesso e 1 foi renegociado. Os demais estão pendentes.

3. É possível alterar um itinerário de uma roteirização já iniciada?

Sim, é possível alterar itinerários de roteirizações que estejam nos status "ABERTA" ou "EM_ANDAMENTO". Roteirizações "FINALIZADAS" ou "CANCELADAS" não podem ser alteradas.

4. Como funciona a atualização automática?

Quando ativada, a tela faz uma consulta ao servidor a cada 10 segundos para atualizar os dados exibidos. Isso permite acompanhar o progresso das roteirizações em tempo real sem precisar atualizar a página manualmente.

5. Por que algumas roteirizações aparecem com peso e volume zerados?

Roteirizações sem registros de peso e volume podem estar em fase de planejamento ou podem representar roteirizações de visitas técnicas, onde não há transporte de mercadorias.

6. Como tratar uma ocorrência registrada?

Acesse o popup de ocorrências do itinerário, altere o status da ocorrência para "TRATADO" e, se necessário, adicione informações na área de tratativa. Em seguida, clique em "Gravar" para salvar as alterações.

7. É possível excluir uma roteirização?

Roteirizações podem ser excluídas apenas se não tiverem sido sincronizadas com dispositivos móveis. Para excluir, é necessário primeiro apagar a sincronização através do módulo de ROTAS.

8. Como interpretar a visualização de timeline?

Cada linha horizontal representa uma roteirização, com o horário inicial à esquerda e o final à direita. Os pontos numerados ao longo da linha representam os itinerários (paradas) planejados, na ordem em que devem ser executados.

Informações Técnicas Adicionais

O sistema implementa uma estrutura de dados robusta que gerencia diferentes tipos de roteirizações: entregas de produtos (pedidos) e visitas técnicas. As roteirizações são armazenadas com todos os metadados necessários, incluindo coordenadas geográficas, tempos estimados, e dados de carga.

O sistema realiza várias validações importantes:

• Checagem de dados temporais: não permite registrar um fim de rota anterior ao início
• Validação de sequência de status: respeita a sequência de estados da roteirização (AGENDADA → ABERTA → EM_ANDAMENTO → FINALIZADA)
• Verificação de permissões de alteração: impede modificações em roteirizações já finalizadas ou canceladas

Os campos de valor monetário, peso e volume são formatados com a função formatarNumero() que aplica as configurações regionais de exibição para facilitar a leitura dos valores.

Roteirizações

Introdução

O módulo "Roteirizações" e itinerários é uma solução completa para planejamento, monitoramento e execução de rotas de entrega. Esta ferramenta permite às empresas otimizar os trajetos, controlar entregas, gerenciar veículos e motoristas, além de manter registros detalhados de todas as operações.

Neste módulo é possível:

1. Consultar todas as roteirizações criadas
2. Excluir um roteirização
3. Imprimir o Romaneio de Entrega.
4. Imprimir o Espelho da Rota
5. Ajustar o valor de devolução
6. Reordenar os itinerários.
7. Retirar um itinerário da roteirização.
8. Alterar os dados de um itinerário da roteirização.
9. Abrir uma roteirização "Agendada".
10. Iniciar um aroteirização "Aberta".
11. Finalizar uma roteirização "Em Andamento".
12. Reabrir um roteirização "Finalizada"

Para acessar clique no menu ROTEIRIZAÇÃO opção ROTEIRIZAÇÕES.

Interface Principal do Sistema

O sistema possui diferentes telas integradas que trabalham em conjunto para gerenciar todo o processo de roteirização. Cada tela tem funções específicas que contribuem para o fluxo completo de trabalho.

1. Tela de Roteirizações

Descrição

Esta tela apresenta uma visão geral de todas as roteirizações criadas no sistema. Os usuários podem visualizar, filtrar e acessar detalhes de roteirizações específicas.

Elementos da Interface

• Cabeçalho: Exibe o título "Roteirizações" e opções de navegação globais
• Painel de Filtros: Seção colapsável com múltiplas opções de filtragem
• Tabela de Dados: Exibe as roteirizações em formato tabular com paginação

Campos e Controles

Campo	Tipo	Descrição	Valores Possíveis	Validações
Veículo	Dropdown	Seleção do veículo para filtragem	Lista de veículos ativos	Opcional
Pedido	Texto	Número do pedido para filtrar	Valor numérico	Opcional
Carregamento	Texto	Número de carregamento para filtrar	Valor alfanumérico	Opcional
Tipo Roteirização	Dropdown	Tipo de roteirização	"PEDIDOS", "VISITAS"	Valor padrão: "PEDIDOS"
Período (Data Início)	Data	Data inicial para filtrar	Data válida no formato DD-MM-YYYY	Obrigatório se nenhum outro filtro for informado
Período (Data Fim)	Data	Data final para filtrar	Data válida no formato DD-MM-YYYY	Obrigatório se nenhum outro filtro for informado
Status	Dropdown	Status da roteirização	"AGENDADA", "ABERTA", "EM_ANDAMENTO", "CANCELADA", "FINALIZADA"	Opcional
Identificador	Texto	ID da roteirização	Valor numérico	Opcional, validação numérica

Botões de Ação

• Pesquisar: Executa a pesquisa com os filtros aplicados
• Limpar Filtros: Restaura os valores padrão dos filtros
• Novo: Redireciona para a tela de criação de nova roteirização
• Exportar para CSV: Exporta os dados da tabela para um arquivo CSV
• Arquivar Roteirizações: Recupera roteirizações anteriores

Tabela de Resultados

A tabela exibe as seguintes colunas:

• Identificador
• Status
• Veículo
• Motorista
• Peso
• Valor
• Data
• Início
• Itinerários
• Erros
• Local Saída
• Local Retorno
• D/H Retorno

Fluxo de Trabalho

1. O usuário seleciona os filtros desejados
2. Clica em "Pesquisar" para obter os resultados
3. Visualiza os dados na tabela com paginação
4. Pode selecionar uma roteirização na tabela para visualizar seus detalhes

2. Tela de Edição de Roteirização

Descrição

Esta tela permite visualizar e editar os detalhes de uma roteirização específica, incluindo informações do veículo, motorista, datas planejadas e itinerários associados.

Elementos da Interface

• Cabeçalho: Exibe o título "Roteirização" e o ID
• Painel de Status: Mostra o status atual e avisos relacionados
• Painel de Informações do Veículo: Seção para dados do veículo e motorista
• Painel de Datas: Seção para datas planejadas e realizadas
• Painel de Detalhes: Informações adicionais como pontos de saída e retorno
• Tabela de Itinerários: Lista de itinerários associados a esta roteirização

Campos e Controles

Campo	Tipo	Descrição	Valores Possíveis	Validações
Veículo	Dropdown	Seleção do veículo	Lista de veículos ativos	Obrigatório
Motorista	Dropdown	Seleção do motorista	Lista de motoristas ativos	Obrigatório
Data Início (Planejado)	Data/Hora	Data e hora planejadas para início	Data/hora válida	Obrigatório
Data Fim (Planejado)	Data/Hora	Data e hora planejadas para fim	Data/hora válida	Obrigatório, deve ser posterior à data de início
Data Início (Realizado)	Texto (somente leitura)	Data e hora efetivas de início	-	Não editável
Data Fim (Realizado)	Texto (somente leitura)	Data e hora efetivas de fim	-	Não editável

Painéis Informativos

• Ponto de Saída: Nome do local de partida (somente leitura)
• Ponto de Retorno: Nome do local de retorno (somente leitura)
• Status: Status atual da roteirização (somente leitura)
• Valor Devolvido: Valor monetário devolvido (somente leitura)
• Distância Prevista: Quilometragem estimada (somente leitura)
• Tempo Estimado: Tempo estimado para a rota (somente leitura)
• Valor Transportado: Valor total da carga (somente leitura)
• Peso: Peso total da carga (somente leitura)
• Volume: Volume total da carga (somente leitura)
• Quantidade de Itinerários: Número de itinerários na rota (somente leitura)

Botões de Ação

• Gravar: Salva as alterações
• Excluir: Remove a roteirização (visível apenas quando permitido)
• Voltar: Retorna à tela de listagem
• Atualizar Atak: Envia dados para sistema externo (visível apenas para usuários específicos)
• Botão de Ação de Status: Muda o status da roteirização (ícone e função variam conforme o status atual)
• Auto ON/OFF: Ativa/desativa fechamento automático de itinerários
• Abertura Automática ON/OFF: Ativa/desativa abertura automática na data de início (visível quando status é "AGENDADA")
• Imprimir Romaneio: Gera relatório de romaneio
• Imprimir Espelho da Rota: Gera relatório de espelho da rota
• Ajustar Valor da Devolução: Permite ajustar o valor devolvido (visível quando status é "FINALIZADA")

Tabela de Itinerários

A tabela exibe as seguintes colunas:

• Botões de ação (Remover, Editar)
• Número sequencial
• Indicador de ocorrências
• Número do pedido/código
• Data do itinerário
• Data do pedido
• Valor
• Peso
• Volume
• Status
• Indicador de assinatura
• Loja
• Zona
• Vendedor
• Ordem de entrega

Fluxo de Trabalho

1. O usuário pode editar o veículo e motorista (quando permitido)
2. Pode ajustar as datas planejadas
3. Pode adicionar, remover ou reordenar itinerários
4. Pode alterar o status da roteirização através do botão de ação de status
5. Pode imprimir relatórios ou ajustar configurações específicas
6. Salva as alterações ou retorna à tela de listagem

3. Tela de Edição de Itinerário

Descrição

Esta tela permite visualizar, criar ou editar detalhes de um itinerário específico associado a uma roteirização. Inclui informações como cliente, endereço, status, valores e restrições.

Elementos da Interface

• Cabeçalho: Exibe o título "Itinerario da Roteirização"
• Painel de Informações Básicas: Campos para dados gerais do itinerário
• Painel de Localização: Campos relacionados ao endereço e cliente
• Painel de Restrições: Campos para definir limitações de horários
• Mapa: Visualização geográfica da localização do itinerário
• Popups Modais: Janelas para funções específicas (fotos, ocorrências, assinatura)

Campos e Controles

Campo	Tipo	Descrição	Valores Possíveis	Validações
Número do Pedido	Texto	Identificador do pedido	Valor alfanumérico	Obrigatório
Data do Pedido	Data/Hora	Data e hora do pedido	Data/hora válida	Obrigatório
Data do Itinerário	Data/Hora	Data e hora do itinerário	Data/hora válida	Obrigatório
Nota Fiscal	Texto	Número da nota fiscal	Valor alfanumérico	Opcional
Carregamento	Texto	Número do carregamento	Valor alfanumérico	Opcional
Veículo	Dropdown	Seleção do veículo	Lista de veículos ativos	Obrigatório
Motorista	Texto	Nome do motorista	-	Obrigatório
Status	Dropdown	Status do itinerário	Lista de status disponíveis	Obrigatório
Data Entrega	Data/Hora	Data e hora da entrega	Data/hora válida	Obrigatório quando status é "ENTREGUE"
Quantidade	Numérico	Quantidade de itens	Valor numérico positivo	Obrigatório
Valor	Numérico	Valor monetário	Valor numérico positivo	Obrigatório
Peso	Numérico	Peso em kg	Valor numérico positivo	Obrigatório
Volume	Numérico	Volume em unidades cúbicas	Valor numérico positivo	Obrigatório
Descrição	Texto	Descrição do itinerário	Texto livre	Obrigatório
Cliente	Dropdown	Seleção do cliente/ponto de interesse	Lista de clientes/POIs	Obrigatório
Endereço	Texto	Endereço de entrega	Texto livre	Obrigatório
Vendedor	Dropdown	Seleção do vendedor	Lista de vendedores	Obrigatório
Loja	Dropdown	Seleção da loja	Lista de lojas	Obrigatório
Zona	Dropdown	Seleção da zona	Lista de zonas	Obrigatório
Hora Início	Hora	Horário inicial para atendimento	Hora válida (00:00-23:59)	Obrigatório
Hora Fim	Hora	Horário final para atendimento	Hora válida (00:00-23:59)	Obrigatório, deve ser posterior à hora início
Tempo p/ atender	Numérico	Tempo em minutos	Valor numérico positivo	Obrigatório
Observação	Texto	Observações adicionais	Texto livre	Opcional

Botões de Ação

• Gravar: Salva as alterações
• Excluir: Remove o itinerário (visível apenas quando permitido)
• Voltar: Retorna à tela anterior
• Ocorrências: Abre popup para gestão de ocorrências
• Fotos: Abre popup para gestão de fotos
• Localizar Endereço: Busca o endereço no mapa
• Ver Assinatura: Visualiza a assinatura (visível quando o itinerário está assinado)
• Atualizar Lat/Lon: Atualiza coordenadas geográficas

Popups Modais

Popup de Fotos

• Título: "Fotos (X)" onde X é a quantidade de fotos
• Lista de fotos com data/hora de cadastro
• Opções para visualizar, baixar, rotacionar e excluir fotos
• Área para upload de novas fotos

Popup de Ocorrências

• Título: "Ocorrências"
• Dropdown para seleção do tipo de ocorrência
• Botão para adicionar nova ocorrência
• Tabela com colunas: Tipo, Cadastrado, Tratado, Status
• Campos editáveis: Tratativa (textarea) e Status (radio buttons)

Popup de Veículos Próximos

• Campo de busca de endereço
• Tabela com endereços encontrados
• Visualização no mapa de veículos próximos ao endereço selecionado

Fluxo de Trabalho

1. O usuário preenche os dados básicos do itinerário
2. Seleciona cliente e confirma/ajusta o endereço
3. Define restrições de horário e tempo de atendimento
4. Pode adicionar fotos, registrar ocorrências ou verificar a assinatura
5. Confirma a localização no mapa
6. Salva as alterações ou retorna à tela anterior

4. Popup de Seleção de Itinerários

Descrição

Este popup permite selecionar múltiplos itinerários para alterar seu status em lote.

Elementos da Interface

• Cabeçalho: Exibe o título "Registros selecionados"
• Painel de Seleção de Status: Para escolher o novo status
• Painel de Data: Para definir data/hora de entrega (quando aplicável)
• Tabela de Itinerários: Lista dos itinerários selecionados

Campos e Controles

Campo	Tipo	Descrição	Valores Possíveis	Validações
Novo Status	Dropdown	Status a ser aplicado	Lista de status disponíveis	Obrigatório
Data e Hora da Entrega	Data/Hora	Data e hora de entrega	Data/hora válida	Obrigatório quando novo status é "ENTREGUE"

Botões de Ação

• Alterar Status: Aplica o novo status aos itinerários selecionados
• Limpar Lista: Remove todos os itinerários da seleção

Tabela de Itinerários Selecionados

A tabela exibe as seguintes colunas:

• Pedido/Visita
• Data
• Vendedor
• Botão de remoção individual

Fluxo de Trabalho

1. O usuário seleciona itinerários na tela principal
2. Abre o popup de seleção
3. Escolhe o novo status
4. Se o status for "ENTREGUE", informa a data e hora
5. Confirma a alteração em lote

5. Popup de Roteirizações Anteriores

Descrição

Este popup permite recuperar roteirizações anteriores para visualização ou edição.

Elementos da Interface

• Cabeçalho: Exibe o título "Rotas"
• Mensagem Explicativa: Instruções para o usuário
• Campos de Filtragem: Para localizar roteirizações específicas
• Lista de Roteirizações: Resultados da pesquisa

Campos e Controles

Varia conforme implementação específica do componente PopUpRotas

Botões de Ação

• OK: Seleciona a roteirização e fecha o popup
• Fechar: Cancela a operação e fecha o popup

Fluxo de Trabalho

1. O usuário abre o popup a partir da tela principal
2. Utiliza os filtros para localizar roteirizações anteriores
3. Seleciona uma roteirização específica
4. Confirma a seleção para carregar os dados na tela principal

6. Relatórios do Sistema

Espelho da Rota

Este relatório apresenta informações detalhadas sobre a roteirização:

• Cabeçalho com dados do veículo, motorista e datas
• Dados gerais como peso, volume, tempo estimado
• Lista de todos os pedidos/visitas com horários e valores
• Mapa da rota com trajeto destacado
• Espaço para assinaturas

Romaneio de Entrega

Este relatório apresenta um formato mais compacto para uso operacional:

• Identificação do veículo e motorista
• Detalhes de quantidade, peso e volume
• Lista sequencial de itinerários com horários de chegada estimados
• Lista de clientes com códigos de identificação

Instruções Passo a Passo

Como Filtrar Roteirizações

1. Acesse a tela de "Roteirizações"
2. Expanda o painel de filtros (se estiver recolhido)
3. Preencha pelo menos um dos seguintes critérios:
   • Período (datas de início e fim)
   • Número de pedido
   • Número de carregamento
   • Identificador da roteirização
4. Opcionalmente, selecione:
   • Veículo específico
   • Status da roteirização
   • Tipo de roteirização (Pedidos ou Visitas)
5. Clique no botão "Pesquisar" (ícone de lupa)
6. Os resultados serão exibidos na tabela abaixo

Como Criar uma Nova Roteirização

1. Acesse a tela de "Roteirizações"
2. Clique no botão "Novo" (ícone de +)
3. Na tela de edição, selecione:
   • Veículo
   • Motorista
4. Defina as datas planejadas:
   • Data e hora de início
   • Data e hora de fim
5. Clique em "Gravar" para salvar a roteirização vazia
6. Para adicionar itinerários, clique no botão "+" na seção de itinerários
7. Complete os detalhes do novo itinerário na tela de edição de itinerário
8. Repita o processo para adicionar mais itinerários

Como Reordenar Itinerários

1. Acesse a tela de edição de roteirização
2. Na tabela de itinerários, clique e segure o número do pedido/código
3. Arraste para a posição desejada na sequência
4. Solte o botão do mouse para posicionar
5. Repita o processo para outros itinerários conforme necessário
6. Clique no botão "GRAVAR" para salvar a nova ordenação

Como Alterar o Status de uma Roteirização

1. Acesse a tela de edição de roteirização
2. Identifique o botão de ação de status (à esquerda, formato varia conforme o status atual)
3. Clique no botão para iniciar a mudança de status
4. Para status "INICIAR" ou "FINALIZAR":
   • Uma janela popup será exibida
   • Informe a data e hora correspondente
   • Clique em "Gravar"
5. Para outros status (ABRIR, REABRIR):
   • A alteração será aplicada imediatamente
6. O sistema atualizará o status e exibirá mensagem de confirmação

Como Gerar Relatórios

1. Acesse a tela de edição de roteirização
2. No painel direito, localize os botões de relatório
3. Para o Romaneio:
   • Clique no primeiro ícone de impressora
   • O arquivo PDF será gerado e aberto para download
4. Para o Espelho da Rota:
   • Clique no segundo ícone de impressora
   • Uma janela popup exibirá o relatório
   • Utilize os botões para exportar nos formatos desejados (PDF, XLS, TXT, RTF)

Como Registrar Ocorrências em um Itinerário

1. Acesse a tela de edição de itinerário
2. Clique no botão "Ocorrências"
3. No popup exibido:
   • Selecione o tipo de ocorrência no dropdown
   • Clique no botão "+" para adicionar
4. Para atualizar uma ocorrência existente:
   • Clique na linha da ocorrência para editar
   • Preencha a descrição da tratativa
   • Selecione o novo status (Pendente ou Tratado)
5. Clique em "Gravar" para salvar as alterações
6. Feche o popup para retornar à tela do itinerário

Regras de Negócio

Validações Gerais

1. Integridade de Datas:

   • A data de fim deve ser sempre posterior à data de início
   • A data de entrega de um itinerário não pode ser anterior à data de início da rota
   • Horários de atendimento devem ser consistentes (hora fim posterior à hora início)

2. Restrições de Alteração:

   • Veículos não podem ser alterados em rotas com status "EM_ANDAMENTO" ou "FINALIZADA"
   • Motoristas não podem ser alterados em rotas com status "FINALIZADA"
   • Itinerários não podem ser excluídos de rotas com status "CANCELADA" ou "FINALIZADA"

3. Controle de Status:

   • A transição de status segue uma sequência específica: AGENDADA → ABERTA → EM_ANDAMENTO → FINALIZADA
   • Uma rota FINALIZADA pode ser reaberta, retornando ao status EM_ANDAMENTO
   • Uma rota só pode ser iniciada (status EM_ANDAMENTO) se estiver com status ABERTA ou AGENDADA

4. Validações de Sincronização:

   • Rotas sincronizadas com dispositivos móveis não podem ser excluídas diretamente
   • É necessário remover a sincronização antes da exclusão

5. Pesquisas e Filtros:

   • Ao menos um filtro é obrigatório (período, número de pedido, carregamento ou identificador)
   • Se apenas número de pedido for informado, o período (datas início e fim) torna-se obrigatório

Validações Específicas

1. Validação de Horários:

   • Ao registrar início ou fim real de uma rota, a data/hora não pode ser posterior à data/hora atual
   • A diferença máxima permitida é de 2 minutos para futuro (tolerância para ajustes de relógio)

2. Mistura de Tipos:

   • Não é permitido adicionar itinerários do tipo "Pedido" e "Visita" na mesma seleção em lote
   • O sistema verifica a compatibilidade antes de permitir a adição

3. Roteirizações do Roteirizador:

   • Rotas criadas automaticamente pelo roteirizador exibem um alerta específico
   • Campos de data planejada ficam desabilitados para edição nestes casos

Perguntas Frequentes

Roteirizações

1. Como posso encontrar uma roteirização específica? Utilize os filtros disponíveis na tela principal. Você pode pesquisar por identificador, período de datas, veículo, status ou pelo número de um pedido específico.

2. Por que não consigo alterar o veículo de uma roteirização em andamento? O sistema não permite alterar o veículo de roteirizações com status "EM_ANDAMENTO" ou "FINALIZADA" para manter a integridade dos dados. Se necessário, você deve reabrir a roteirização primeiro.

3. O que significa o aviso sobre "rota criada pelo roteirizador"? Este aviso indica que a rota foi gerada automaticamente pelo módulo de roteirização. Algumas funcionalidades de edição são limitadas para evitar inconsistências com o planejamento original.

4. Como funciona a abertura automática de roteirizações? Quando ativada, a funcionalidade fará com que a roteirização mude automaticamente para o status "ABERTA" na data de início programada, sem necessidade de intervenção manual.

5. É possível exportar os dados das roteirizações? Sim, você pode exportar os dados para formato CSV utilizando o botão específico na tela de listagem de roteirizações.

Itinerários

1. Como reordenar os itinerários de uma roteirização? Clique e arraste o número do pedido/código na tabela de itinerários para a posição desejada. Após reorganizar, clique no botão "GRAVAR" para salvar a nova ordenação.

2. Por que aparece um asterisco vermelho em alguns itinerários? O asterisco indica que existem ocorrências pendentes associadas a este itinerário. Você pode verificar os detalhes clicando no botão "Ocorrências".

3. Como registro que um item foi entregue? Você pode alterar o status do itinerário para "ENTREGUE" individualmente na tela de edição do itinerário, ou selecionar múltiplos itinerários e usar a função de alteração em lote.

4. Como localizo um endereço no mapa? Na tela de edição de itinerário, preencha o campo de endereço e clique no botão de busca (lupa). O sistema tentará localizar o endereço e posicionará o marcador no mapa.

5. Posso adicionar fotos aos itinerários? Sim, clique no botão "Fotos" na tela do itinerário para abrir o gerenciador de fotos, onde você pode visualizar fotos existentes ou anexar novas.

Relatórios

1. Qual a diferença entre o Romaneio e o Espelho da Rota? O Romaneio é um relatório mais simples e compacto, ideal para uso operacional. O Espelho da Rota apresenta informações mais detalhadas, incluindo mapa do trajeto e campos para assinaturas.

2. Em quais formatos posso exportar o Espelho da Rota? O Espelho da Rota pode ser exportado nos formatos PDF, XLS, TXT e RTF, conforme sua necessidade.

3. Os relatórios mostram as ocorrências registradas? Não, os relatórios padrão não incluem as ocorrências. Para consultar ocorrências, é necessário acessar a tela do itinerário específico e verificar o registro de ocorrências.

Funcionalidades Especiais

1. O que é a funcionalidade "Atualizar Atak"? Esta função envia os dados da roteirização para um sistema externo chamado Atak. Está disponível apenas para usuários específicos.

2. Como funciona o fechamento automático de itinerários? Quando ativado (botão "Auto ON"), o sistema fechará automaticamente os itinerários conforme os status são atualizados, sem necessidade de confirmação manual.

3. Como registro o valor devolvido de uma roteirização? Para roteirizações com status "FINALIZADA", utilize o botão específico no painel direito da tela de edição de roteirização. Um popup será exibido para informar o valor.

Alterações, correções e melhorias disponibilizadas na versão 250319.0

• Inclusão da opção de desconsiderar a data do itinerário no fechamento automático de itinerários. Para habilitar o fechamento automático do itinerário deve estar marcado e você deve clicar em  Desconsiderar Data OFF. O botão só fica visivel quando clicar no botão 'Fechamento Automático OFF' ou se o botão já estiver 'Fechamento Automático ON' . Clique nesse botão para que o status automático possa ser feito sem considerar a data do itinerário.

Roteirizador de Pedidos

Introdução

O módulo de "Roteirização" é uma plataforma completa para gerenciamento e otimização de rotas de entrega. O módulo permite selecionar pedidos, configurar parâmetros de roteirização, visualizar resultados em um mapa interativo e gerenciar os veículos da frota. A interface combina elementos visuais como mapas, tabelas de dados e painéis de configuração para criar um fluxo de trabalho eficiente para planejamento logístico.

Para acessar clique no menu ROTEIRIZAÇÃO opção ROTEIRIZADOR.

Visão Geral da Interface

A interface do sistema é dividida em três etapas principais, representadas por números sequenciais (1, 2, 3) na parte superior da tela. O fluxo de trabalho progride da seleção de pedidos (etapa 1), para a parametrização da rota (etapa 2), até o resultado da roteirização (etapa 3).

Cada etapa contém elementos específicos que guiam o usuário através do processo de criação e otimização de rotas.

Funcionalidades Principais

Etapa 1: Seleção de Pedidos

Esta etapa permite ao usuário filtrar e selecionar os pedidos que deseja incluir na roteirização.

Elementos da Interface:

• Cabeçalho: Mostra "Roteirizador" e "Seleção de Pedidos" com um indicador visual de etapa (1)

• Filtros de busca:

  • Vendedor: Campo de seleção tipo dropdown para filtrar por vendedor
  • Loja: Campo de seleção tipo dropdown para filtrar por loja
  • Zona: Campo de seleção tipo dropdown para filtrar por zona geográfica
  • Status: Campo de seleção tipo dropdown para filtrar por status do pedido
  • Pedido: Campo de texto para buscar por número específico de pedido
  • Nota Fiscal: Campo de texto para buscar por número de nota fiscal
  • Carregamento: Campo de texto para filtrar por número de carregamento
  • Lote: Campo de texto para filtrar por número de lote
  • Data: Seletor de intervalo de datas (De-Até) com tipo de data configurável
  • Checkboxes:
    • Adicionar automaticamente: Quando marcado, adiciona automaticamente o pedido à lista quando buscado pelo número
    • Separados: Filtrar apenas pedidos já separados para envio
    • Liberados roteirizar: Filtrar apenas pedidos liberados para roteirização
    • Não roteirizados: Filtrar pedidos que ainda não foram roteirizados

• Botões de ação:

  • Botão de busca: Executa a pesquisa com os filtros selecionados
  • Botão limpar: Limpa todos os filtros aplicados
  • Botão recuperar roteirizações: Permite recuperar roteirizações anteriores
  • Botão adicionar todos: Adiciona todos os pedidos listados à roteirização

• Tabela de resultados: Exibe os pedidos que correspondem aos critérios de filtro com colunas:

  • PEDIDO: Número identificador do pedido
  • DATA: Data de criação ou agendamento do pedido
  • LOJA: Nome da loja/estabelecimento
  • VENDEDOR: Nome do vendedor responsável
  • ZONA: Região de entrega
  • CARREGAMENTO/LOTE: Números de carregamento e lote
  • PESO: Peso do pedido em unidades relevantes
  • VOLUME: Volume ocupado pelo pedido
  • Botão "+": Para adicionar o pedido específico à roteirização

• Mapa: Visualização geográfica dos pedidos filtrados, com marcadores nos endereços

• Contador de pedidos: Mostra o número de pedidos selecionados

• Botão Próxima Etapa: Avança para a etapa 2 de parametrização

Validações:

• Número de pedido deve ser válido no sistema
• Ao menos um filtro deve ser preenchido para realizar a busca
• Datas devem estar em formato válido
• Pelo menos um pedido deve ser selecionado para avançar à próxima etapa

Etapa 2: Parametrização

Esta etapa permite definir os parâmetros para a roteirização dos pedidos selecionados na etapa anterior.

Elementos da Interface:

• Cabeçalho: Mostra "Roteirizador" e "Parametrização" com indicador visual de etapa (2)

• Configurações de rota:

  • Local de saída: Campo de seleção dropdown para definir o ponto inicial da rota
    • Checkbox "Saída Veículo": Quando marcado, considera o ponto de partida do veículo
  • Local de retorno: Campo de seleção dropdown para definir o ponto final da rota
    • Checkbox "Retorno Veículo": Quando marcado, considera o ponto de retorno ao veículo
  • Data da Rota: Campo de data e hora para agendamento da rota
  • Jornada de trabalho:
    • Jornada Início: Campo de hora para início do período de trabalho (padrão: 08:00)
    • Intervalo Início: Campo de hora para início do intervalo (padrão: 12:00)
    • Intervalo Fim: Campo de hora para fim do intervalo (padrão: 14:00)
    • Jornada Fim: Campo de hora para fim do período de trabalho (padrão: 18:00)

• Tabela de pedidos selecionados: Lista todos os pedidos escolhidos na etapa 1, com checkboxes para confirmar inclusão

• Seleção de veículos:

  • Categoria: Campo de seleção para filtrar por categoria de veículo
  • Divisão: Campo de seleção para filtrar por divisão da empresa
  • Veículos: Campo de seleção múltipla para escolher veículos disponíveis
  • Lista de veículos selecionados: Mostra os veículos escolhidos para a roteirização
    • Cada item exibe: número sequencial, placa, divisão, capacidade de peso e volume

• Restrições: Botão que abre um popup com opções de restrições para a roteirização:

  • Peso: Considera limitações de peso dos veículos
  • Volume: Considera limitações de volume dos veículos
  • Zona: Respeita limitações de zonas de entrega
  • Janela de Atendimento: Respeita horários específicos de entrega
  • Qtd Max Itens: Limita quantidade máxima de itens por veículo
  • Evitar Estrada de Terra: Evita rotas por estradas não pavimentadas
  • Agrupar Zona: Agrupa entregas por zonas geográficas
  • Agrupar Vendedor: Agrupa entregas por vendedor

• Botões de navegação:

  • Voltar: Retorna para a etapa 1
  • Roteirizar: Processa a roteirização com os parâmetros definidos

• Mapa: Mostra a localização dos pedidos selecionados

Validações:

• Data da rota deve ser válida e futura
• Hora de início da jornada deve ser anterior ao fim da jornada
• Hora de início da jornada deve ser anterior ao início do intervalo
• Hora de início da jornada deve ser anterior ao fim do intervalo
• Hora de início do intervalo deve ser anterior ao fim do intervalo
• Hora de fim da jornada deve ser posterior à hora de fim do intervalo
• Ao menos um veículo deve ser selecionado
• Local de saída e retorno são obrigatórios

Etapa 3: Resultado da Roteirização

Esta etapa apresenta os resultados da roteirização realizada com base nos parâmetros definidos anteriormente.

Elementos da Interface:

• Cabeçalho: Mostra "Roteirizador" e "Resultado roteirização" com indicador visual de etapa (3)

• Configurações de resultado:

  • Data da Rota: Campo de data e hora da rota (somente leitura)
  • Status Automático: Checkbox para habilitar atualização automática de status. Quando marcado os itinerários da roteirização terão o status alterado para ENTREGUE quando o veículo passar pelo ponto de interesse.
  • Abertura Automática: Checkbox para habilitar abertura automática de viagens. Quando marcado as viagens com status de AGENDA são alteradas para ABERTO quando chegar na data e hora prevista no campo data de início da roteirização.
  • Tipo Frete: Campo de seleção com opções:
    • Não Lançar
    • Despesa
    • Receita
  • Grupo Despesa: Campo de seleção para categorizar despesas (exibido quando relevante)
  • Grupo Receita: Campo de seleção para categorizar receitas (exibido quando relevante)
  • Valor diária: Campo numérico para definir valor de diária
  • Valor Diária Alimentação: Campo numérico para definir valor de alimentação
  • Descarregamento: Campo numérico para definir valor de descarregamento

• Tabela de resultados: Lista os veículos com suas rotas otimizadas

  • N.: Número sequencial do veículo com indicador visual colorido
  • VEÍCULO: Placa do veículo
  • PEDIDOS: Quantidade de pedidos atribuídos ao veículo
  • KM: Distância total da rota
  • DURAÇÃO: Tempo estimado para completar a rota
  • FIM: Horário estimado de finalização
  • Peso: Soma do peso de todos os pedidos da rota
  • Volume: Soma do volume de todos os pedidos da rota
  • Ações: Botões para interagir com a rota:
    • Imprimir romaneio
    • Alterar veículo
    • Ver lista de itinerários
    • Roteirizar novamente
    • Desenhar percurso
    • Gravar roteirização

• Botões de navegação:

  • Inicio: Retorna para a etapa 1
  • Voltar: Retorna para a etapa 2
  • Criar Nova Roteirização: Salva a roteirização criada no sistema
  • Ver todas as roteirizações: Exibe todas as rotas geradas no mapa

• Mapa: Visualização geográfica das rotas geradas, com marcadores e linhas coloridas indicando o trajeto de cada veículo

• Popups:

  • Veículos disponíveis: Para alterar o veículo de uma rota
  • Selecione o veículo para mover os pedidos: Para transferir pedidos entre veículos
  • Itinerários: Lista detalhada dos pedidos em uma rota, permitindo alterar a ordem de entrega por drag-and-drop

Validações:

• Valores monetários devem ser numéricos positivos
• Ao gravar a roteirização, verifica se a rota foi efetivamente calculada
• Quando altera veículo, verifica capacidades de peso e volume

Fluxo de Trabalho

O sistema segue um processo de três etapas para criar roteirizações eficientes:

1. Seleção de Pedidos:

   • Aplicar filtros para localizar pedidos desejados
   • Selecionar pedidos individuais ou todos os listados
   • Visualizar pedidos selecionados no mapa
   • Avançar para a parametrização

2. Parametrização:

   • Definir pontos de início e fim da rota
   • Configurar horários de jornada e intervalos
   • Selecionar veículos disponíveis para a entrega
   • Definir restrições específicas (peso, volume, etc.)
   • Iniciar o processo de roteirização

3. Resultado da Roteirização:

   • Visualizar rotas otimizadas para cada veículo
   • Analisar estatísticas (distância, tempo, utilização)
   • Ajustar rotas manualmente se necessário
   • Transferir pedidos entre veículos
   • Salvar a roteirização ou reprocessá-la
   • Imprimir romaneios para os motoristas

Instruções Passo a Passo

Como Filtrar e Selecionar Pedidos

1. Acesse a etapa 1 do Roteirizador
2. Preencha os filtros desejados (vendedor, loja, zona, etc.)
3. Defina o intervalo de datas para busca
4. Clique no botão de busca (ícone de lupa)
5. Nos resultados, clique no botão "+" para adicionar pedidos específicos à roteirização
6. Alternativamente, clique no botão "Adicionar todos" para incluir todos os pedidos listados
7. Verifique o contador de pedidos para confirmar a quantidade selecionada
8. Clique em "Próxima Etapa" para continuar

Como Configurar Parâmetros de Roteirização

1. Na etapa 2, selecione o local de saída no dropdown correspondente
2. Marque "Saída Veículo" se deseja considerar o ponto de partida do veículo
3. Selecione o local de retorno no dropdown correspondente
4. Marque "Retorno Veículo" se deseja considerar o ponto de retorno ao veículo
5. Preencha a data e hora da rota
6. Configure os horários de jornada (início, intervalo, fim)
7. Filtre os veículos por categoria e divisão, se necessário
8. Selecione os veículos desejados e clique no botão "+" para adicioná-los
9. Clique no botão de restrições para definir limitações específicas
10. Confirme que todos os pedidos selecionados estão marcados na tabela
11. Clique em "Roteirizar" para processar

Como Gerenciar Resultados da Roteirização

1. Na etapa 3, analise as rotas geradas para cada veículo
2. Configure as opções de status e abertura automática, se desejado
3. Selecione o tipo de frete e preencha valores relacionados
4. Para visualizar detalhes de uma rota específica, clique no botão de lista de itinerários
5. Para transferir pedidos entre veículos, clique no botão de alteração de veículo
6. Para reprocessar uma rota, clique no botão de roteirizar novamente
7. Para salvar a roteirização, clique em "Criar Nova Roteirização"
8. Para imprimir um romaneio, clique no botão de impressora
9. Para visualizar todas as rotas no mapa, clique em "Ver todas as roteirizações"

Como Alterar a Ordem dos Pedidos em um Itinerário

1. Na etapa 3, clique no botão de lista de itinerários para uma rota específica
2. No popup aberto, clique no número do pedido (coluna PEDIDO)
3. Arraste o pedido para a posição desejada na sequência
4. Clique no botão "Alterar Roteirização" para confirmar as mudanças
5. Alternativamente, clique em "Inverter Ordem" para reverter a sequência

Como Transferir Pedidos Entre Veículos

1. Na etapa 3, clique no botão de alteração de veículo para uma rota específica
2. No popup aberto, selecione o novo veículo no dropdown
3. Clique no botão com ícone de atualização para confirmar a transferência
4. Ou, no mapa, desenhe um polígono em torno dos pedidos a transferir
5. No popup que aparece, selecione o veículo de destino
6. Confirme a transferência dos pedidos selecionados

Regras de Negócio e Validações

Validações de Tempo e Jornada

O sistema aplica validações rigorosas aos horários de jornada para garantir que os cronogramas sejam logicamente coerentes:

• A hora de início da jornada deve ser anterior à hora de fim da jornada
• A hora de início da jornada deve ser anterior à hora de início do intervalo
• A hora de início da jornada deve ser anterior à hora de fim do intervalo
• A hora de início do intervalo deve ser anterior à hora de fim do intervalo
• A hora de fim da jornada deve ser posterior à hora de fim do intervalo

Estas validações impedem a criação de roteirizações com cronogramas impossíveis, garantindo que o planejamento de rota seja viável.

Capacidade de Veículos

O sistema verifica automaticamente as capacidades dos veículos selecionados em relação aos pedidos atribuídos:

• O peso total dos pedidos é comparado à capacidade de peso do veículo
• O volume total dos pedidos é comparado à capacidade de volume do veículo
• Se a restrição de "Qtd Max Itens" estiver ativada, verifica-se o número total de itens

Caso as capacidades sejam excedidas, o sistema apresenta alertas visuais na interface, indicando o percentual de utilização através de formatos como: "30.00/1000 (30.00%)"

Roteirizações Agendadas vs. Imediatas

O sistema determina automaticamente se uma roteirização deve ser agendada ou aberta imediatamente:

• Se a data da rota for futura (posterior à data atual), a roteirização é marcada como "AGENDADA"
• Se a data da rota for a data atual, a roteirização é marcada como "ABERTA"

Isto permite o planejamento antecipado de entregas futuras, bem como a gestão de entregas no mesmo dia.

Restrições de Roteirização

Cada restrição ativada modifica o comportamento do algoritmo de roteirização:

• Peso/Volume: Distribui os pedidos respeitando capacidades dos veículos
• Zona: Restringe entregas às zonas permitidas para cada veículo
• Janela de Atendimento: Programa entregas apenas nos horários permitidos
• Agrupar Zona/Vendedor: Mantém pedidos da mesma zona/vendedor no mesmo veículo
• Evitar Estrada de Terra: Prioriza rotas pavimentadas, mesmo que sejam mais longas

As restrições podem ser combinadas para criar estratégias de roteirização personalizadas.

Cálculo de Despesas

O sistema calcula automaticamente despesas associadas à roteirização:

• Frete: Calculado por KM (distância × valor por KM) ou valor fixo
• Diária: Valor diário multiplicado pelo número de dias da viagem
• Alimentação: Valor diário de alimentação multiplicado pelos dias
• Descarregamento: Calculado com base no peso total em toneladas

Estas despesas são classificadas em grupos para facilitar o controle financeiro.

Perguntas Frequentes

Como posso roteirizar pedidos para diferentes dias?

Para roteirizar pedidos para diferentes dias, você deve criar roteirizações separadas para cada data. Na etapa 1, filtre os pedidos pela data desejada, selecione-os e avance para a parametrização. Repita o processo para cada dia planejado.

É possível transferir apenas alguns pedidos de um veículo para outro?

Sim. Na etapa 3, você pode usar a ferramenta de desenho no mapa para selecionar especificamente quais pedidos deseja transferir. Desenhe um polígono ao redor dos pedidos desejados e selecione o veículo de destino quando solicitado.

Como altero a ordem de visita dos pedidos?

Na etapa 3, clique no botão de lista de itinerários para o veículo desejado. No popup que aparece, você pode arrastar os pedidos para reordená-los. Depois, clique em "Alterar Roteirização" para confirmar as mudanças.

O que acontece se um veículo não tiver capacidade suficiente para todos os pedidos?

Se a restrição de peso ou volume estiver ativada, o sistema distribuirá automaticamente os pedidos entre os veículos disponíveis, respeitando suas capacidades. Se não houver capacidade suficiente em nenhum veículo, alguns pedidos serão marcados como "não roteirizados".

Posso roteirizar pedidos em tempo real para motoristas já em rota?

Sim. Você pode criar uma nova roteirização com a data atual e hora presente. O sistema reconhecerá isto como uma roteirização imediata. Após salvar, os motoristas podem receber a atualização em seus dispositivos móveis.

Como imprimo os romaneios para os motoristas?

Na etapa 3, cada linha da tabela de resultados possui um botão com ícone de impressora. Clique neste botão para gerar o romaneio específico daquele veículo, que poderá ser impresso ou salvo em PDF.

As roteirizações salvas podem ser modificadas posteriormente?

Sim, você pode recuperar roteirizações anteriores clicando no botão "Recuperar roteirizações" na etapa 1. No entanto, se a roteirização já tiver sido sincronizada com dispositivos móveis, será necessário cancelar a sincronização antes de modificá-la.

Como o sistema calcula o tempo estimado das rotas?

O tempo estimado é calculado com base na distância da rota, velocidade média esperada para o tipo de via, tempo de espera em cada parada e intervalos programados. Fatores como condições de tráfego também são considerados quando disponíveis.

Alterações, correções e melhorias disponibilizadas na versão 250319.0

• Inclusão da opção de desconsiderar a data do itinerário no fechamento automático de itinerários. Na Etapa 3 da roteirização foi incluído o checkbox Desconsiderar Data  status automático. Ele só está visivel quando o checkbox Status Automático está marcado. Marque essa opção para que o status automático possa ser feito sem considerar a data do itinerário.

Roteirizador de Visistas

Descrição da Interface

O módulo de "Roteirização de Visitas" é uma ferramenta avançada para planejamento logístico que permite a organização de rotas de visitas em pontos de interesse. A interface apresentada é um aplicativo web moderno com design responsivo, composto por três etapas principais divididas em abas numeradas:

1. Seleção de Pontos de Interesse
2. Parametrização
3. Resultado Roteirização

A interface combina elementos de gestão de dados com visualização geoespacial, exibindo simultaneamente tabelas de dados e um mapa interativo para planejamento de rotas. O sistema utiliza cores contrastantes para destaque de informações importantes, com predominância de tons de roxo, branco e cinza, seguindo um design limpo e contemporâneo.

Para acessar clique no menu ROTEIRIZAÇÃO opção ROTEIRIZADOR DE VISITAS.

Elementos da Interface

Etapa 1: Seleção de Pontos de Interesse

Campos de Filtro

• Grupo: Campo de texto livre para filtrar pontos por grupo
• Código: Campo de texto livre para filtrar por código de ponto
• Nome: Campo de texto livre para filtrar por nome do ponto
• Vendedor: Seletor dropdown para escolher vendedores específicos
• Loja: Seletor dropdown para filtrar por lojas específicas
• Zona: Seletor dropdown para filtrar por zonas geográficas

Tabela de Pontos de Interesse

• Checkbox de seleção: Para selecionar múltiplos pontos
• Código: Identificador numérico do ponto
• Nome: Nome descritivo do ponto
• Grupo: Categoria do ponto (Clientes, FAQ, Funcionários)
• Loja: Loja associada ao ponto
• Vendedor: Vendedor responsável pelo ponto (formato: "101 - MUW 2815")
• Zona: Região geográfica (AGUAI, AMERICANA, ALTO LONGÁ, TERESINA)

Elementos Adicionais

• Contador de registros: Mostra o total de registros encontrados
• Mapa interativo: Visualização geográfica dos pontos selecionados
• Botão de pesquisa: Para aplicar os filtros
• Botão de limpar filtros: Para redefinir os critérios de pesquisa
• Botão de recuperar roteirizações anteriores: Para acessar roteiros salvos
• Botão "Próxima Etapa": Para avançar no processo

Modal: Lista de Pontos Selecionados

• Título: "Lista de Pontos Selecionados: [número]"
• Tabela: Lista dos pontos selecionados com código e nome
• Botões de remoção: Para remover pontos individuais
• Botão "Limpar": Para remover todos os pontos da seleção
• Paginação: Para navegar entre páginas de resultados

Modal: Rotas

• Filtros de pesquisa: Veículo, período (de/até), número de pedido
• Tabela de rotas: Mostra rotas existentes com detalhes
• Botões "OK" e "Fechar": Para confirmar seleção ou cancelar

Etapa 2: Parametrização

Campos de Configuração de Rota

• Local de saída:
  • Checkbox "Saída Veículo"
  • Dropdown para seleção de ponto de saída
• Local de retorno:
  • Checkbox "Retorno Veículo"
  • Dropdown para seleção de ponto de retorno
• Data da Rota: Seletor de data e hora com calendário
• Jornada Início: Campo de hora (padrão: 08:00)
• Intervalo Início: Campo de hora (padrão: 12:00)
• Intervalo Fim: Campo de hora (padrão: 14:00)
• Jornada Fim: Campo de hora (padrão: 18:00)
• Restrições: Botão que abre modal de configurações adicionais

Modal de Restrições

• Zona: Checkbox para considerar restrições de zona
• Janela de Atendimento: Checkbox para respeitar janelas de horário
• Qtd Max.Itens: Checkbox para limite máximo de pontos
• Evitar Estrada de Terra: Checkbox para evitar rotas não pavimentadas
• Agrupar Zona: Checkbox para agrupar pontos da mesma zona
• Agrupar Vendedor: Checkbox para agrupar pontos do mesmo vendedor

Tabela de Pontos Selecionados

• Exibe os pontos selecionados na etapa anterior com códigos, nomes e vendedores

Seleção de Veículos

• Dropdown de veículos: Para selecionar um veículo para a rota
• Botão "+": Para adicionar o veículo selecionado à lista
• Lista de veículos selecionados: Mostra veículos já adicionados à roteirização
• Botão "-": Para remover veículos da lista

Etapa 3: Resultado Roteirização

Configurações Financeiras

• Data da Rota: Campo de data não editável (herda da etapa 2)
• Tipo Frete: Opções de radio button:
  • Despesa (gera custo)
  • Receita (gera faturamento)
  • Não Lançar (sem impacto financeiro)
• Calcular por: Opções de radio button (visível apenas se tipo de frete não for "Não Lançar")
  • Por KM (cálculo baseado na quilometragem)
  • Valor Fixo (valor predeterminado)
• Campo de valor: Para inserir valor do frete (visível apenas para cálculos relevantes)

Campos de Despesas Adicionais

• Valor diária: Campo numérico para valor de diária do motorista
• Valor Diária Alimentação: Campo numérico para custos de alimentação
• Descarregamento: Campo numérico para custos de descarga por tonelada

Opções Automáticas

• Status Automático: Checkbox para finalização automática de itinerários
• Abertura Automática: Checkbox para abertura automática de viagens

Tabela de Resultados da Roteirização

• N.: Número sequencial da roteirização com indicador de cor
• VEÍCULO: Placa do veículo designado
• PONTOS: Quantidade de pontos de interesse na rota
• KM: Distância total da rota em quilômetros
• HH:MM: Tempo estimado da rota
• D/H Fim: Data e hora estimada de finalização
• Ações: Botões de ação (impressão, troca de veículo)
• Status: Indicador visual de sucesso/erro da gravação

Elementos Adicionais

• Mapa interativo: Visualização da rota com pontos de interesse, trajeto e marcadores de início/fim
• Modal de informação de ponto: Detalhes de cada ponto ao clicar no mapa
• Botões de navegação: "Início", "Voltar", "Criar Nova Roteirização"

Propósito e Fluxo de Trabalho

O Sistema de Roteirização tem como propósito otimizar rotas de entrega ou visita a pontos de interesse, considerando diversos parâmetros operacionais e restrições. O fluxo de trabalho completo segue três etapas principais:

1. Seleção dos pontos: O usuário filtra e seleciona os pontos de interesse que devem ser incluídos na roteirização.

2. Parametrização: Configuração dos parâmetros da rota, incluindo pontos de partida/chegada, horários de jornada, restrições operacionais e seleção de veículos.

3. Resultado e ajustes: Visualização da rota otimizada, configuração de aspectos financeiros e finalização da roteirização, com opção de gravação ou criação de nova roteirização.

Este processo permite a criação de rotas eficientes, levando em consideração fatores como distância, tempo, janelas de atendimento e características específicas dos veículos, resultando em economia de recursos e melhoria no atendimento ao cliente.

Instruções Passo a Passo

1. Seleção de Pontos de Interesse

1. Aplicar filtros de pesquisa:

   • Preencha os campos de filtro desejados (Grupo, Código, Nome, etc.)
   • Clique no botão de pesquisa (ícone de lupa)

2. Selecionar pontos:

   • Marque as caixas de seleção ao lado dos pontos desejados
   • Ou clique no botão "+" ao lado de cada registro para adicioná-lo

3. Revisar seleção:

   • Clique no ícone do contador (mostra número de pontos selecionados)
   • Verifique a lista de pontos no modal que aparece
   • Remova pontos indesejados se necessário

4. Prosseguir para próxima etapa:

   • Clique no botão "Próxima Etapa" no canto superior direito

2. Configuração dos Parâmetros da Rota

1. Definir pontos de início e fim:

   • Selecione o ponto de saída no primeiro dropdown
   • Marque "Saída Veículo" se quiser usar a localização do veículo como partida
   • Selecione o ponto de retorno no segundo dropdown
   • Marque "Retorno Veículo" se quiser usar a localização do veículo como destino final

2. Configurar horários:

   • Defina a data e hora da rota
   • Configure os horários de jornada (início, intervalo, fim)

3. Configurar restrições:

   • Clique no ícone de "Restrições"
   • Marque as restrições desejadas
   • Clique fora do modal para confirmar

4. Selecionar veículos:

   • Escolha um veículo no dropdown
   • Clique no botão "+" para adicioná-lo à lista
   • Repita para adicionar mais veículos se necessário

5. Iniciar roteirização:

   • Clique no botão "Roteirizar" no canto superior direito

3. Finalização da Roteirização

1. Configurar aspectos financeiros:

   • Selecione o tipo de frete (Despesa, Receita, Não Lançar)
   • Se aplicável, escolha o método de cálculo (Por KM ou Valor Fixo)
   • Preencha os valores de diária, alimentação e descarregamento conforme necessário

2. Configurar automações:

   • Marque "Status Automático" para finalização automática de itinerários
   • Marque "Abertura Automática" para abertura automática de viagens

3. Analisar resultado:

   • Verifique a tabela com os resultados da roteirização
   • Examine o mapa para visualizar a rota completa
   • Clique nos pontos no mapa para ver detalhes adicionais

4. Finalizar processo:

   • Para salvar como nova roteirização, clique em "Criar Nova Roteirização"
   • Para atualizar uma roteirização existente, clique em "Atualizar Roteirização"
   • Para voltar às etapas anteriores, use os botões "Voltar" ou "Início"

Perguntas Frequentes

Seleção de Pontos

1. Como posso encontrar rapidamente um ponto específico? Utilize os filtros disponíveis na parte superior da tela. Você pode buscar por código, nome, ou filtrar por vendedor, loja ou zona.

2. Existe um limite de pontos que posso selecionar para uma roteirização? O limite depende das configurações de restrição de quantidade máxima de itens. Se essa restrição estiver habilitada, o sistema respeitará o limite definido para cada veículo.

3. Posso reutilizar uma roteirização anterior? Sim, clique no botão de "recuperar roteirizações anteriores" (ícone de arquivo) e selecione a rota desejada na lista que aparece.

Parametrização

1. O que significa o checkbox "Saída Veículo"? Ao marcar esta opção, o sistema usará a localização atual ou registrada do veículo como ponto de partida da rota, em vez do ponto de interesse selecionado.

2. O que acontece se eu não selecionar nenhuma restrição? O sistema realizará a roteirização considerando apenas a distância e a ordem dos pontos, sem aplicar restrições adicionais de zona, janela de atendimento, etc.

3. Posso atribuir mais de um veículo para a mesma roteirização? Sim, você pode adicionar vários veículos, e o sistema distribuirá os pontos entre eles da forma mais eficiente possível.

Resultados

1. Como interpreto o status da roteirização? O indicador de status mostra se a roteirização foi gravada com sucesso (verde) ou se houve algum erro (vermelho). Se estiver em cinza, a roteirização ainda não foi gravada.

2. Posso modificar uma rota depois de criada? Sim, desde que ela não tenha sido sincronizada com dispositivos móveis. Você pode voltar às etapas anteriores para ajustar parâmetros ou selecionar diferentes pontos.

3. Como imprimo um romaneio da rota? Clique no ícone de impressora na coluna "Ações" da tabela de resultados para gerar e imprimir um romaneio detalhado da rota.

4. O que significa a opção "Valor Fixo" vs "Por KM" no cálculo do frete? "Por KM" calcula o valor do frete multiplicando o custo por quilômetro pela distância total da rota. "Valor Fixo" permite definir um valor predeterminado, independente da distância.

Regras de Negócio e Validações

Validações Principais

1. Validação de campos obrigatórios:

   • Local de saída e retorno devem ser preenchidos
   • Data da rota é obrigatória
   • Horários de jornada devem seguir uma sequência lógica (início < intervalo início < intervalo fim < fim)
   • Pelo menos um veículo deve ser selecionado

2. Validação de seleção de pontos:

   • É necessário selecionar ao menos um ponto de interesse para prosseguir
   • Os pontos selecionados devem possuir coordenadas geográficas válidas

3. Validação de horários:

   • Hora início jornada < hora início intervalo
   • Hora início jornada < hora fim intervalo
   • Hora início jornada < hora fim jornada
   • Hora início intervalo < hora fim intervalo
   • Hora fim jornada > hora fim intervalo

4. Validação de veículos:

   • Um veículo não pode ser adicionado duas vezes à mesma roteirização
   • Se a restrição de peso estiver ativa, o peso total não pode exceder a capacidade do veículo
   • Se a restrição de volume estiver ativa, o volume total não pode exceder a capacidade do veículo

Comportamentos Específicos

1. Parametrização de custos:

   • Valores de frete, diária, alimentação e descarregamento são opcionais
   • Se "Calcular por KM" for selecionado sem valor específico, o sistema usará o custo por KM cadastrado no veículo
   • Se "Valor Fixo" for selecionado, o campo de valor torna-se obrigatório

2. Tratamento de roteirização agendada:

   • Se a data da rota for maior que a data atual, a roteirização é criada com status "AGENDADA"
   • Se a data for a atual, a roteirização é criada com status "ABERTA"

3. Cálculo automático de despesas:

   • Valor de diária: multiplicado pelo número de dias entre a data atual e a data final
   • Valor de descarregamento: multiplicado pela quantidade em toneladas (peso total / 1000)

4. Proteção de sincronização mobile:

   • Uma roteirização já sincronizada com dispositivos móveis não pode ser atualizada
   • Tentativas de atualização resultarão em mensagem de erro indicando necessidade de cancelar a sincronização

5. Processamento assíncrono:

   • O processo de roteirização pode levar alguns segundos ou minutos
   • O sistema mostra indicador de processamento e consulta periodicamente o resultado
   • Resultados ficam disponíveis para visualização mesmo após sair da tela, desde que o processo tenha sido finalizado

Através desta interface integrada de três etapas, o sistema permite criar roteirizações eficientes considerando diversos parâmetros operacionais, auxiliando empresas a otimizar suas operações logísticas e reduzir custos de transporte, enquanto mantém controle detalhado de aspectos financeiros e operacionais.

Alterações, correções e melhorias disponibilizadas na versão 250319.0

• Inclusão da opção de desconsiderar a data do itinerário no fechamento automático de itinerários. Na Etapa 3 da roteirização foi incluído o checkbox Desconsiderar Data . Ele só está visivel quando o checkbox Status Automático está marcado. Marque essa opção para que o status automático possa ser feito sem considerar a data do itinerário.