beestock:releases.notes:releases.notes.beestock.2025.1.27.1 [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.
===== RELEASES NOTES 1.27.1 - SZ Soluções® 30/04/2025 =====

==== MELHORIAS ====

** 01. BEES-2081, BEES-625, BEES-2010: [Nova Funcionalidade] - Exibição de Imagens no WMS BeeStock (Web e Coletor) **

SITUAÇÃO/REQUISITO

Atualmente, no WMS BeeStock, é necessário implementar a funcionalidade de exibição de imagens em algumas rotinas do sistema. Paralelamente, está sendo desenvolvido um site (ImageHub) para armazenar essas imagens e disponibilizá-las ao BeeStock via integração. Para isso, o sistema precisa ser ajustado para exibir essas imagens nas interfaces pertinentes.

SOLUÇÃO

A funcionalidade de exibição de imagens foi incorporada à versão Web e ao Coletor de Dados. No sistema Web, dentro do cadastro de produtos, foi criada uma aba chamada “Imagem”, onde serão exibidas as imagens do item em formato de carrossel, permitindo a visualização de várias imagens organizadas por linha. Nas telas de conferência de entrada (/movement/inbound/check) e saída (/movement/outbound/check), foi adicionado um ícone de câmera ao lado do campo “Código de Barras”. Ao clicar nesse ícone, um modal é aberto exibindo as imagens do produto correspondente. Esse modal apresenta um botão para fechar e, caso não haja imagens cadastradas, é exibida a mensagem: “Nenhuma foto encontrada para este produto.” Já no Coletor de Dados, a imagem do produto será apresentada na tela de Entrada de Mercadorias, durante a Conferência AR, e na rotina de Separação por Documento na Saída de Mercadorias, ao lado do campo de código de barras. Também foi adicionada uma nova funcionalidade no menu do coletor, acessada por Consulta > Imagem Produtos, permitindo que o usuário bipar o código do produto e visualize suas imagens em carrossel. Nessa funcionalidade, é possível ampliar a imagem e navegar entre as fotos cadastradas, com opção de fechar a visualização.

ImageHub -> [[jonathan.souza@szsolucoes.com.br|Contrate aqui]]
----

** 02. BEES-2085: [Melhoria] - Geração de Etiquetas Seriada com Fator de Retenção **

SITUAÇÃO/REQUISITO

Atualmente, a geração de etiquetas seriadas não considera o campo "Fator Retenção" do código de barras cadastrado no produto.

SOLUÇÃO

Foi incluída a opção de marcação “Etiqueta Retenção” na tela de geração de etiquetas seriadas, acessada por Movimentação → Indústria → Gerar Etiquetas Seriadas, onde é necessário informar a ordem de produção. Quando essa opção é ativada, o sistema utiliza o valor do campo Fator Retenção, previamente cadastrado no código de barras do produto, para determinar automaticamente a quantidade correta de etiquetas a serem geradas com base nesse fator.

----

** 03. BEES-2106: [Melhoria] - Impressão de Etiquetas Fracionadas no Monitor de Recebimento **

SITUAÇÃO/REQUISITO

Clientes necessitam imprimir etiquetas de embalagem fracionada diretamente na tela do Monitor de Recebimento para otimização de tempo.

SOLUÇÃO

Foi criado um novo parâmetro no cadastro de Tipo de Documento, localizado na aba Recebimento, chamado “Imprimir Etiqueta de Embalagem Fracionada”. Quando esse parâmetro estiver ativado, o sistema permitirá que a impressão das etiquetas de embalagem fracionada seja feita diretamente a partir do Monitor de Recebimento, com base nos dados da Nota Fiscal recebida, facilitando a operação e reduzindo o tempo de execução.

----

** 04. BEES-2108: [Melhoria] - Ajustes na Tela de Etiqueta de Embalagem Fracionada **

SITUAÇÃO/REQUISITO

A tela de etiquetas de embalagem fracionada precisava ser ajustada para exibir a unidade de medida (UM) e a família do produto, além de permitir definir a quantidade de etiquetas e a quantidade de produtos por etiqueta.

SOLUÇÃO

Foi realizada a inclusão da unidade de medida (UM) e da família do produto diretamente na tela de etiquetas fracionadas, permitindo ao usuário visualizar essas informações ao configurar a impressão. Além disso, o sistema agora permite que o usuário informe a quantidade total de etiquetas a serem impressas e a quantidade de produtos que deverá constar em cada etiqueta, promovendo maior controle e flexibilidade na geração das etiquetas.

----

** 05. BEES-2147: [Melhoria] - Impressão de Etiquetas Fracionadas no Documento de Saída **

SITUAÇÃO/REQUISITO

Foi identificado que seria necessário permitir a impressão de etiquetas fracionadas diretamente do documento de saída.

SOLUÇÃO

A funcionalidade de impressão de etiquetas fracionadas foi estendida para os documentos de saída, utilizando o mesmo parâmetro “Imprimir Etiqueta de Embalagem Fracionada”, configurado na aba Separação do Tipo de Documento. A partir dessa configuração, o sistema permitirá que o usuário selecione o documento completo ou itens específicos para impressão. Um modal será apresentado para configurar os parâmetros de impressão, permitindo a definição da quantidade total de etiquetas e da quantidade de produtos por etiqueta. A lógica foi ajustada para calcular o número total de etiquetas com base nesses dados, garantindo uma emissão precisa e alinhada com as necessidades operacionais.

----

** 06. BEES-2105: [Melhoria] - Consulta de Saldo de Estoque Estruturada **

SITUAÇÃO/REQUISITO

Foi identificado a necessidade de desenvolvido de um novo endpoint que disponibilidade os estoques no BeeStock podendo realizar filtros por Filial, Deposito, produto e família de material. 

SOLUÇÃO

Foi desenvolvida uma nova API para consulta estruturada de saldo de estoque, permitindo maior controle e integração com sistemas externos. A consulta exige o código da filial como parâmetro obrigatório e aceita também filtros adicionais como código do produto, unidade de medida, depósito, família de material, entre outros. A resposta do endpoint retorna informações detalhadas, como o código da filial, código do produto, unidade, quantidade disponível, quantidade alocada, quantidade reservada, total de estoque, código do depósito, situação do endereço, data de validade e número do lote. Essa estrutura torna a API robusta e compatível com diversas aplicações que demandam acesso dinâmico e preciso aos dados de estoque.

----

** 07. BEES-2162: [Melhoria] - Ordenação de Colunas no Armazenamento e Conferência de Saída **

SITUAÇÃO/REQUISITO

Atualmente, no WMS BeeStock, na configuração por Tipo de Documento, as abas de Recebimento e Separação permitem definir quais campos serão exibidos no coletor durante a Conferência de Entrada e a Separação de Saída. No entanto, as telas de Armazenamento (na aba Recebimento) e Conferência de Saída (na aba Separação) não possuem essa funcionalidade.

SOLUÇÃO

Implementar a funcionalidade de ordenação de colunas para as telas de Armazenamento e Conferência de Saída, similar à já existente para Conferência de Entrada e Separação de Saída.
Adicionar duas novas opções de configuração por Tipo de Documento:

"Ordenar colunas no Armazenamento" (aba Recebimento)
"Ordenar colunas na Conferência" (aba Separação)

Listar os campos já existentes nessas telas para seleção pelo usuário.
Incluir o campo "Código Complementar" como opção disponível na configuração.
Caso nenhum campo seja configurado, manter o padrão atual de exibição, sem o campo "Código Complementar".

----

** 08. BEES-2171: [Melhoria] - Armazenamento Automático na Conferência de Entrada (Web e Coletor) **

SITUAÇÃO/REQUISITO

Atualmente, o processo de recebimento de mercadorias no WMS BeeStock exige obrigatoriamente duas etapas distintas, primeiro a Conferência e depois a Armazenagem.
A principal dor identificada reside em operações de alto volume, como a do cliente Barros. Nesses cenários, onde notas fiscais podem conter mais de 150 itens e o objetivo é mover a mercadoria rapidamente, a necessidade de executar duas etapas separadas gera gargalos.
A motivação para esta melhoria é simplificar e agilizar o processo de recebimento para cenários onde o armazenamento intermediário não é necessário, tanto para o cliente Barros, quanto para novos clientes.

SOLUÇÃO

Implementar uma nova configuração por Tipo de Documento que permita o armazenamento automático no momento da conferência.
Essa configuração deve ser respeitada tanto no Coletor (tela Conferência AR) quanto na versão Web (tela Conferência de Entrada - /movement/inbound/check).
Ao confirmar a conferência, o sistema já deverá gravar o local de armazenagem definitivo, eliminando a necessidade de etapa separada de armazenagem e uso de UZ intermediária.

----

** 09. BEES-1954: [Melhoria] - Lentidão na Geração de Etiquetas por Ordem de Produção **

SITUAÇÃO/REQUISITO

Cliente relata uma demora exagerada ao abrir a tela de geração de etiquetas de uma Ordem de Produção e também na hora de realizar a geração de etiquetas. O processo inteiro ocasiona uma demora de cerca de 2 minutos para cada ordem de produção, gerando assim um atraso significativo na produção.

SOLUÇÃO

Realizar análise de performance na rotina de geração de etiquetas de OP.
Identificar gargalos na consulta de dados ou na montagem das etiquetas e aplicar melhorias de performance.
Validar a aplicação com volumes grandes (mais de 150 itens) e garantir retorno em tempo aceitável (até 5 segundos para carregamento da tela, e até 15 segundos para geração).

----

** 10. BEES-2078: [Melhoria] - Ajuste na Exportação CSV do Relatório "Comparativo Saldo Estoque" **

SITUAÇÃO/REQUISITO

Atualmente, os valores fracionados apresentados na tela do sistema BEE utilizam vírgula como separador decimal (exemplo: "691,250"). No entanto, ao exportar o relatório "Comparativo Saldo Estoque" no formato CSV, a formatação é alterada e os valores aparecem com ponto (exemplo: "691.250").
Para solucionar esse problema, é necessário garantir que a exportação do CSV mantenha o formato de separador decimal com vírgula, de acordo com o que é exibido na interface do sistema.

SOLUÇÃO

Ajustar a lógica de exportação do relatório "Comparativo Saldo Estoque" para que os valores fracionados sejam exportados com vírgula como separador decimal.
Manter esse ajuste restrito apenas a esse relatório, sem impactar outras exportações CSV do sistema.

----

** 11. BEES-2091: [Melhoria] - Ajuste de Espaços em Branco no Login (Web e Coletor) **

SITUAÇÃO/REQUISITO

Atualmente, no WMS BeeStock, ao realizar o login via Coletor ou Web, caso o campo de Login contenha um espaço ao final, o sistema interpreta que o usuário está incorreto, impedindo o acesso. Esse comportamento pode causar dificuldades para os usuários, principalmente em situações em que o espaço seja inserido acidentalmente.

SOLUÇÃO

Ajustar a lógica de validação do login para remover espaços em branco no início e no final do valor digitado, tanto na versão Web quanto na versão Coletor.
Manter a validação atual de diferenciação entre maiúsculas e minúsculas, se aplicável.
Realizar testes para garantir que não haja impacto na segurança ou na autenticação.

----

** 12. BEES-2096: [Melhoria] - Remoção de Campos Pessoais do Cadastro de Usuário para Adequação à LGPD **

SITUAÇÃO/REQUISITO

Atualmente, no WMS BeeStock, o cadastro de usuários possui alguns campos pessoais que, por questões de conformidade com a LGPD e visando a proteção de dados, foram considerados desnecessários.
Os campos a serem removidos do cadastro de usuário são:

Celular
Ramal
Telefone
Matrícula (além da remoção, a obrigatoriedade desse campo deve ser eliminada)
Além disso, existe uma API responsável pelo cadastro automático de usuários que também precisará ser ajustada para refletir essas alterações.

SOLUÇÃO

Remover os campos "Celular", "Ramal", "Telefone" e "Matrícula" da interface de cadastro de usuário.
Tornar o campo "Matrícula" não obrigatório.
Atualizar a API POST /api/beestock/api/import/users para remover a exigência desses campos, garantindo compatibilidade com a nova estrutura.
Validar que cadastros existentes e novos não sejam impactados.
Atualizar a documentação do sistema e da API para refletir essas mudanças.

----

==== CORREÇÃO ====

** 13. BEES-2157: [Correção] – Impressão de Etiquetas de Endereço não Respeita Seleção de Impressora **

SITUAÇÃO/REQUISITO

Na funcionalidade de impressão de etiquetas de endereço, localizada em /movement/label/address, foi identificado que, ao abrir o modal “Selecionar Impressora”, mesmo listando corretamente todas as impressoras disponíveis, o sistema não mantém a seleção feita pelo usuário, retornando sempre para a primeira impressora da lista ou a impressora padrão.

SOLUÇÃO

Foi ajustado o componente de seleção do modal para manter corretamente a impressora selecionada pelo usuário. A lógica de binding foi revisada, garantindo que a impressora escolhida permaneça ativa até a execução da impressão.

----

** 14. BEES-2154: [Correção] – Inventário de Etiqueta não Altera a Data da Última Contagem **

SITUAÇÃO/REQUISITO

Foi identificado que, ao realizar um inventário de etiquetas, o sistema não atualiza os campos “Usuário Última Contagem” e “Data da Última Contagem” na tela de Saldo de Estoque, mesmo após liberar e atualizar as fichas.

SOLUÇÃO

Foi realizada a correção na rotina de atualização de inventário de etiquetas para garantir que, ao concluir o processo, os campos de rastreabilidade de última contagem sejam corretamente atualizados no estoque.

----


** 15. BEES-2121: [Correção] – Relatório de Endereços Vazios Exibe Endereços com Saldo e Erro em Personalização **

SITUAÇÃO/REQUISITO

Ao gerar o relatório de endereços vazios, o sistema estava exibindo também endereços com saldo, o que não condiz com a proposta da funcionalidade. Além disso, ao tentar gerar relatórios personalizados com seleção de colunas, o sistema apresentava erro e não completava a geração.

SOLUÇÃO

Foi ajustado o filtro principal do relatório para considerar apenas endereços realmente vazios. Também foi corrigida a rotina de geração personalizada para suportar corretamente a seleção de colunas pelo usuário sem causar erro.

----

** 16. BEES-2198: [Correção] – Erro ao Cadastrar Produto com Controle por Lote via Integração **

SITUAÇÃO/REQUISITO

Ao realizar o envio de um novo produto para o WMS BeeStock com o campo stockControlType = 3 (controle por lote), o sistema retornava { "success": false } de forma indevida. Esse comportamento era causado por uma tentativa incorreta do sistema de buscar o produto previamente na base antes do cadastro, mesmo quando o item ainda não existia.

SOLUÇÃO

Foi ajustada a lógica de integração para permitir o cadastro de novos produtos com controle por lote (stockControlType = 3), sem exigir consulta prévia. A validação foi corrigida para diferenciar corretamente entre criação e atualização de produtos.

----

** 17. BEES-2014: [Correção] – Erro e Sucesso Simultâneos ao Excluir Item na Transferência por Onda **

SITUAÇÃO/REQUISITO

Ao tentar excluir um item da Transferência por Onda na tela de Monitor de Transferência (/movement/stock/WaveTransferMonitor/edit), o sistema exibia simultaneamente mensagens de erro e sucesso, e o item não era efetivamente removido da listagem. O erro ocorria apenas na primeira tentativa de exclusão.

SOLUÇÃO

Foi corrigido o fluxo de exclusão no Monitor de Transferência para garantir que o item seja corretamente removido na primeira tentativa, exibindo apenas a mensagem de sucesso e atualizando automaticamente a tela após a exclusão.

----

** 18. BEES-2143: [Correção] – Permissão Indevida de Cancelamento de Documento Após Início da Conferência Física **

SITUAÇÃO/REQUISITO

O sistema estava permitindo o cancelamento de documentos mesmo após o início da conferência física, principalmente em situações onde o usuário mantinha múltiplas abas abertas ou não atualizava a tela do Monitor de Recebimento. Essa falha permitia ações indevidas no documento com status "Pendente Conferência Física".

SOLUÇÃO

Foi implementado um bloqueio adicional no backend para impedir o cancelamento de documentos que já tenham sido iniciados na conferência física, independentemente do estado da interface do usuário.

----

** 19. BEES-2209: [Correção] – Campo “Última Contagem” Não Atualiza na Primeira Contagem do Inventário **

SITUAÇÃO/REQUISITO

Na rotina de geração de inventário, a data e hora da “Última Contagem” não estavam sendo exibidas após a primeira contagem, sendo corretamente apresentadas apenas a partir da segunda.

SOLUÇÃO

Foi ajustado o processo de gravação da primeira contagem para garantir a atualização imediata do campo “Última Contagem” na tela de inventário, assegurando consistência desde a primeira interação.

----

** 20. BEES-2146: [Correção] – Inconsistência de Fuso Horário na Data de Entrega **

SITUAÇÃO/REQUISITO

Ao atualizar uma Nota Fiscal no RE2001, a data de entrega registrada no BeeStock apresentava inconsistências devido a problemas relacionados ao fuso horário. Os valores estavam sendo gravados como "2025-03-25 00:00:00" em vez de "2025-03-25 03:00:00", ocasionando exibição incorreta da data final, como ocorreu na NF 0005987, série 1, em que a entrega deveria ser 27/03/2025, mas era exibida como 26/03/2025.

SOLUÇÃO

Foi ajustado o tratamento de fuso horário na gravação da data de entrega no RE2001, garantindo que a data seja salva corretamente com o deslocamento de horário esperado e refletida de forma precisa no BeeStock.

----

** 21.  BEES-1835: [Correção] – Duplicidade de Informações na Tabela “Lotes” do Monitor de Recebimento **

SITUAÇÃO/REQUISITO

Na tela de Movimentação > Recebimento > Monitor de Recebimento, as linhas referentes à etiqueta agrupadora na tabela “Lotes” estavam sendo exibidas em duplicidade. Esse comportamento fazia com que a quantidade dos produtos parecesse o dobro do valor real, confundindo os usuários e comprometendo a operação.

SOLUÇÃO

Foi corrigida a lógica de exibição da tabela “Lotes” no Monitor de Recebimento, eliminando a duplicidade indevida das linhas vinculadas à etiqueta agrupadora e assegurando a apresentação correta da quantidade real dos produtos.

----

** 22.  BEES-2235: [Correção] – Sistema Permitindo Separação em Quantidade Superior ao Pedido **

SITUAÇÃO/REQUISITO

Foi identificado um cenário em que o sistema BeeStock permitiu a separação de uma quantidade superior à solicitada no pedido, resultando em divergência entre o pedido original e o total separado.

SOLUÇÃO
Foi implementada uma validação na rotina de separação para impedir que a quantidade separada ultrapasse a quantidade pedida, garantindo a integridade do processo e evitando excessos indevidos.

----

** 23. BEES-2041: [Correção] – Duplicidade na Devolução de Picking **

SITUAÇÃO/REQUISITO

Foi identificado que, na rotina de Devolução de Picking (Coletor > Entrada de Mercadorias > Devolução de Picking), ao clicar múltiplas vezes no botão "EFETIVAR", o sistema permitia a criação de devoluções duplicadas para o mesmo item. Esse problema causava divergências no estoque, com saldos incorretos e movimentações repetidas.

SOLUÇÃO

Foi implementada uma validação que impede a efetivação duplicada, mesmo quando o botão "EFETIVAR" é pressionado mais de uma vez. Além disso, o botão é desabilitado logo após o primeiro clique, garantindo que a devolução seja registrada uma única vez, mantendo o estoque consistente e sem duplicidades.

----

** 24. BEES-2080: [Correção] – Correção na Lógica de Alocação FIFO **

SITUAÇÃO/REQUISITO

Foi identificado um cenário em que a alocação de itens no processo de armazenamento não seguiu o padrão FIFO (First In, First Out). A alocação estava sendo realizada em um endereço com data de entrada mais recente, enquanto deveria priorizar o endereço com a entrada mais antiga. Esse comportamento gerava divergências operacionais e podia impactar a rastreabilidade e a gestão do estoque.

Os testes realizados confirmaram que, mesmo com os parâmetros “Aloca Saldo Total do Endereço” e “Aloca Caixa Fechada” desabilitados e sem controle de vencimento ativo, a lógica ainda não aplicava corretamente o FIFO.

SOLUÇÃO

Foi ajustada a rotina de alocação para garantir que a priorização siga o FIFO corretamente, independentemente de o item ter ou não controle de vencimento. Com essa melhoria, o sistema passa a selecionar o endereço com a data de entrada mais antiga, assegurando a integridade do processo de armazenagem e a correta rotação de estoque.

----

** 25. BEES-2095: [Correção] – Aprimoramento da Funcionalidade De-Para na Transferência por Onda **

SITUAÇÃO/REQUISITO

Foi identificado que a funcionalidade De-Para – que realiza a conversão de códigos/configurações entre depósitos – não estava sendo aplicada corretamente no processo de Transferência por Onda. Mesmo com o De-Para configurado, a integração continuava enviando o depósito original, sem realizar a conversão esperada, causando divergências no sistema de destino.

SOLUÇÃO

A lógica da rotina de Transferência por Onda foi ajustada para garantir que a funcionalidade De-Para seja aplicada corretamente durante o processo. A partir deste aprimoramento, a integração enviará o depósito convertido conforme as configurações cadastradas no De-Para, garantindo consistência nos dados transferidos e alinhamento entre os sistemas.