- WMS > Cadastros > Cadastro de Priorização WMS
- 4022 – Priorização WMS – Consultar
- 4535 – Sequência de Separação: Editar
1. Conceito
Esta tela possui um duplo objetivo logístico. O primeiro é permitir a configuração da prioridade das lojas para liberação automática de lotes (reservados temporariamente) após a conclusão do ressuprimento de picking ou endereçamento. O segundo objetivo é fornecer uma ferramenta visual e flexível para customizar a sequência de separação (picking) descendo ao nível de Coluna, permitindo desenhar rotas inteligentes que otimizam o percurso dos operadores e maximizam a produtividade no armazém.

2. Acesso à Funcionalidade
O acesso é realizado através do caminho WMS > Cadastros > Cadastro de Priorização WMS. Ao acessar a tela, o sistema apresentará a interface dividida em duas abas principais, separando as configurações de reserva de lotes das configurações de rota física de separação:
- Sequência de Liberação de Lote
- Sequência de Separação
Outra opção, é usar a funcionalidade de Busca Rápida do Bluesoft ERP, informando o código do menu (menukey) 2200.
2.1 Usuário Sem Acesso
Caso um usuário sem a permissão necessária (4022 - Priorização WMS - Consultar) tente acessar o caminho WMS > Cadastros > Cadastro de Priorização WMS, a funcionalidade não estará disponível.

Se esse usuário tentar acessar a funcionalidade através da Busca Rápida informando o código do menu 2200, o sistema exibirá em tela uma mensagem de restrição de acesso.

3. Aba: Sequência de Separação
Esta aba permite desenhar a rota logística real da operação, rompendo a limitação da ordem alfanumérica crescente e adaptando o sistema ao layout físico (como separações em U ou Z).

4. Filtros de Busca
Ao acessar a a funcionalidade, utilize os filtros disponíveis para refinar a sua busca.

4.1 Filtros Obrigatórios
- Loja: Lista os Centros de Distribuição (CD) com cadastros ativos.

- Local Estoque: Lista os Locais com cadastros ativos, vinculados ao CD selecionado.
- Somente Locais com tipo de controle Endereçamento Logístico serão listados.

- Área: Lista as Áreas com cadastros ativos, vinculadas ao Local de Estoque e CD selecionados.

4.2 Filtros Opcionais
- Rua: Lista as Ruas com cadastros ativos, vinculadas a Área, Local de Estoque e CD selecionados.
- Permite multiseleção.

- Com / Sem Sequência: Lista a opção Todos (padrão), Com Sequência e Sem Sequência.

5. Botões do Painel Superior
O painel superior disponibiliza alguns botões com funcionalidades específicas.

- Importar: Permite importar arquivos com extensão CSV.
- Organizar Sequência de Separação: Ao clicar, o sistema renumera de forma automática e em ordem crescente (1, 2, 3…) todos os registros que estiverem sendo exibidos na grade, considerando os filtros aplicados em tela.
- Buscar: Ao clicar, o sistema processa a requisição e atualiza a grade de resultados com os dados prontos para visualização, considerando os filtros aplicados em tela.
6. Grade de Resultados
A grade de resultados foi desenhada para exibir a hierarquia física completa do endereço e permitir a edição rápida da rota.

6.1 Colunas
- Sem Label (Arrastar e Soltar): Exibe o ícone de movimentação: ☰.
- Ao clicar e segurar este ícone, o usuário pode arrastar a linha inteira para cima ou para baixo, alterando a sequência de separação de forma visual e intuitiva.
- Sequência Separação Atual: Exibe o número da ordem de roteirização (picking) definida para aquela coluna física.
- Este é um campo editável: ao clicar sobre a célula, o usuário pode digitar diretamente um novo valor de sequência.
- O valor digitado deve ser obrigatoriamente um número inteiro, maior ou igual a zero e menor ou igual a 99999.
- Células que exibem o valor 0 (zero) indicam que o endereço ainda não possui uma rota customizada.
- Coluna: Exibe o número de identificação física da Coluna na estrutura do porta-palete.
- Loja: Identifica o Centro de Distribuição onde a estrutura está localizada.
- Local Estoque: Apresenta a classificação do estoque dentro do CD (Ex: ESTOQUE PADRÃO).
- Área: Indica o número da Área física à qual o corredor pertence.
- Rua: Representa o Corredor principal de circulação onde a coluna está localizada.
- Ações: Exibe o botão 🗑️ (Excluir).
- A função deste botão não é deletar o endereço do sistema, mas sim limpar a sequência de separação (se existir).
- Ao clicar, a priorização é removida e a Sequência Separação Atual retorna para 0 (zero).
- Ocorrências: Exibe o botão 📖 (Ocorrências).
- Ao clicar, o sistema abre um modal listando toda a trilha de auditoria daquela Coluna específica, exibindo data e hora da gravação, usuário modificador, origem da mudança (Edição Manual, Movimentação, Reorganização e Importação) e os valores exatos de De / Para.
6.2 Totalizador e Controles de Paginação
Para garantir a alta performance e a fluidez visual da tela — especialmente durante o uso da funcionalidade de reordenação manual (Arrastar e Soltar) —, a grade de resultados conta com recursos de totalização e paginação localizados em seu rodapé:

