beestock:releases.notes:releases.notes.beestock.2025.1.28.2 [SZ Soluções Wiki]

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== 🚀 Release Notes v1.28.2 - 31/08/2025 ======

----

===== 📌 Resumo da Release =====

  * 11 Melhorias aplicadas em performance, usabilidade e segurança operacional.  
  * 25 Correções garantindo estabilidade e padronização entre Web, Coletor e relatórios.  

**Destaques da Versão**:
  - 🔎 Pesquisa dinâmica de endereços no coletor.  
  - 📋 Instruções específicas por cliente (pop-up no picking).  
  - 🔗 Integração de Confirmação de Separação após divergência.  
  - 📊 Diversos ajustes em dashboards de expedição, recebimento e inventário.  

----

===== ✨ Melhorias =====

**01. BEES-2482: [Melhoria] - Consulta Documento de Separação x Etiqueta**

=== SITUAÇÃO/REQUISITO ===

A consulta "Documento de Separação x Etiqueta" apresentava lentidão excessiva, chegando a ultrapassar 1 minuto em alguns casos.  
Essa demora impactava diretamente a operação, pois a tela é usada em ponto crítico do processo de expedição.

=== SOLUÇÃO ===

Foi criada uma nova coluna na tabela de etiqueta seriada para salvar o ID do documento de saída.  
A lógica do picking foi ajustada para gravar esse dado e a devolução passou a limpar a informação.  
Além disso, a consulta foi revisada para utilizar a nova coluna, resultando em respostas muito mais rápidas.

----

**02. BEES-2604: [Melhoria] - Pesquisa de Endereços no Coletor**

=== SITUAÇÃO/REQUISITO ===

Na tela "Consulta > Endereços" do coletor, o operador precisava digitar o código completo ou ler o código de barras para consultar.  
Isso tornava o processo pouco prático e sujeito a erros, quando comparado à tela de "Transferência de Endereços", que já possuía busca dinâmica.

=== SOLUÇÃO ===

Foi implementada a pesquisa "ao digitar" (autocomplete) no campo de endereço.  
Agora, ao digitar os primeiros caracteres, o sistema exibe a lista de endereços correspondentes e permite a seleção imediata.  
O comportamento foi padronizado com o que já existia na tela de Transferência de Endereços.

----

**03. BEES-2601: [Melhoria] - Instruções Específicas por Cliente**

=== SITUAÇÃO/REQUISITO ===

Durante o picking e conferência, os operadores não recebiam instruções específicas solicitadas por clientes, como observações de montagem ou expedição.  
Essa ausência gerava riscos de falhas e retrabalho, especialmente para clientes que possuem exigências particulares.

=== SOLUÇÃO ===

Foi criado um novo campo no cadastro de clientes chamado **“Instruções Expedição”**, permitindo armazenar até 500 caracteres.  
Esse conteúdo passou a ser exibido em pop-up no início das rotinas de Picking e Conferência, tanto no Coletor quanto no Web.  
O pop-up aparece uma única vez por pedido e requer confirmação de leitura antes do operador prosseguir.
----

**04. BEES-2600: [Melhoria] - Inclusão da Coluna "Entrega" no Monitor de Expedição**

=== SITUAÇÃO/REQUISITO ===

O campo "Entrega" estava disponível apenas na rotina Movimentação > Expedição > Documentos de Saída.  
Porém, para facilitar o acompanhamento em tempo real, era necessário que esse campo também estivesse presente no Monitor de Expedição, principal tela utilizada pelas equipes de logística para acompanhar as separações e expedições.  
Essa ausência dificultava a identificação rápida da entrega de cada documento e prejudicava o agrupamento e priorização de pedidos.

=== SOLUÇÃO ===

Foi incluída a coluna "Entrega" na grid principal do Monitor de Expedição, exibindo a mesma informação já utilizada na rotina Documentos de Saída.  
A coluna foi posicionada em local estratégico para melhor visualização e passou a seguir as mesmas regras de visibilidade.  
Também foi avaliada a viabilidade de filtro por entrega no cabeçalho da tela, sem impacto de desempenho.

