====== 🚀 Release Notes v1.32.0 - 30/06/2026 ======

----

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

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

----

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

**01. BEES-3573: [Integração] – API de Consulta de Documentos de Saída**

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

Não existia um recurso para que sistemas externos consultassem os Documentos de Saída já integrados ao WMS BeeStock.
Essa limitação dificultava o acompanhamento do status operacional dos pedidos e a obtenção das informações dos produtos vinculados por meio de integrações.

=== SOLUÇÃO ===

Criado um novo **endpoint de consulta de Documentos de Saída**, permitindo que sistemas externos obtenham os principais dados do pedido, seu status operacional e as informações dos produtos vinculados de forma integrada e padronizada.

----

**02. BEES-3574: [Integração] – API de Consulta de Documentos de Entrada**

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

Não existia um recurso para que sistemas externos consultassem os Documentos de Entrada integrados ao WMS BeeStock.
Essa limitação dificultava o acompanhamento do status operacional dos recebimentos e a obtenção das informações dos produtos vinculados por meio de integrações.

=== SOLUÇÃO ===

**Criado um novo endpoint de consulta de Documentos de Entrada**, permitindo que sistemas externos obtenham os principais dados do documento, seu status operacional e as informações dos produtos vinculados de forma integrada e padronizada.

----

**03. BEES-3675: [Integração] – API de Estorno de Implantação de Saldo**

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

NO WMS BeeStock não disponibilizava um recurso para realizar o estorno de implantações de saldo já integradas ao sistema.
Essa limitação dificultava a reversão de implantações realizadas de forma incorreta, exigindo intervenções manuais para correção dos saldos de estoque.

=== SOLUÇÃO ===

Criada uma API de Estorno de Implantação de Saldo, permitindo realizar a reversão da implantação utilizando o movementId retornado na integração original, garantindo um processo seguro, rastreável e integrado para correção dos saldos.

----

**04. BEES-3513: [Nova Funcionalidade] – Geração de Romaneio de Carga por Documento**

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

O WMS BeeStock não permitia a geração manual de Romaneios de Carga, limitando a emissão do romaneio ao fluxo padrão do sistema. Essa restrição dificultava cenários em que era necessário consolidar manualmente documentos já separados, conferidos e faturados em um único romaneio para impressão em PDF.

=== SOLUÇÃO ===

Implementada a funcionalidade de Geração Manual de Romaneio de Carga, incluindo:

Criação do parâmetro "Gera Romaneio Manual" no cadastro de Tipos de Documento;
Nova tela para geração manual de romaneios, exibindo apenas os documentos com o parâmetro habilitado;
Desativação do controle de Doca para os tipos de documento que utilizarem a geração manual de romaneio.
----

**05. BEES-3584: [Nova Funcionalidade] – Distribuição Automática de Pedidos na Separação por Documento**

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

Na rotina de Separação por Documento no Coletor do WMS BeeStock, os operadores podiam selecionar manualmente quais documentos desejavam separar. Esse comportamento permitia a priorização de pedidos menores ou mais simples, deixando de atender a ordem operacional esperada e impactando a produtividade e o cumprimento das prioridades logísticas.

=== SOLUÇÃO ===

Criado o parâmetro "Permite distribuição automática dos pedidos" no cadastro de Tipos de Documento. Quando habilitado, o sistema passa a distribuir automaticamente os Documentos de Saída com status Pendente Separação para os usuários, eliminando a escolha manual dos pedidos e garantindo uma distribuição mais organizada e alinhada às regras operacionais.

----

**06. BEES-3577: [Melhoria] – Correção da Validação de Datas de Lote na Conferência de Documentos de Entrada**

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

Problema


Ao conferir um documento de entrada e informar uma data de validade inválida, o sistema permite o usuário salvar a conferência do lote com a data inválida e o campo fica com o valor “Invalid date”, também é possível informar uma data de fabricação posterior ao dia atual, após confirmar e salvar a conferência do lote, o sistema atualmente permite salvar o lote, porém ao tentar conferir o documento a validação da data de validade é exibida impedindo o usuário de finalizar a conferência.

=== SOLUÇÃO ===

Ajustada a validação das datas de fabricação e validade durante a leitura do QR Code, impedindo o salvamento de informações inválidas já no momento da conferência do lote e garantindo maior consistência e integridade dos dados registrados.

----

**07. BEES-3579: [Melhoria] – Inclusão de Colunas no Saldo Estoque**

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

