Pedidos

Descrição da Interface

O módulo "Pedidos" tem o com foco em roteirização e logística. Nessa tela você pode consultar todos os pedidos que podem ser objetos da roteirização. Os pedidos podem ser cadastrados de forma manual, ou serem importados através de API de Importação de Pedidos ou pela módulo de IMPORTAÇÃO DE PEDIDOS. A interface possui três seções principais visualizáveis: uma tela de listagem de pedidos com filtros avançados, uma tela de edição/cadastro de pedido detalhada, e uma modal para operações em lote com pedidos selecionados.

O design usa um esquema de cores suave com tons de cinza, branco e destaques em azul, verde e vermelho para ações importantes. A interface segue um padrão responsivo com distribuição em colunas que se adaptam ao tamanho da tela, e utiliza componentes modernos como dropdowns, datepickers, checkboxes e tabelas interativas.

Para acessar clique no menu ROTEIRIZAÇÃO opção PEDIDOS.

Elementos da Interface

Tela de Listagem de Pedidos

Seção de Filtros

• Vendedor: Dropdown para selecionar vendedor
• Loja: Dropdown para selecionar loja
• Zona: Dropdown para selecionar zona geográfica
• Pedido: Campo de texto para buscar por número de pedido
• Carregamento: Campo de texto para buscar por número de carregamento
• Lote: Campo de texto para buscar por número de lote
• Tipo de Data: Dropdown com opções: "Dt. Venda", "Compr. Entrega", "Dt. Renegociação"
• Período: Dois campos de data para filtrar por intervalo de datas
• Status: Dropdown para selecionar o status do pedido/itinerário
• Sem celular?: Checkbox para filtrar pedidos sem número de celular
• Não roteirizados?: Checkbox para filtrar pedidos não roteirizados
• Botões de Ação:
  • Botão para abrir seleção de pedidos (ícone de carrinho)
  • Botão de pesquisa (lupa)
  • Botão para limpar filtros (ícone de documento)
  • Botão para novo registro (ícone de adição)
  • Botão para exportar para CSV (ícone de salvar)

Tabela de Pedidos

• Colunas:
  • Ação (+): Para adicionar pedido à seleção
  • Pedido: Número do pedido
  • Data: Data do pedido
  • Compromisso: Data de compromisso/renegociação
  • Valor Pedido: Valor em moeda
  • Vendedor/Loja: Nome do vendedor e loja
  • Zona: Zona geográfica
  • Celular: Número de contato
  • Carregamento/Lote: Número de carregamento e lote
  • Itinerário: Status e data/hora de entrega

Paginação

• Indicação de registros exibidos (Ex: "1 - 11 de 14")
• Botões de navegação entre páginas

Modal de Pedidos Selecionados

• Título: "Lista de Pedidos Selecionados"
• Tabela de Pedidos Selecionados:
  • Colunas: Pedido, Data, Vendedor
  • Botão para remover pedido da seleção (-)
• Campo Número do Carregamento: Para inserir ou gerar número de carregamento
• Botões de Ação:
  • Excluir em Lote: Para excluir todos os pedidos selecionados
  • Criar Carregamento: Para agrupar pedidos em um carregamento
  • Limpar (ícone X): Para limpar a seleção

Tela de Edição/Cadastro de Pedido

Seção Principal

• Botões de Ação Superior:
  • Gravar: Para salvar o pedido
  • Excluir: Para remover o pedido (visível apenas para registros existentes)
  • Voltar: Para retornar à listagem
  • Ocultar campos opcionais?: Checkbox para simplificar o formulário

Dados do Pedido

• Número do Pedido: Campo de texto (obrigatório)
• Número Nota Fiscal: Campo de texto (opcional)
• Carregamento: Campo de texto (opcional)
• Lote: Campo de texto (opcional)
• Data: Seletor de data e hora (obrigatório)
• Compromisso de Entrega: Seletor de data e hora (opcional)
• Renegociação da Entrega: Seletor de data e hora (opcional)
• Quantidade: Campo numérico (obrigatório)
• Valor: Campo numérico (obrigatório)
• Peso: Campo numérico (obrigatório)
• Volume: Campo numérico (obrigatório)
• Descrição: Campo de texto (obrigatório)

Seção de Localização

• Cliente: Dropdown para selecionar cliente/ponto de interesse
• Endereço: Campo de texto com botão de busca para geolocalização
• Vendedor: Dropdown (obrigatório)
• Loja: Dropdown (obrigatório)
• Zona: Dropdown (obrigatório)

Seção de Restrições

