Release Notes

Changelog

✨ Notificação de Validade Identificada e Padrão Global no QR Code GS1


🎯 Objetivo e Visão Geral

Consolidar a leitura inteligente de produto, quantidade e validade via código GS1 no RUB, unificando no Plugin Core o feedback visual de validades regulares por nível de criticidade com a governança corporativa de configuração global:

  1. Leitura Inteligente GS1 no Fluxo Operacional: O operador lê o QR Code ou DataMatrix uma única vez e o RUB identifica o produto/embalagem (AI 01), extrai a validade (AI 17, com prioridade sobre as datas 12, 16 e 15), registra o lote (AI 10) e preenche a quantidade (AI 30 / 37).
  2. Confirmação Visual de Validade Lida sem Alerta e Notificações por Criticidade: Permite exibir uma mensagem informativa temporária quando a data lida no QR Code GS1 está fora das faixas de risco, além de enviar notificações estruturadas por criticidade (Informação, Atenção e Crítico) conforme o cliente conectado.
  3. Fallback para o Padrão Global da Empresa: Estabelece parâmetros corporativos globais de alerta de validade em Configurações Avançadas > Core > Barcode (Configurações para decodificação de Código de Barras), aplicados quando o produto não possui classe vinculada ou quando sua hierarquia de classes não tem valores definidos.

📱 1. Leitura Inteligente GS1 na Consulta e no Recebimento

O mesmo código GS1 reúne múltiplas informações e reduz a digitação manual no coletor ou na web:

Consulta de Produtos (Mobile > Consulta)

  1. Ao ler o código GS1 na tela de Consulta, o RUB identifica automaticamente o produto e interpreta todos os atributos contidos no código.
  2. A seção Código GS1 apresenta o código lido, a Validade e o Lote identificados.
Consulta no Mobile exibindo seção Código GS1 e notificação de validade identificada

Recebimento de Mercadoria (Mobile > Recebimento de Mercadoria)

  1. Após selecionar o recebimento e o lote, o operador realiza a leitura do código GS1 do produto.
  2. O sistema identifica o item, preenche a quantidade informada no código e registra automaticamente a data de validade lida no item (Saiba mais sobre o uso automático de atributos GS1 no Recebimento Mobile).
Recebimento com GS1 preenchendo quantidade e validade automaticamente

🔔 2. Alertas de Validade e Mensagem de Validade Identificada

A data de validade extraída na leitura determina automaticamente o nível da notificação apresentada ao operador:

Nível de Criticidade Condição na Leitura (QR Code GS1) Comportamento na Sessão
Crítico — Produto Vencido A data de validade já passou (anterior à data atual) Entrega obrigatória: sempre entregue à sessão mesmo quando as notificações da operação estiverem desativadas
Crítico — Limite de Dias O prazo entrou no limite crítico de dias configurado (ou "Vence hoje") Entrega obrigatória: alerta crítico imediato informando a validade e os dias restantes
Atenção — Shelf Life O produto atingiu o percentual configurado da vida útil decorrida (fora da faixa crítica de dias) Emitido quando as notificações da sessão estiverem habilitadas
Informação — Validade Identificada A validade foi reconhecida e está fora das faixas de risco (quando a opção Exibir validade lida sem alerta está ativa) Confirmação visual temporária (com tempo de exibição configurável na Web)

🚨 Crítico: Produto Vencido

Quando a data de validade lida no QR Code já expirou, o sistema emite alerta Crítico imediato (independentemente de parametrização prévia ou de desativação de notificações na sessão):

Notificação crítica de produto vencido na leitura de QR Code GS1

🚨 Crítico: Limite de Dias

Quando o prazo do produto entra na janela crítica de dias antes do vencimento, é exibida notificação Crítica destacando o produto, a validade identificada e os dias restantes:

Notificação crítica de produto próximo do vencimento pelo limite de dias

⚠️ Atenção: Shelf Life (Percentual de Vida Útil)

Quando o produto ainda não entrou na janela crítica de dias, mas atingiu o percentual configurado de vida útil decorrida, o sistema exibe uma notificação de Atenção:

Notificação de atenção quando o produto atinge o percentual de vida útil

ℹ️ Informação: Validade Identificada sem Alerta