----

**05. BEES-2598: [Melhoria] - Conferência de Entrega: Permitir Busca da RM sem Sequencial**

=== SITUAÇÃO/REQUISITO ===

Na conferência de entrega, o campo de requisição exigia o número completo da RM, incluindo sequencial (ex.: 4096540-1).  
Esse comportamento diferia de outras telas do sistema, como "Separação por Documento", que permitiam pesquisa apenas pelo número base.  
Essa diferença gerava dificuldade para os operadores e aumentava o risco de erro no momento da conferência.

=== SOLUÇÃO ===

Foi habilitada a pesquisa por número base da RM, permitindo que o usuário digite apenas o número inicial e visualize todos os sequenciais associados.  
Ao selecionar o documento, o campo de requisição passou a ser preenchido automaticamente.  
O layout e interação foram padronizados com a tela de Separação por Documento, eliminando a obrigatoriedade de informar o sequencial para a busca inicial.
----

**06. BEES-2602: [Melhoria] - Trava de Segurança no Fechamento de Doca por Transportadora**

=== SITUAÇÃO/REQUISITO ===

O sistema já permitia alteração de transportadora após início da separação, mas não havia um controle no fechamento da doca.  
Esse cenário abria risco de volumes serem expedidos em docas incorretas, caso houvesse divergência entre a transportadora física e a transportadora final registrada no pedido.

=== SOLUÇÃO ===

Foi implementada uma trava de segurança no coletor, na função "Fechar Doca".  
Agora, ao fechar a doca, o sistema valida se a transportadora da doca corresponde à transportadora final do pedido.  
Caso haja divergência, o fechamento é bloqueado e uma mensagem orienta o operador a remover os volumes e realocar na doca correta antes de prosseguir.

----

**07. BEES-2624: [Melhoria] - Ajustes Visuais na Divergência de Devolução**

=== SITUAÇÃO/REQUISITO ===

Durante testes da demanda BEES-2448, foi identificado que as telas de seleção de depósito e endereço não deixavam claro que esses campos eram obrigatórios para direcionar itens divergentes.  
Além disso, na seleção de tipo de divergência, o pop-up não permitia cancelar a operação, gerando confusão para os usuários.

=== SOLUÇÃO ===

Foram incluídos rótulos de orientação acima dos campos, com os textos:  
- “Selecione o Depósito de Destino”  
- “Selecione o Endereço de Destino”  
Também foi ajustado o pop-up de seleção de divergência, permitindo o cancelamento da ação pelo usuário.

----

**08. BEES-2599: [Melhoria] - Parâmetros de Controle de Transferências por Onda e Endereço**

=== SITUAÇÃO/REQUISITO ===

O sistema permitia movimentações entre depósitos sem restrição, o que podia gerar quebras de processo, erros de alocação e divergências de estoque.  
Foi solicitado maior segurança operacional, permitindo restringir entradas, saídas e transferências de endereço por meio de parâmetros configuráveis no cadastro de depósitos.

=== SOLUÇÃO ===

Foram criados três novos parâmetros no cadastro de depósitos:  
- **Transferência Onda - Entrada**  
- **Transferência Onda - Saída**  
- **Transferência de Endereço**  
Esses parâmetros passaram a controlar a visibilidade dos depósitos nas rotinas correspondentes (Web e Coletor).  
Também foram implementadas validações para impedir alterações caso houvesse transferências em aberto, exibindo mensagem com os documentos pendentes.

----

**09. BEES-2597: [Melhoria] - Correção do Tooltip na Tela de Edição de Filial**

=== SITUAÇÃO/REQUISITO ===

Na aba "Separação" da tela de edição de filial, o ícone de informação (tooltip) estava mal posicionado e com texto truncado, sem associação clara ao parâmetro correto.  
Esse problema quebrava o padrão de design e confundia os usuários.