As telas de Saldo Estoque e Saldo Estoque – Detalhes não apresentavam informações complementares sobre os endereços de armazenagem, como status de bloqueio, tipo de endereço e range. Essa limitação dificultava a análise operacional, obrigando o usuário a acessar outras telas para identificar as condições do local onde o produto estava armazenado.

=== SOLUÇÃO ===

Incluídas as colunas Endereço Bloqueado, Tipo de Endereço e Range nas telas Saldo Estoque e Saldo Estoque – Detalhes. Além disso, foi implementado um destaque na cor laranja para identificar visualmente os registros localizados em endereços bloqueados, facilitando a análise e a tomada de decisão operacional.

----

**08. BEES-3582: [Melhoria] – Campo Código Complementar nas telas de Expedição e Recebimento**

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

As telas operacionais de movimentação do WMS BeeStock não exibiam o Código Complementar dos produtos nas consultas e operações. Essa limitação dificultava a identificação dos itens em cenários onde o código complementar é utilizado como informação de apoio ao processo operacional.

=== SOLUÇÃO ===

Incluída a coluna Código Complementar nas telas Documento de Saída, Monitor de Expedição e Monitor de Recebimento. O novo campo também foi disponibilizado no Gerenciador de Colunas, permitindo que cada usuário personalize sua visualização conforme a necessidade operacional.

----

**09. BEES-3583: [Melhoria] – Adição da função " Gerenciar Colunas " na tela de Recebimento**

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

A tela Monitor de Recebimento não possuía a funcionalidade de Gerenciar Colunas, recurso já disponível em outras telas operacionais do WMS BeeStock. Essa limitação impedia que os usuários personalizassem a visualização das informações conforme suas necessidades, reduzindo a flexibilidade e a usabilidade da rotina.


=== SOLUÇÃO ===

Adicionada a funcionalidade Gerenciar Colunas na tela Monitor de Recebimento, permitindo que os usuários configurem quais colunas serão exibidas na grid, tornando a consulta mais flexível e adequada às necessidades operacionais.
----

**10. BEES-3595: [Melhoria] – Padronizar mensagem de erro de QR Code**

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

Foi identificado um comportamento inconsistente nas mensagens exibidas ao usuário quando um QR Code não era localizado durante as rotinas de Transferência de Estoque. A mensagem apresentada não seguia o padrão utilizado pelo sistema, podendo gerar dúvidas durante a operação.

=== SOLUÇÃO ===

Padronizada a mensagem de erro exibida quando o produto não é encontrado por meio da leitura do QR Code nas rotinas de transferência de estoque, garantindo maior clareza e consistência na comunicação com o usuário.

----

**11. BEES-3619: [Melhoria] – Adicionar Variável Bairro na Etiqueta de Volume**

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

As etiquetas personalizadas nos formatos ZPL e DPL não disponibilizavam a informação de Bairro como variável de impressão. Essa limitação restringia a criação de layouts personalizados que atendessem às necessidades operacionais dos clientes.

=== SOLUÇÃO ===

Disponibilizada a nova variável Bairro para utilização nas etiquetas personalizadas ZPL e DPL, permitindo que essa informação seja incorporada aos modelos de impressão conforme a necessidade de cada operação.
----

**12. BEES-3623: [Melhoria] – Ajuste no Cálculo de Peso para Geração de Romaneio**

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

O processo de geração do Romaneio de Carga aplicava automaticamente a conversão do peso de gramas para quilogramas, atendendo a uma necessidade específica de um cliente. No entanto, essa regra era aplicada para todas as operações, gerando divergências na apresentação do peso para clientes que utilizam unidades de medida diferentes.

=== SOLUÇÃO ===

Implementado um novo parâmetro de configuração para controlar a conversão automática do peso de gramas para quilogramas na geração do Romaneio de Carga, permitindo adequar o comportamento do sistema às necessidades de cada operação.

----

**13. BEES-3626: [Melhoria] – Ajuste na Regra de Alocação de Lotes Sugeridos na Integração de Documentos de Saída**

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

Durante a alocação de produtos com lote sugerido, quando o lote indicado estava armazenado em um endereço bloqueado, o sistema desconsiderava a sugestão e realizava a alocação utilizando outro lote disponível. Esse comportamento comprometia o cumprimento das regras de rastreabilidade e da estratégia de separação definida para o documento.

=== SOLUÇÃO ===

Ajustada a lógica de alocação para que o sistema respeite o lote sugerido sempre que houver saldo disponível, independentemente de o endereço estar bloqueado, garantindo a correta utilização do lote definido e maior aderência às regras operacionais.

----

