Release Notes

Changelog

Propriedades de Loja

  • Data de publicação: 23 de Janeiro de 2026
  • Versão necessária: Disponibilizado na versão GA (RUB 26 - General Availability)

Objetivo

Disponibilizar no RUB a funcionalidade de Propriedades de Loja, permitindo o cadastro, edição e exclusão de propriedades associadas a uma loja específica, bem como a utilização dessas informações como dados complementares da entidade Loja, garantindo maior consistência, padronização e flexibilidade no uso dessas informações.

Contexto do Problema / Demanda

Antes desta evolução, não existia no cadastro de lojas um mecanismo padronizado que permitisse:

  • Associar propriedades específicas diretamente a uma loja;
  • Centralizar informações complementares relevantes para a operação;
  • Utilizar esses dados em outros processos do sistema de forma estruturada.

Dessa forma, tornou-se necessário habilitar um mecanismo nativo que permitisse criar propriedades para a entidade Loja e, posteriormente, associá-las a uma loja específica dentro do programa de Lojas.

Solução Implementada

Foi incorporado o uso de Propriedades de Loja como um mecanismo de informações complementares, com comportamento semelhante ao conceito técnico de Propriedade Extra / Campo Extra já existente no RUB.


Assim como em outros módulos do sistema, essas propriedades permitem enriquecer o cadastro com dados adicionais sem alterar a estrutura base do sistema.


No contexto de Lojas, o funcionamento ocorre em duas etapas distintas:

  1. Cadastro da Propriedade no programa existente Propriedades, definindo a Entidade = Loja e suas características.
  2. Associação da Propriedade à Loja no programa Lojas, informando o valor correspondente.

Importante: o tipo de dado do valor informado na loja deve respeitar o tipo configurado na propriedade (por exemplo: Texto, Inteiro, Decimal, etc.).
No programa de Lojas, são exibidas apenas as propriedades previamente cadastradas para a entidade Loja.

Configuração Prévia da Propriedade (Passo 1)

Antes de associar uma propriedade a uma loja, é necessário que ela exista no catálogo do sistema.


No programa Propriedades, o usuário administrador:

  • Clica em Adicionar;
  • Seleciona a Entidade = Loja;
  • Informa o identificador da Propriedade e sua Descrição;
  • Define o Tipo da propriedade, conforme os tipos disponíveis no sistema;
  • Salva o cadastro, tornando a propriedade disponível para uso no programa Lojas.

Pré-requisitos

  • Usuário com permissão de acesso ao módulo Lojas;
  • Permissão para acessar e gerenciar o programa Propriedades;
  • Permissão para gerenciar Propriedades de Loja no programa Lojas;
  • Propriedade previamente cadastrada para a entidade Loja;
  • Loja previamente cadastrada no RUB.

Atualização das Propriedades

Os valores das Propriedades de Loja são atualizados conforme o envio ou manutenção do valor do atributo associado à entidade Loja.

Essa atualização pode ocorrer por diferentes meios, de acordo com a arquitetura e necessidade de cada operação, como:

  • Processos externos;
  • Integrações;
  • Rotinas internas do sistema;
  • Atualizações diretas do valor do atributo.

O RUB apenas consome e exibe o valor informado, mantendo um comportamento genérico e desacoplado da funcionalidade.

Gestão de Propriedades da Loja (Passo 2)

Acesso

Lojas → Selecionar Loja → Aba Propriedades

Funcionalidades disponíveis

  • Editar Propriedade
  • Excluir Propriedade

Fluxo de uso (associar propriedade à loja)

  1. Selecionar uma Loja.
  2. Acessar a aba Propriedades.
  3. Clicar em Adicionar Propriedade.
  4. O sistema exibe apenas propriedades cadastradas para a entidade Loja.
  5. Selecionar a propriedade desejada e informar o Valor, conforme o Tipo configurado.
  6. Salvar para registrar a associação da propriedade à loja.

Campos exibidos

  • Propriedade
  • Descrição
  • Tipo
  • Valor


Regras de Negócio

  • Apenas propriedades da entidade Loja são exibidas para seleção;
  • O valor informado deve respeitar o tipo definido na propriedade;
  • Não é permitido selecionar propriedades de outras entidades;
  • As propriedades não alteram regras de negócio existentes;
  • As alterações são persistidas imediatamente;
  • A exclusão de uma propriedade remove apenas o vínculo com a loja, sem afetar o cadastro global da propriedade.

Utilização em Outros Fluxos do Sistema

As Propriedades de Loja podem ser utilizadas em diferentes fluxos do RUB, conforme a necessidade da operação.


Por exemplo, ao vincular uma loja a outros cadastros ou processos, o sistema pode:

  • Ler automaticamente as propriedades configuradas;
  • Utilizar essas informações para complementar regras, validações ou exibições;
  • Garantir maior flexibilidade sem necessidade de novas customizações estruturais.

Benefícios

  • Flexibilidade para adicionar informações complementares às lojas;
  • Padronização por meio de catálogo de propriedades por entidade;
  • Redução de customizações estruturais ou de banco de dados;
  • Reaproveitamento do mecanismo em diferentes cenários;
  • Maior rastreabilidade e organização das informações da loja.