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

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.