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: Uma seção superior com um título "Importação de Pedidos" e um mapa interativo que ocupa aproximadamente 40% da altura da tela. Uma barra de ferramentas com botões de ação e opções de filtro. 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: Seleção : Coluna para selecionar pedidos individuais Status : Ícone indicando o estado de validação do pedido Pedido : Número identificador do pedido Data : Data do pedido (formato YYYY-MM-DD) Hora : Horário do pedido (formato HH:MM) Qtd : Quantidade de itens no pedido R$ : Valor monetário total do pedido Descrição : Descrição textual do pedido Ponto Interesse : Código do ponto de interesse associado Endereço : Endereço de entrega do pedido Zona : Área geográfica de entrega Vendedor : Nome do vendedor responsável Loja : Estabelecimento de origem Peso : Peso total do pedido Volume : Volume total do pedido Hora Inicial : Horário inicial da janela de entrega Hora Final : Horário final da janela de entrega T. Atendimento : Tempo estimado de atendimento Carregamento : Número do carregamento Nota Fiscal : Número da nota fiscal Latitude : Coordenada geográfica (latitude) Longitude : Coordenada geográfica (longitude) Diálogos (Popups) 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 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 Pedido : Tipo: Texto/Numérico Validação: Deve ser único no sistema (gera erro de duplicação) Obrigatório: Sim Data : Tipo: Data Formato: YYYY-MM-DD Validação: Data válida Obrigatório: Sim Hora : Tipo: Hora Formato: HH:MM Validação: Horário válido entre 00:00 e 23:59 Obrigatório: Sim Qtd : Tipo: Numérico Validação: Número inteiro positivo Obrigatório: Sim R$ : Tipo: Monetário Validação: Valor numérico com até duas casas decimais Obrigatório: Sim Descrição : Tipo: Texto Obrigatório: Não Ponto Interesse : Tipo: Texto/Código Validação: Deve existir no cadastro de pontos de interesse Obrigatório: Não, mas recomendado Endereço : Tipo: Texto Obrigatório: Sim, se não houver ponto de interesse Zona : Tipo: Referência Validação: Deve existir no cadastro de zonas Obrigatório: Sim Vendedor : Tipo: Referência Validação: Deve existir no cadastro de vendedores Obrigatório: Sim Loja : Tipo: Referência Validação: Deve existir no cadastro de lojas Obrigatório: Sim Peso : Tipo: Numérico Validação: Valor positivo Obrigatório: Não Volume : Tipo: Numérico Validação: Valor positivo Obrigatório: Não Hora Inicial : Tipo: Hora Formato: HH:MM Validação: Horário válido entre 00:00 e 23:59 Obrigatório: Não 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 T. Atendimento : Tipo: Numérico Validação: Valor positivo (em minutos) Obrigatório: Não Carregamento : Tipo: Texto/Numérico Obrigatório: Não Nota Fiscal : Tipo: Texto/Numérico Obrigatório: Não Latitude : Tipo: Coordenada geográfica Validação: Valor decimal válido entre -90 e 90 Obrigatório: Sim 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: O usuário clica no botão "Importar" para iniciar o processo. No diálogo de importação, o usuário pode marcar se o arquivo é proveniente do sistema Control. O usuário seleciona um arquivo para upload (.xlsx, .xls ou .csv). O sistema processa o arquivo e apresenta os dados na tabela, realizando validações automáticas. Os pedidos com erros são destacados, e o usuário pode filtrar para visualizar apenas esses registros. O usuário pode resolver problemas, como aceitar pedidos duplicados. Os pontos de entrega são exibidos no mapa para verificação visual. Após validar todos os pedidos, o usuário clica em "Gravar Pedidos". No diálogo de gravação, o usuário insere um número de lote (ou usa o gerado automaticamente). 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 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). 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. 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. 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. 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 Clique no botão "Planilha Modelo" na barra de ferramentas. O arquivo modelo MODELO_IMPORTACAO_PEDIDOS.xlsx será baixado para seu computador. 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.