=== SOLUÇÃO ===

O ícone foi reposicionado ao lado do parâmetro “Restringir informações na busca de Doc de separação”, alinhado corretamente ao texto.  
O conteúdo do tooltip foi corrigido e passou a exibir a descrição completa, garantindo consistência visual e clareza de informação.

----

**10. BEES-2605: [Melhoria] - Exibição de Usuários Ativos nos Monitores**

=== SITUAÇÃO/REQUISITO ===

Nas telas de Monitor de Recebimento e Monitor de Ressuprimento, a lista de usuários para atribuição incluía também usuários inativos.  
Isso dificultava a operação e poderia gerar atribuições incorretas de responsabilidades.

=== SOLUÇÃO ===

Foi ajustada a filtragem da lista de seleção de usuários para exibir apenas aqueles com status ativo no cadastro.  
A regra passou a ser aplicada tanto na exibição inicial quanto nas buscas dinâmicas, sem alterar o funcionamento padrão para usuários ativos.

----

**11. BEES-2592: [Melhoria] - Integração "Confirma Separação" após Divergência**

=== SITUAÇÃO/REQUISITO ===

Foi identificado que, ao liberar divergência com quantidade zerada como última ação de um documento, o sistema atualizava o status corretamente, mas não disparava a integração de "Confirma Separação".  
Esse comportamento fazia com que o ERP não recebesse a confirmação, gerando inconsistências no fluxo.

=== SOLUÇÃO ===

Foi ajustada a lógica para que, mesmo quando a última ação do documento for a liberação de divergência, o sistema dispare corretamente a integração de "Confirma Separação" para o ERP, garantindo a continuidade do processo.

----

===== 🐞 Correções =====

**12. BEES-2492: [Correção] - Reprocessamento de Notas com Status "Pendente de Conferência"**

=== SITUAÇÃO/REQUISITO ===

Ao reprocessar notas fiscais com status *Pendente de Conferência* via ERP, o BeeStock não eliminava os movimentos antigos no depósito CNF, gerando saldos duplicados.  
Esse comportamento causava inconsistência entre os depósitos WMS e ERP e comprometia a confiabilidade dos saldos.

=== SOLUÇÃO ===

Foi ajustada a rotina do RE1001 para eliminar os movimentos anteriores vinculados à nota no depósito CNF ao reprocessar documentos nesse status.  
Agora o saldo antigo é zerado e apenas o novo movimento é registrado, evitando duplicidade de linhas no monitor de integração.

----

**13. BEES-2540: [Correção] - Relatório "Documento de Saída - Produtos - Range"**

=== SITUAÇÃO/REQUISITO ===

O relatório "Documento de Saída - Produtos - Range" não apresentava consistência com os dados do painel de expedição.  
Em determinados dias eram exibidas quantidades muito acima ou abaixo do real — por exemplo, em 15/02/2025 o painel indicava 6 linhas, mas o relatório trouxe 173.  
Essa diferença prejudicava a confiabilidade do relatório utilizado para controle das separações diárias.

=== SOLUÇÃO ===

Foi revisada a lógica de extração de dados do relatório, garantindo a exibição de todas as linhas corretamente e de forma alinhada com o painel de expedição.  
Agora o relatório apresenta exatamente a mesma quantidade de linhas separadas registradas no dashboard.

----

**14. BEES-2508: [Correção] - Monitor de Inventário Não Exibia Decimais**

=== SITUAÇÃO/REQUISITO ===

Durante a execução de inventários, os valores decimais informados na contagem apareciam corretos nas telas de *Atualizar Ficha de Inventário*, mas não eram exibidos no Monitor de Inventário.  
Essa falha comprometia a validação e dificultava a análise de divergências.

=== SOLUÇÃO ===