• Horário Inicial: Seletor de hora (obrigatório)
• Horário Final: Seletor de hora (obrigatório)
• T. Atendimento: Campo numérico em minutos (obrigatório)
• Número Celular: Campo de texto com botão para WhatsApp (opcional)
• Liberado para Separação?: Checkbox (opcional)
• Liberado para Roteirização?: Checkbox (opcional)
• Observação: Campo de texto longo (opcional)

Mapa

• Um mapa interativo ocupa aproximadamente 1/3 da tela à direita
• Permite visualizar e definir a localização do pedido
• Mostra o endereço geolocalizado com marcador

Propósito e Fluxo de Trabalho

O sistema serve para gerenciar o ciclo de vida de pedidos desde o registro até a entrega, com foco em operações de distribuição e logística. O fluxo de trabalho típico inclui:

1. Cadastro de Pedidos: Os usuários registram novos pedidos com informações detalhadas sobre o cliente, produtos, quantidades, valores e localização.

2. Gestão de Status: Os pedidos seguem um fluxo de processamento com status como:

   • Venda Finalizada
   • Liberado para Separação
   • Em Separação
   • Separados
   • Liberados para Roteirização
   • Em rota (com vários status possíveis: Aberto, Adiado, Entregue, etc.)

3. Organização em Lotes e Carregamentos: Os pedidos podem ser agrupados em carregamentos para facilitar a logística.

4. Roteirização: Os pedidos são atribuídos a rotas de entrega com base em localização, zona, horários e outras restrições.

5. Acompanhamento: O sistema permite acompanhar o status de cada pedido durante todo o ciclo.

Instruções Passo a Passo para Operações Principais

Pesquisar Pedidos

1. Acesse a tela de listagem de pedidos
2. Na seção de filtros, preencha os campos desejados:
   • Selecione um vendedor, loja ou zona (opcional)
   • Digite um número de pedido ou carregamento específico (opcional)
   • Escolha o tipo de data (Venda, Compromisso, Renegociação)
   • Defina o período de datas a ser pesquisado
   • Selecione um status (opcional)
   • Marque os checkboxes desejados (Sem celular, Não roteirizados)
3. Clique no botão de pesquisa (ícone de lupa)
4. Os resultados serão exibidos na tabela abaixo
5. Use os controles de paginação para navegar entre as páginas de resultados

Cadastrar Novo Pedido

1. Na tela de listagem, clique no botão de novo registro (ícone +)
2. Preencha os campos obrigatórios:
   • Número do Pedido
   • Data
   • Quantidade
   • Valor
   • Peso
   • Volume
   • Descrição
   • Vendedor
   • Loja
   • Zona
   • Horário de Atendimento Inicial e Final
   • Tempo de Atendimento
3. Defina a localização de entrega:
   • Selecione um cliente existente, ou
   • Digite um endereço e use o botão de busca para geolocalização
4. Preencha os campos opcionais conforme necessário
5. Clique no botão "Gravar" para salvar o pedido

Editar um Pedido Existente

1. Na tela de listagem, localize o pedido desejado
2. Clique na linha do pedido para abrir a tela de edição
3. Modifique os campos necessários
4. Clique no botão "Gravar" para salvar as alterações

Criar um Carregamento com Múltiplos Pedidos

1. Na tela de listagem, clique no botão "+" ao lado de cada pedido que deseja incluir
2. Clique no ícone de carrinho de compras para abrir a modal de pedidos selecionados
3. Verifique se todos os pedidos desejados estão na lista
4. No campo "Número do Carregamento":
   • Digite manualmente um número, ou
   • Clique no ícone de tag para gerar um número automaticamente
5. Clique no botão "Criar Carregamento"
6. Confirme a operação quando solicitado

Excluir Pedidos em Lote

1. Na tela de listagem, clique no botão "+" ao lado de cada pedido que deseja excluir
2. Clique no ícone de carrinho de compras para abrir a modal de pedidos selecionados
3. Verifique se todos os pedidos a serem excluídos estão na lista
4. Clique no botão "Excluir em Lote"
5. Confirme a operação quando solicitado

Exportar Dados para CSV

1. Aplique os filtros desejados para restringir os dados a serem exportados
2. Clique no botão de exportar para CSV (ícone de salvar)
3. Selecione o local para salvar o arquivo
4. Confirme a operação

Regras de Negócio e Validações

Validações de Pedido