**14. BEES-3628: [Melhoria] – Controle de Envio do ConfirmPicking em Devoluções de Picking**

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

Na integração de Devolução de Picking entre o WMS BeeStock e o ERP, o sistema realizava o envio de dois JSONs após a devolução de itens já confirmados na separação: Confirma Separação e Confirma Devolução. Para determinadas operações, esse comportamento gerava integrações desnecessárias, sendo necessário enviar apenas a confirmação da devolução.

=== SOLUÇÃO ===

Criado o parâmetro resendConfirmPickingOnReturnPicking na tabela bee_settings, permitindo controlar o reenvio da integração de Confirma Separação após a Confirma Devolução. Por padrão, o parâmetro é inicializado com o valor 0, fazendo com que apenas a integração de Confirma Devolução seja enviada, evitando reenvios desnecessários ao ERP..
----

**15. BEES-3687: [Melhoria] Inclusão da Natureza de Operação e Chave de Acesso na Integração de Confirmação de Recebimento**

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

Na integração de Confirmação de Recebimento entre o WMS BeeStock e o ERP, eram enviadas apenas as informações de série, número do documento e emitente para identificação da nota fiscal. Em cenários onde existiam documentos com a mesma combinação desses dados, diferenciando-se apenas pela Natureza de Operação, o ERP não conseguia identificar corretamente o documento, gerando ambiguidades e riscos durante o processo de armazenamento.

=== SOLUÇÃO ===

Adequada a integração de Confirmação de Recebimento para incluir os campos Natureza de Operação e Chave de Acesso da Nota Fiscal no JSON enviado ao ERP. Com essas informações adicionais, o sistema passa a identificar corretamente o documento fiscal mesmo quando existirem notas com o mesmo número, série e emitente, mantendo a compatibilidade com os processos de integração já existentes.

----

**16. BEES-3661: [Melhoria] – Ajuste de Exibição da Coluna Código Complementar**

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

A coluna Código Complementar estava sendo exibida incorretamente na tabela de Lotes, quando deveria aparecer na tabela de Produtos. Além disso, o campo não estava disponível no Gerenciador de Colunas, impedindo que os usuários personalizassem sua visualização..

=== SOLUÇÃO ===

Foi realizada a correção removendo a coluna Código Complementar da tabela de Lotes e adicionando-a na tabela de Produtos. O campo também foi incluído no Gerenciador de Colunas, permitindo que os usuários configurem sua exibição conforme suas necessidades operacionais.

----

===== Correção =====

**17. BEES-3587: [Correção] – Falha na validação de QR Code ao realizar transferência de endereço com lote em minúsculo**

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

Ao realizar a transferência de endereço utilizando produtos com lote em letras minúsculas, o sistema não consegue validar ou processar o QR Code informado, devido a uma conversão automática inadequada do texto para caixa alta.


=== SOLUÇÃO ===

Removida a conversão automática para letras maiúsculas nos campos de Código de Barras e Lote, garantindo o suporte a case sensitivity e permitindo que o sistema diferencie e valide corretamente os lotes contendo letras minúsculas e maiúsculas.

----

**18. BEES-3603: [Correção] – Correção de Duplicidade na Efetivação da Devolução de Picking**

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

Na versão 1.31.1, ao realizar uma Devolução de Picking, o uso da tecla ENTER nos campos do formulário dispara a efetivação da operação. Caso o usuário pressione a tecla repetidamente ou o sistema sofra lentidão, a operação é executada mais de uma vez, gerando duplicidade indesejada na movimentação de estoque.

=== SOLUÇÃO ===

Implementada uma trava de segurança (debounce / estado de carregamento) na função onPressEfetivar. Agora, o sistema bloqueia novas chamadas ou disparos pelo teclado enquanto um processamento de devolução de picking já estiver em andamento, impedindo a geração de movimentações duplicadas.

----

**19. BEES-3610: [Correção] – Erros na tela "Alterar Alocação" do coletor**

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

A coluna "Tipo de Documento" estava sendo exibida de forma incompleta na interface. Além disso, ao entrar na tela e retornar (clicando no botão de voltar) sem inserir um código de barras ou informando um código inexistente, o sistema disparava uma requisição indevida, gerando um erro de processamento.

=== SOLUÇÃO ===

Ajustado o tamanho do cabeçalho da tabela para acomodar e exibir corretamente todas as colunas, incluindo o "Tipo de Documento". Também foi tratada a lógica do botão de 
voltar da tela, impedindo que a requisição de validação seja executada quando o usuário opta por sair da tela.

----