Foi ajustada a tela de Monitor de Inventário para exibir corretamente os valores decimais conforme registrados nas contagens.  
Com isso, a precisão dos números ficou padronizada em todas as telas relacionadas ao inventário.

----

**15. BEES-2509: [Correção] - Tela de Vinculação de Impressoras**

=== SITUAÇÃO/REQUISITO ===

Na tela de Administração > Usuários, ao acessar a vinculação de impressoras, foram identificados dois problemas:  
- O campo *Usuário* aparecia como "undefined".  
- A contagem de registros e páginas era exibida de forma incorreta, mostrando valores muito acima da realidade.  

=== SOLUÇÃO ===

Foi corrigida a exibição do campo *Usuário*, que agora apresenta corretamente o nome selecionado.  
A lógica de contagem de registros e páginas também foi ajustada, exibindo apenas os dados reais de impressoras disponíveis.

----

**16. BEES-2559: [Correção] - Relatório "Produtos Pendentes para Alocação"**

=== SITUAÇÃO/REQUISITO ===

Ao tentar gerar o relatório de Produtos Pendentes para Alocação sem filtros, o sistema retornava erro *Relatório - Erro desconhecido*.  
Quando filtros eram aplicados, o relatório até era gerado, mas sem trazer informações.  
Essa falha comprometia o acompanhamento das pendências de alocação.

=== SOLUÇÃO ===

Foi corrigida a lógica de filtros do relatório.  
Agora o relatório pode ser gerado mesmo sem aplicação de filtros e retorna corretamente os dados compatíveis com os produtos pendentes de alocação.

----

**17. BEES-2593: [Correção] - Etiqueta de Retenção Não Respeitava o Fator**

=== SITUAÇÃO/REQUISITO ===

Nos testes em homologação, foi identificado que a funcionalidade de etiqueta de retenção não respeitava o fator parametrizado.  
Mesmo alterando o valor, a etiqueta sempre era impressa com quantidade fixa (ex.: 6 unidades), ignorando o parâmetro configurado.

=== SOLUÇÃO ===

Foi corrigida a lógica de geração da etiqueta para respeitar o valor do campo *Fator de Retenção*.  
Agora a impressão reflete corretamente o saldo de acordo com o fator parametrizado.

----

**18. BEES-2483: [Correção] - Transferência de Endereços - Travamento no Coletor**

=== SITUAÇÃO/REQUISITO ===

Ao informar um agrupador inválido na Transferência de Endereços, o sistema encerrava o aplicativo no coletor, forçando o usuário a realizar login novamente.  
Esse problema ocorria em filiais configuradas com etiqueta seriada por depósito e impactava diretamente a operação logística.

=== SOLUÇÃO ===

Foi implementada uma validação preventiva no agrupador.  
Agora, ao informar um código inexistente ou inválido, o sistema exibe mensagem de erro sem encerrar o aplicativo.  
O fluxo interno foi corrigido para manter a estabilidade do Bee Mobile e impedir travamentos ou logouts forçados.

----

**19. BEES-2580: [Correção] - Campo "Rua" em Transportadoras**

=== SITUAÇÃO/REQUISITO ===

Apesar de o campo *street* ser recebido e gravado corretamente no banco (tabela bee_carriers), a tela de *Cadastros > Gerais > Transportadoras* não exibia o valor na visualização de detalhes.  
Isso dificultava a conferência das informações de cadastro.

=== SOLUÇÃO ===

Foi ajustado o front-end da tela de Detalhes da Transportadora para exibir corretamente o valor do campo *Rua*, obtido da tabela bee_carriers.  
Agora as informações cadastrais ficam completas e consistentes.

----

**20. BEES-2584: [Correção] - Movimentação Incorreta Após Conferência de Produtos Fracionados**

=== SITUAÇÃO/REQUISITO ===

Durante testes com documentos de entrada contendo produtos fracionados em várias linhas, o sistema enviava movimentação com quantidade 0,000 para o depósito DVE.  
Esse comportamento fazia com que o último item ficasse com status *Armazenado Parcial*, impedindo a finalização correta do documento.

