Roteirizações

Introdução

O ~~sistema~~módulo ~~de gerenciamento de roteirização~~"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:

Consultar todas as roteirizações criadas

Excluir um roteirização

Imprimir o Romaneio de Entrega.

Imprimir o Espelho da Rota

Ajustar o valor de devolução

Reordenar os itinerários.

Retirar um itinerário da roteirização.

Alterar os dados de um itinerário da roteirização.

Abrir uma roteirização "Agendada".

Iniciar um aroteirização "Aberta".

Finalizar uma roteirização "Em Andamento".

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

O usuário seleciona os filtros desejados
Clica em "Pesquisar" para obter os resultados
Visualiza os dados na tabela com paginação
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

O usuário pode editar o veículo e motorista (quando permitido)
Pode ajustar as datas planejadas
Pode adicionar, remover ou reordenar itinerários
Pode alterar o status da roteirização através do botão de ação de status
Pode imprimir relatórios ou ajustar configurações específicas
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

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

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)

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

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

Descrição

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

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

Descriçã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

O usuário abre o popup a partir da tela principal
Utiliza os filtros para localizar roteirizações anteriores
Seleciona uma roteirização específica
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

Acesse a tela de "Roteirizações"
Expanda o painel de filtros (se estiver recolhido)
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
Opcionalmente, selecione:
- Veículo específico
- Status da roteirização
- Tipo de roteirização (Pedidos ou Visitas)
Clique no botão "Pesquisar" (ícone de lupa)
Os resultados serão exibidos na tabela abaixo

Como Criar uma Nova Roteirização

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

Como Reordenar Itinerários

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

Como Alterar o Status de uma Roteirização

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

Como Gerar Relatórios

Acesse a tela de edição de roteirização
No painel direito, localize os botões de relatório
Para o Romaneio:
- Clique no primeiro ícone de impressora
- O arquivo PDF será gerado e aberto para download
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

Acesse a tela de edição de itinerário
Clique no botão "Ocorrências"
No popup exibido:
- Selecione o tipo de ocorrência no dropdown
- Clique no botão "+" para adicionar
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)
Clique em "Gravar" para salvar as alterações
Feche o popup para retornar à tela do itinerário

Regras de Negócio

Validações Gerais

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)
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"
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
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
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

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)
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
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