- Paginação: A exibição dos resultados é segmentada de forma otimizada, com um limite máximo de até 1.000 registros por página. Para transitar entre os dados, utilize os controles de navegação
<(página anterior) e>(próxima página), localizados no canto inferior direito.
- Totalizador: Junto aos controles de navegação, o sistema exibe um contador dinâmico. Ele reflete a quantidade total de registros retornados com base nos filtros aplicados e indica o intervalo de itens que está sendo visualizado na tela atual (Exemplo: 1-1000 de 2000).
7. Definindo a Sequência de Separação
O sistema oferece flexibilidade total para que você desenhe a rota logística da sua operação, adaptando-se ao layout físico do seu armazém. É possível definir a sequência de separação das seguintes formas:
- Edição Manual: Na grade de resultados, clique sobre a célula exata na coluna Sequência Separação Atual e digite o valor da ordem desejada.
- O campo aceita apenas números inteiros e positivos (suporta até 5 dígitos, com limite de 99999).
- Uma mensagem de sucesso será exibida em tela confirmando a operação.
- Reordenação Visual (Arrastar e Soltar): Clique no ícone de movimentação (☰) localizado na extremidade esquerda da linha, arraste e solte na posição desejada. O sistema ajustará o número da sequência instantânea e automaticamente.
- Importante:
- Para utilizar corretamente essa funcionalidade é essencial que sequências já tenham sido previamente definidas.
- Não será possível mover uma sequência para entre duas outras sequências com valor 0 (zero).
- Ao mover uma sequência para outra posição desejada, as demais sequências serão reordenadas.
- Importante:
- Organização Automática: Através do botão Organizar Sequência de Separação localizado no topo da grade, é possível realizar a organização (ou reorganização) automática das sequências. Ao clicar nele, o sistema renumera de forma automática e em ordem crescente (1, 2, 3…), somente os registros que estiverem sendo exibidos no seu filtro atual.
- Edição em Massa: Ideal para implementações ou grandes reestruturações de rota. Utilizando o botão Importar, você pode fazer o upload de uma planilha CSV para atualizar o sequenciamento massivamente. O sistema aplica a regra do Tudo ou Nada: caso haja qualquer erro (de extensão, formatação ou dados inválidos), o arquivo inteiro é rejeitado e um modal exibirá exatamente qual o motivo da rejeição e quais linhas necessitam de correções.
8. Exclusão de Sequências de Separação
Caso seja necessário remover a priorização de uma rota específica diretamente pela interface do sistema, utilize o recurso de desconfiguração por linha:
- Como utilizar: Na grade de resultados da pesquisa, localize a linha correspondente à Coluna física que deseja alterar. Vá até a coluna Ações e clique no botão 🗑️ (Excluir).
- Uma mensagem de sucesso será exibida em tela.
9. Importação e Exportação de Arquivo CSV
Este bloco detalha a Carga e a Extração automatizada das rotas de picking em lote, permitindo realizar manutenções massivas através de arquivos com extensão CSV.
9.1 Padrão e Layout Obrigatório do Arquivo CSV
Para que o processo de importação ocorra sem erros, o arquivo CSV deve seguir estritamente as seguintes definições técnicas:
- Extensão do Arquivo: O arquivo deve ser salvo obrigatoriamente com a extensão .csv.
- O sistema valida a extensão no ato do upload e rejeita qualquer outro formato.
- Delimitador de Campos: O caractere separador das colunas deve ser estritamente o ponto e vírgula (;).
- Arquivos que utilizem vírgulas ou tabulações serão bloqueados com aviso de delimitador incorreto.
- Identificação por Chave Física: O layout desobriga o uso de IDs internos do banco de dados.
- A associação é feita diretamente pela combinação da estrutura física do armazém.
- Padronização do Cabeçalho: A primeira linha do arquivo deve conter exatamente a estrutura e a ordem dos campos descritas abaixo. Não é permitida a inversão da ordem das colunas:
COD_LOJA;COD_LOCAL;COD_AREA;COD_RUA;COD_COLUNA;SEQUENCIA
9.2 Regras de Preenchimento e Validação de Dados
- Valores Permitidos para a Rota: O campo SEQUENCIA aceita apenas números inteiros positivos (suporta até 5 dígitos, com o valor limite máximo de 99999).
- Inserções de letras, símbolos ou caracteres especiais disparam alertas de erro.
- Limpar Sequência em Massa: Para remover a prioridade de uma coluna porta-palete através do arquivo CSV, preencha o campo SEQUENCIA com o valor 0 (zero).
- A Coluna passará a ser considerada sem Sequência de Separação customizada.
- Regra do “Tudo ou Nada”: O processamento adota uma validação integral rígida. Se o arquivo contiver 1.000 linhas perfeitas e apenas uma única linha com erro (Ex: código de local de estoque inexistente, campo de loja vazio ou formato de número decimal), toda a importação é abortada e nenhum dado é salvo.
- Interface de Feedback de Erros: Sempre que um arquivo for rejeitado, o sistema exibirá o modal Erros na Importação, listando detalhadamente todas as linhas que falharam com mensagens claras e instrutivas para correção.
- Feedback de Progresso: Para arquivos CSV com alta volumetria (acima de 1.000 linhas), o motor de importação divide o processamento em lotes por motivos de performance. Durante este intervalo, o sistema exibe uma barra de progresso em formato de porcentagem para sinalizar o andamento da operação.
9.3 Exportação de Dados
- Exportação de Dados: Ao clicar em Exportar em CSV na grade de resultados, o sistema extrai os registros atualmente visíveis e filtrados na grade, gerando o arquivo com o cabeçalho padrão e envolvendo os dados de texto entre aspas duplas (“”). Caso o usuário queira limpar as aspas antes de reimportar, poderá utilizar a função Localizar e Substituir de qualquer editor de texto.
- Também é possível exportar os dados filtrados em PDF.
10. Rastreabilidade
O sistema possui uma rotina de auditoria persistente que grava todas as interações e modificações de rotas, permitindo rastrear erros de planejamento ou alterações operacionais:
- Como utilizar: Na grade de resultados, localize a linha da coluna que deseja auditar. Vá até a coluna Ocorrências e clique no botão 📖 (Ocorrências).
- Interface de Visualização: Ao clicar no botão, o sistema abrirá uma janela modal centralizada na tela, exibindo a trilha de auditoria organizada em colunas com a Data e Hora exata da gravação, a Mensagem de Log o login do Usuário responsável pela alteração.
- Dados do Log: A mensagem segue um padrão rígido de rastreabilidade, descrevendo o momento exato da gravação, a alteração de valores de De / Para e por qual canal ela foi executada e quem fez a ação.