**20. BEES-3611: [Correção] – Múltiplas vínculos da mesma impressora**

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

No modal "Vincular Impressoras", o sistema permitia múltiplos cliques rápidos no botão de confirmação antes do término do processamento. Como consequência, a mesma impressora era vinculada repetidamente ao perfil do usuário, gerando redundância e inconsistência nos registros.

=== SOLUÇÃO ===

O botão "Vincular" agora é automaticamente desabilitado logo após o primeiro clique. Ele permanece inativo durante todo o processamento, sendo reativado ou fechado apenas após o sistema concluir o vínculo da impressora com sucesso, eliminando o risco de duplicidade.

----

**21. BEES-3612: [Correção] – Atualização do Usuário de Alteração no Bloqueio de Endereço**

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

Ao realizar o bloqueio de um endereço no sistema, o campo que registra o usuário responsável pela última alteração não estava sendo atualizado. Isso gerava uma falha na auditoria dos dados, pois não era possível identificar qual operador havia executado a ação de bloqueio.

=== SOLUÇÃO ===

Corrigida a lógica de persistência para que, ao efetuar o bloqueio de um endereço, o sistema capture e atualize corretamente a informação do usuário que realizou a alteração, garantindo o histórico e a rastreabilidade do processo.

----


**22. BEES-3613: [Correção] – Alocação negativa ao desalocar saldo com múltiplos usuários**

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

O sistema permitia a desalocação duplicada de um mesmo documento ou produto quando a ação era executada simultaneamente através de diferentes abas ou por múltiplos usuários ao mesmo tempo. A falta de uma validação concorrente concorria para falhas na integridade do saldo, pois o sistema processava a desalocação sem checar o estado atualizado do registro em tempo real.


=== SOLUÇÃO ===

Implementada uma validação de segurança que identifica e verifica se ainda existe saldo disponível para desalocação imediatamente antes de prosseguir com a transação. Caso a desalocação já tenha sido efetuada em outra sessão, o processo concorrente é barrado, garantindo a consistência dos dados do estoque.

----

**23. BEES-3616: [Correção] – Correção de Limitação de Registros no Relatório de Documentos de Entrada**

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

Ao gerar o relatório de "Documento de Entrada - Produtos" utilizando um intervalo (range) de datas mais amplo, alguns registros que deveriam constar no resultado não eram listados. Essa falha ocorria porque a consulta possuía um limite máximo de linhas (limit), fazendo com que dados válidos fossem ocultados e gerando divergências nas informações apresentadas ao usuário.

=== SOLUÇÃO ===

Ajustada a query de busca do relatório para remover a aplicação do limite (limit) sobre os registros retornados. Com essa modificação, o sistema garante que todos os dados correspondentes ao período selecionado sejam processados e exibidos, eliminando qualquer tipo de omissão ou divergência no relatório, independentemente do tamanho do intervalo de datas.

----

**24. BEES-3629: [Correção] – Correção da Paginação na Aba de Endereços Vinculados do Cadastro de Range**

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

Na aba de Endereços Vinculados dentro do cadastro de Range, os usuários enfrentavam uma falha na interface que impedia a alternância entre as páginas de resultados. Além disso, o contador do total de linhas ficava incorretamente travado (fixo), exibindo apenas o número correspondente à quantidade de linhas configurada por página, em vez do total real de registros..

=== SOLUÇÃO ===

Corrigida a lógica de paginação da aba de Endereços Vinculados, restabelecendo a navegação e a troca de páginas. O contador também foi ajustado para refletir dinamicamente a quantidade correta e total de linhas da listagem, normalizando a visualização e o gerenciamento dos dados.

----

**25. BEES-3630: [Correção] – Status da carga está sendo exibido como número no relatório do Monitor de Cargas**

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

No relatório do Monitor de Cargas, a coluna de status exibia apenas os códigos numéricos internos do banco de dados em vez de suas descrições amigáveis. Essa ausência de tradução prejudicava a leitura e a interpretação dos dados por parte dos usuários operacionais.

=== SOLUÇÃO ===

Criada e mapeada uma lista estática de traduções para os status no relatório do Monitor de Cargas. Com isso, os códigos numéricos são convertidos automaticamente em suas respectivas descrições textuais, garantindo o preenchimento claro e legível da coluna.

----


**26. BEES-3646: [Correção] – Ajuste no Envio da Integração "Confirma Separação OP" em Casos de Divergência**

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

