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: Seção de Filtros : Localizada na parte superior, permite refinar a consulta de itinerários. 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 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 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 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 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 Na tela de edição do itinerário, o usuário clica no botão "Ocorrências" No modal aberto, visualiza as ocorrências existentes Para adicionar uma nova ocorrência: Seleciona o tipo de ocorrência Clica no botão de adicionar Para tratar uma ocorrência: Edita o campo de tratativa Altera o status para "TRATADO" Clica em "Gravar" para salvar as alterações Fluxo de Gestão de Fotos Na tela de edição do itinerário, o usuário clica no botão "Fotos" No modal aberto, visualiza as fotos existentes Para visualizar uma foto em tamanho maior, clica na miniatura Para baixar uma foto, clica no botão de download Para rotacionar uma foto, utiliza o botão específico Para excluir uma foto, clica no botão de exclusão Para adicionar uma nova foto, utiliza a seção de upload Fluxo de Recuperação de Roteirizações Anteriores Na tela principal, o usuário clica no botão de "Recuperar roteirizações anteriores" No modal aberto, define os filtros para buscar roteirizações Clica em "Pesquisar" para visualizar as opções Seleciona a roteirização desejada Confirma a seleção para carregar os itinerários relacionados Instruções Passo a Passo Como Criar um Novo Itinerário Na tela principal de itinerários, clique no botão de adicionar 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 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 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) Opcionalmente, adicione uma Observação Clique em "Gravar" para criar o itinerário Como Alterar o Status de Múltiplos Itinerários Na tela principal, utilize os filtros para localizar os itinerários desejados Para cada itinerário que deseja incluir, clique no botão de adicionar (ou use o botão "Adicionar todos os itinerários") Clique no ícone de carrinho para abrir o modal de seleção No modal, selecione o novo status a ser aplicado Se o status for "ENTREGUE", preencha a data e hora da entrega Clique no botão de salvar para confirmar a alteração Como Gerenciar Ocorrências de um Itinerário Na tela de edição do itinerário, clique no botão "Ocorrências" Para adicionar uma nova ocorrência: Selecione o tipo de ocorrência no dropdown Clique no botão de adicionar Para tratar uma ocorrência existente: Clique na linha da ocorrência para editar Preencha o campo de tratativa Altere o status para "TRATADO" Clique em "Gravar" para salvar as alterações Como Buscar Veículos Próximos a um Endereço Na tela de edição do itinerário, clique no botão de busca ao lado do campo Veículo No modal aberto, digite o endereço desejado no campo de busca Clique no botão de pesquisa ou pressione Enter Selecione o endereço na lista de resultados O sistema exibirá os veículos próximos com as respectivas distâncias e tempos Clique no veículo desejado para selecioná-lo Como Visualizar e Adicionar Fotos Na tela de edição do itinerário, clique no botão "Fotos" Para visualizar uma foto em tamanho maior, clique na miniatura Para adicionar uma nova foto: Na seção de upload, clique em "Anexar..." Selecione o arquivo de imagem desejado A foto será enviada automaticamente Para rotacionar uma foto, clique no botão de rotação Para fazer download de uma foto, clique no botão correspondente 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 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". 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. 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 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. 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. 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 O que significa o asterisco (*) ao lado de um itinerário? Indica que existem ocorrências pendentes associadas ao itinerário. 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". 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 Que tipos de fotos posso anexar ao itinerário? Você pode anexar imagens em formato PNG, com limite de uma por upload. 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. 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