11. Possíveis Dúvidas (FAQ)
- O que acontece se duas colunas ficarem com o mesmo número de sequência?
O sistema aplicará uma regra inteligente de desempate. Ele respeitará primeiramente a numeração da sequência informada, mas, caso haja números iguais, o WMS ordenará seguindo a hierarquia física real do CD na seguinte ordem: Área > Rua > Coluna.
- Se o CD cadastrar um endereço logístico novo amanhã, qual será sua sequência?
Para evitar falhas de processamento por valores nulos, o sistema foi parametrizado para criar novos endereços logísticos automaticamente com a sequência padrão preenchida com o valor 0 (zero). O endereço recém-criado aparecerá normalmente nas buscas da tela e poderá ter sua rota editada posteriormente.
- Por que os endereços com sequência zero (0) estão no fim da listagem?
Por regra de negócio, quando a busca é realizada com a opção Todos, o sistema entende que registros sem numeração de rota definida (zero) não são prioritários, movendo-os automaticamente para o final da grade de exibição.
- Por que o sistema exibe uma mensagem de bloqueio ao tentar arrastar linhas com valor zero?
Devido a restrições técnicas de ordenação lógica do banco de dados, o sistema bloqueia a funcionalidade de mover e arrastar linhas para posições situadas entre duas colunas que possuam o valor de sequência zerado (0). Caso tente realizar essa ação, o sistema retornará a linha para a posição original e exibirá o alerta: Não é possível mover uma sequência para entre duas sequências com valor 0. Primeiro ordene as sequências e depois tente novamente. Para reordenar essas linhas, utilize primeiramente a edição numérica direta ou o botão de organização automática.