Quando a opção Exibir validade lida sem alerta está ativa e a validade lida está fora das faixas de atenção e criticidade, o sistema apresenta a confirmação informativa "Validade <data> identificada via QR Code.":

Notificação informativa de validade identificada via QR Code sem alerta

⚙️ 3. Parâmetros, Herança por Classe e Padrão Global da Empresa

Os parâmetros definem quando alertar e como exibir a mensagem ao operador, combinando a configuração por Classe de Produto com o Padrão Global da Empresa em Configurações Avançadas (Core > Barcode):

Campos Configuráveis por Classe de Produto

No programa Classes de Produto, cada categoria pode definir seus próprios parâmetros de Alerta de validade, Dias de alerta e Percentual de vida útil, visualizando sua posição na Árvore mercadológica:

Tela de Classes de Produto com colunas Alerta de validade, Dias de alerta, Percentual de vida útil e Árvore

Padrão Global em Configurações Avançadas (Core > Barcode)

Quando o produto não possui classe vinculada ou quando um campo está sem valor definido em toda a árvore da classe, o RUB utiliza o padrão global da empresa em Configurações Avançadas > Core > Barcode (Configurações para decodificação de Código de Barras):

Tela de Configurações Avançadas do grupo Core Barcode com parâmetros de validade
Configuração Avançada (Core > Barcode) Tipo Valor Padrão Função
Exibir validade lida sem alerta Sim/Não Não Exibe mensagem informativa quando a validade lida via QR Code está fora das faixas de alerta e criticidade
Tempo de exibição da notificação de validade na web (ms) Numérico (ms) 0 (Padrão) Define a duração em milissegundos da mensagem informativa na Web (0 mantém o comportamento padrão do cliente)
Alerta de validade Sim/Não Sim Ativa ou desativa globalmente os alertas preventivos por dias e percentual quando a árvore de classes não possui valor definido
Dias de alerta de validade Inteiro Sem limite Define quantos dias antes do vencimento entram na faixa crítica por padrão global
Percentual de vida útil decorrida para alerta Percentual 0.0 (Sem limite) Define o percentual decorrido da vida útil para emitir alerta de atenção por padrão global

Regra de Precedência e Herança Independente por Campo

Cada um dos três campos de regra (Alerta de validade, Dias de alerta e Percentual de vida útil) é resolvido de forma independente, procurando o primeiro valor definido na seguinte ordem:

  1. 1º — Classe Atual do Produto: Valor configurado diretamente na classe à qual o produto pertence.
  2. 2º — Classes-Pai na Árvore Mercadológica: Primeiro ancestral na hierarquia mercadológica que possua valor definido para aquele campo específico.
  3. 3º — Padrão Global da Empresa (Configurações Avançadas > Core > Barcode): Valor padrão global configurado em Alerta de validade, Dias de alerta de validade ou Percentual de vida útil decorrida para alerta.

Exemplo Prático de Resolução Independente por Campo:

Nível na Hierarquia Alerta de Validade Dias de Alerta % de Vida Útil Origem dos Valores
Classe Filha: 2.3.1 - Refrigerante Não definido → Sim 5 dias (definido na classe) Não definido → 20% Define 5 dias, herda Sim da classe pai e 20% da classe raiz (ancestral)
Classe Pai: 2.3 - Não Alcoólico Sim (definido na classe) Não definido → 2 dias Não definido → 40% Define Sim, demais campos viriam do ancestral/global
Classe Raiz (Ancestral): 2 - Bebidas Não definido Não definido → 2 dias 20% (definido na classe) Define 20% na raiz da árvore de bebidas
Padrão Global da Empresa Não 2 dias 40% Aplicado apenas para campos sem valor em toda a árvore

Regra efetiva para produtos da classe Refrigerante: Alerta habilitado (Sim), janela crítica de 5 dias e alerta preventivo em 20% da vida útil. O valor "Não" em uma classe desativa os alertas preventivos nos descendentes até que uma classe mais específica o substitua; produtos já vencidos continuam gerando notificação Crítica em qualquer cenário.

⭐ DESTAQUE: 💡 Independência de Módulos: Todas as configurações globais de leitura de código de barras residem nativamente no Plugin Core (Configurações Avançadas > Core > Barcode), operando de forma totalmente independente dos plugins de Validade e de Recebimento. Consulte também as regras de Alerta de Validade por Categoria


📈 Principais Benefícios