=== SOLUÇÃO ===

Foi corrigida a lógica de movimentação para não gerar linhas com quantidade zero no depósito DVE.  
Agora os itens fracionados são armazenados corretamente e o documento pode ser finalizado sem inconsistências.

----

**21. BEES-2608: [Correção] - Inventário - Data de Validade incorreta **

=== SITUAÇÃO ===

Durante o inventário, a linha do produto no coletor exibia a data atual em vez da data de validade real do produto, causando confusão e risco de erro.
No monitor, a validade estava correta, confirmando que o problema ocorria apenas na linha exibida no coletor.

=== SOLUÇÃO ===

Foi ajustado o label da tela de inventário para trazer a data de validade correta do produto, garantindo consistência entre coletor e monitor.

----

**22. BEES-2615: [Correção] - Apontamento de Horas - Divergência de 3 horas**

=== SITUAÇÃO ===

Ao registrar apontamento em turno com horário ampliado, o sistema salvava 3 horas a mais do que o horário real, causando inconsistência.
Exemplo: teste feito às 10:09 foi registrado como 13:09 no banco.

=== SOLUÇÃO ===

Foi corrigida a gravação para refletir exatamente o horário do apontamento, eliminando a diferença de 3 horas.

----

**23. BEES-2618: [Correção] - Dashboard Expedição (Visão por Status) - Datas incorretas**

=== SITUAÇÃO ===

No dashboard de expedição (Visão por Status), os indicadores de data de conferência estavam incorretos.  
Ex.: documento conferido em 24/07 aparecia como conferido em 23/07.

=== SOLUÇÃO ===

Corrigido a atualização do dashboard para refletir **a data real da conferência**, sem inconsistências.

----

**24. BEES-2619: [Correção] - Exclusão de Turno - Mensagem de erro não exibida**

=== SITUAÇÃO ===

Ao tentar excluir um turno vinculado a usuário, o sistema não exibia a mensagem de erro em tela.  
O motivo só aparecia ao inspecionar a tela.

=== SOLUÇÃO ===

Feito o ajuste para corrigir corretamente a mensagem: **“Turno vinculado a um usuário”**, informando o impedimento ao usuário.

----

**25. BEES-2625: [Correção] - Cadastro de Filial - Validações indevidas**

=== SITUAÇÃO ===

Na criação/edição/cópia de filial, os campos opcionais “Farol Amarelo”, “Farol Verde” e “Qtd. Máxima de Ressuprimentos por Usuário” estavam bloqueando a ação.  
Além disso, o campo permitia inserir valores não numéricos, mas não permitia salvar.

=== SOLUÇÃO ===

Feito a correção para permitir criar/copiar/editar filial mesmo sem preencher esses campos e também para validar corretamente para aceitar apenas números no campo de quantidade.

----

**26. BEES-2634: [Correção] - Conferência de Saída - Campo Lote não exibido no coletor**

=== SITUAÇÃO ===

Na conferência de saída via Web o lote era exibido corretamente, mas no coletor não.  
Essa divergência compromete a rastreabilidade.

=== SOLUÇÃO ===

Ajustado para exibir o campo **Lote** também no coletor, apenas para produtos controlados por lote, igual ao Web.  
O campo deve será somente leitura.

----

**27. BEES-2635: [Correção] - Transferência por Onda - Item não transferido no coletor**

=== SITUAÇÃO ===

Ao transferir um item em duas linhas diferentes, o coletor permitia apenas a primeira linha.  
Na segunda, retornava erro dizendo que o item já havia sido transferido.  
Somente era possível concluir via Web.

=== SOLUÇÃO ===

Ajustado a lógica de validação para permitir a transferência de todas as linhas pendentes do mesmo item no coletor.

----

**28. BEES-2643: [Correção] - Criação de Transferência com UZ não impressa**