O sistema enviava a integração de "Confirma Separação OP" imediatamente após a separação física do item, mesmo quando era registrada uma divergência na contagem. Para piorar, quando a gerência posteriormente analisava e aprovava essa divergência, nenhuma nova integração era disparada para atualizar a quantidade corrigida no sistema ERP/destino, gerando quebra de estoque e falha na comunicação entre os sistemas.

=== SOLUÇÃO ===

O gatilho de envio foi reestruturado: em cenários onde houver divergência na separação de uma Ordem de Produção (OP), a integração de "Confirma Separação OP" fica retida. Ela passa a ser enviada de forma segura apenas após a liberação/aprovação da divergência, garantindo que o destino receba diretamente a informação com as quantidades corretas e consolidadas.

----

**27. BEES-3654: [Correção] – Correção do Cálculo do Tempo Médio Total no Dashboard de Expedição**

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

No dashboard "Análise Tempos Médios" da expedição, o campo Tempo Médio Total era exibido com valores incorretos ou zerados. Essa falha ocorria porque o cálculo dependia exclusivamente dos dados de consolidação do documento; em cenários ou fluxos operacionais onde a consolidação não era utilizada, o sistema ficava sem uma referência de término para computar o tempo decorrido.

=== SOLUÇÃO ===

O cálculo do indicador foi ajustado para utilizar a data de finalização do documento como alternativa nas operações onde não há consolidação. Dessa forma, o sistema garante uma métrica retroativa confiável e exibe o Tempo Médio Total corretamente para todos os modelos de fluxo de expedição.

----

**28. BEES-3664: [Correção] – API de consulta Documentos de Saída não retorna demais sequências**

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

Ao realizar a consulta de um documento, a listagem de produtos retornada pelo sistema vinha incompleta, deixando de exibir diversos itens pertencentes àquele registro. Essa falha ocorria devido a uma inconsistência ou filtro indevido na estrutura da query SQL responsável por buscar as informações no banco de dados.

=== SOLUÇÃO ===

A query de consulta ao banco de dados foi corrigida e otimizada para garantir que o relacionamento entre as tabelas de documentos e produtos seja feito de forma integral. Com esse ajuste, o sistema agora localiza e retorna com sucesso 100% dos produtos associados ao documento consultado.

----

**29. BEES-3673: [Correção] – Otimização da Consulta de Movimentos de Estoque para Grandes Volumes de Dados**

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

A tela de Consulta de Movimentos de Estoque apresentava lentidão excessiva e, em alguns cenários, não era carregada devido ao grande volume de registros na tabela de movimentações. Esse comportamento comprometia a utilização da consulta e impactava o desempenho da operação.

=== SOLUÇÃO ===

Otimizado o processo de consulta dos Movimentos de Estoque por meio da criação de novos índices na tabela stock_movement e da reestruturação da busca em etapas, reduzindo a quantidade de dados processados em cada consulta. Também foi implementada uma regra para reutilizar a contagem de registros enquanto o período consultado não for alterado, melhorando significativamente o desempenho e a navegação entre as páginas da consulta.

----

**30. BEES-3690: [Correção] – Correção na Preservação do Parâmetro de Conversão de Peso em Atualizações**

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

Foi identificado que, ao atualizar a versão do WMS BeeStock, o parâmetro convertWeightToKg era automaticamente redefinido para o valor padrão. Esse comportamento fazia com que configurações já realizadas pelos clientes fossem perdidas após a atualização do sistema.

=== SOLUÇÃO ===

Removido o processo de atualização automática dos parâmetros durante a execução do seeder, preservando as configurações já existentes no ambiente e garantindo que o parâmetro convertWeightToKg permaneça inalterado após a atualização do BeeStock.

----

**31. BEES-3691: [Correção] – Correção no Fluxo de Divergência da Separação de Ordens de Produção**

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

Em cenários de divergência na separação de Ordens de Produção (OP), quando a divergência era aprovada e a quantidade separada era inferior à solicitada, o sistema atualizava incorretamente os status dos produtos e do documento. Além disso, a integração de Confirma Separação não era gerada, comprometendo a sincronização das informações com o ERP.

=== SOLUÇÃO ===

Ajustado o fluxo de aprovação de divergências na separação de Ordens de Produção (OP) para que os status dos produtos e documentos sejam atualizados corretamente, mesmo em separações parciais. Também foi corrigida a geração da integração de Confirma Separação, garantindo o envio adequado das informações ao ERP.

----

<WRAP center round info 30%>
**Ainda ficou com alguma dúvida? 
 \\
Nos ajude a melhorar!
 \\
{{SZ_FEEDBACK}}**

</WRAP>