• Número do Pedido: Obrigatório e deve ser único
• Data: Obrigatória
• Endereço: Obrigatório e deve ter coordenadas válidas (latitude/longitude)
• Vendedor: Obrigatório
• Loja: Obrigatório
• Zona: Obrigatório
• Valor: Obrigatório e deve ser numérico
• Quantidade: Obrigatória e deve ser numérica
• Peso: Obrigatório e deve ser numérico
• Volume: Obrigatório e deve ser numérico
• Descrição: Obrigatória

Status de Pedido

O pedido pode passar pelos seguintes estados:

1. Venda Finalizada: Estado inicial após cadastro
2. Liberado para Separação: Pedido disponível para ser separado no estoque
3. Em Separação: Processo de separação iniciado
4. Separados: Produtos separados e prontos para roteirização
5. Liberados para Roteirização: Disponível para ser incluído em uma rota
6. Em itinerário: Atribuído a uma rota com diferentes sub-estados:
   • Aberto: Incluído na rota mas não iniciado
   • Adiado: Entrega adiada
   • Devolvido: Produto retornou ao depósito
   • Entregue: Entrega realizada com sucesso
   • Pendente: Aguardando resolução de alguma pendência
   • Endereço Fechado: Tentativa de entrega sem sucesso por local fechado
   • Endereço Errado: Endereço incorreto
   • Endereço Não Localizado: Endereço não encontrado
   • Não Informado: Status não atualizado

Funcionamento do Carregamento

• Um carregamento agrupa múltiplos pedidos para otimizar a logística
• O número de carregamento pode ser gerado automaticamente ou definido manualmente
• Pedidos no mesmo carregamento geralmente são entregues na mesma rota

Geolocalização

• O sistema utiliza Google Maps para geolocalização de endereços
• É possível localizar um endereço através de busca textual
• As coordenadas (latitude/longitude) são armazenadas para cada pedido
• O mapa permite ajuste manual da localização através de arrasto do marcador

Perguntas Frequentes

Como filtrar pedidos de um período específico?

Na seção de filtros, selecione o tipo de data que deseja considerar (Venda, Compromisso ou Renegociação), depois defina as datas de início e fim no período desejado e clique no botão de pesquisa.

Como associar múltiplos pedidos a um único carregamento?

Selecione os pedidos desejados clicando no botão "+" ao lado de cada um, depois abra a modal de pedidos selecionados através do ícone de carrinho, defina um número de carregamento e clique em "Criar Carregamento".

Como encontrar pedidos que ainda não foram roteirizados?

Na seção de filtros, marque a opção "Não roteirizados?" e clique no botão de pesquisa.

Como localizar um endereço de entrega no mapa?

Na tela de edição de pedido, digite o endereço no campo "Endereço" e clique no botão de busca (lupa). O sistema irá geocodificar o endereço e posicionar o marcador no mapa.

Como exportar uma lista de pedidos para trabalhar em outro sistema?

Aplique os filtros desejados para obter a lista específica, depois clique no botão de exportar para CSV (ícone de salvar).

Como estabelecer as restrições de horário para entrega?

Na seção de restrições ao editar um pedido, defina o horário inicial e final disponível para entrega, bem como o tempo estimado de atendimento em minutos.

É possível excluir múltiplos pedidos de uma vez?

Sim, selecione os pedidos desejados, abra a modal de pedidos selecionados e clique em "Excluir em Lote".

Como liberar um pedido para roteirização?

Abra o pedido para edição, marque a opção "Liberado para Roteirização?" e salve, ou utilize as funcionalidades em lote para liberar múltiplos pedidos simultaneamente.

Por que não consigo excluir um pedido?

Se o pedido já foi incluído em um itinerário ou rota, o sistema não permitirá sua exclusão para manter a integridade dos dados.

Como posso rapidamente contatar o cliente?

Se o número de celular estiver cadastrado, na tela de edição do pedido aparecerá um ícone do WhatsApp ao lado do campo de celular, que abrirá uma conversa diretamente.

Observações Adicionais

O sistema implementa um fluxo logístico completo que permite o acompanhamento detalhado de cada pedido desde o momento da venda até a entrega final. Com recursos de geolocalização, agrupamento em carregamentos e roteirização, o sistema oferece ferramentas para otimizar a operação logística e reduzir custos.

A interface foi projetada para ser intuitiva e eficiente, permitindo que o usuário execute rapidamente as tarefas mais comuns, como cadastrar pedidos, criar carregamentos e acompanhar entregas, enquanto fornece flexibilidade para casos especiais através de filtros avançados e operações em lote.

A estrutura de dados subjacente mantém relacionamentos entre pedidos, rotas, vendedores, lojas e zonas, permitindo análises detalhadas e relatórios logísticos abrangentes.