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: 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 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 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 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 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 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 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 Roteirizações 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. 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. 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. 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. É 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 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. 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". 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. 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. 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 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. 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. 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 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. 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. 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.