=== SITUAÇÃO ===

Foi possível criar documento de transferência por onda utilizando uma etiqueta de unitizador não impressa.  
O sistema avisava que a UZ era inválida, mas permitia continuar.

=== SOLUÇÃO ===

Feito a correção para impedir a criação de documento de transferência por onda com UZ não impressa.

----

**29. BEES-2646: [Correção] - Inventário - Quantidade negativa com saldo alocado**

=== SITUAÇÃO ===

Ao inventariar endereço com saldo alocado e informar quantidade física menor, a liberação da ficha causava saldo negativo, impossibilitando separação posterior.

=== SOLUÇÃO ===

Feito o ajuste para travar a liberação de fichas de inventário em endereços com saldo alocado.  
Apenas o inventário deve ser permitido, mas a liberação não.

----

**30. BEES-2649: [Correção] - Conferência às Cegas no coletor**

=== SITUAÇÃO ===

Mesmo com o parâmetro ativado, o coletor exibia as quantidades a serem conferidas na saída, contrariando a regra de conferência às cegas.

=== SOLUÇÃO ===

Ajustado para que, quando o parâmetro estiver ativo, as quantidades **não sejam exibidas no coletor**.

----

**31. BEES-2650: [Correção] - Conferência de Entrada - Validação por linha**

=== SITUAÇÃO ===

Na conferência de entrada, o sistema validava apenas a quantidade da primeira linha, e não o total do item.  
Ex.: item 1008020 em 2 linhas (6 e 24), ao conferir 30 unidades o sistema retornava erro.

=== SOLUÇÃO ===

Ajustado a conferência para validar pelo **total do item somado em todas as linhas**, permitindo concluir o processo corretamente.

----

**32. BEES-2665: [Correção] - Impressão de Etiquetas Vale no coletor**

=== SITUAÇÃO ===

Após atualização, etiquetas de volume impressas via coletor para Vale saíam sem razão social e com QR Code inválido.  
Via Web, a impressão saía correta.

=== SOLUÇÃO ===

Corrigido impressão via coletor para que razão social e chave da NF-e sejam exibidas corretamente, igual à Web.

----

**33. BEES-2666: [Correção] - Monitor Expedição - Quantidade separada zero após divergência**

=== SITUAÇÃO ===

Os itens tratados em divergência continuavam com campo SEPARADO = 0, mesmo após informar saldo e concluir conferência.

=== SOLUÇÃO  ===

Garantido que, após tratativa de divergência, o campo SEPARADO seja atualizado com a quantidade real encontrada.

----

**34. BEES-2678: [Correção] - Dashboard Recebimento (Status por Documento)**

=== SITUAÇÃO ===

No dashboard de recebimento, documentos já cancelados ou não conferidos eram contabilizados como linhas conferidas.  
Datas também apareciam incorretas.

=== SOLUÇÃO ===

Ajustado a atualização do dashboard para refletir **apenas dados reais e atualizados** do recebimento, conferência e armazenamento.

----

**35. BEES-2681: [Correção] - Dashboard Expedição - Caracteres inválidos**

=== SITUAÇÃO ===

No dashboard de expedição (Visão Geral), estavam sendo exibidos caracteres inválidos antes do valor faturado.

=== SOLUÇÃO ===

Ajustado a exibição para que os valores sejam mostrados sem caracteres inválidos.

----

**36. BEES-2696: [Correção] - Campo carrierCode não reconhece caracteres especiais**

=== SITUAÇÃO ===

Quando o campo carrierCode recebia valor com caracteres especiais (ex.: "."), o WMS armazenava o dado mas não aplicava as regras configuradas.  
Regras funcionavam apenas com valores alfanuméricos.

=== SOLUÇÃO ===

Permitido que o configurador reconheça carrierCode com caracteres especiais.  
Se houver regra cadastrada com ".", ela deve ser aplicada normalmente.

----