País e Estado (UF)

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

Objetivo

Permitir que o RUB possua um cadastro estruturado de País e Estado (UF) dentro das Configurações de Loja, possibilitando a correta vinculação das lojas a um País e à sua respectiva Unidade Federativa (UF).

Essa funcionalidade tem como objetivo padronizar o cadastro de localização das lojas e suportar operações com um ou múltiplos países, de forma nativa no sistema.

Contexto do Problema / Demanda

Anteriormente, o cadastro de localização no RUB era limitado e realizado de forma manual, sem uma estrutura clara para diferenciar países e suas respectivas Unidades Federativas (UFs).

Essa limitação dificultava:

• A padronização do cadastro de lojas;
• A expansão da operação para múltiplos países;
• O controle adequado das UFs vinculadas a cada país.

Solução Implementada

Foi implementada a funcionalidade de País e Estado (UF) dentro das Configurações de Loja, permitindo:

• O cadastro e a manutenção de Países;
• O cadastro e a manutenção de Estados (UFs), vinculados a um país específico;
• A utilização dessas informações diretamente no cadastro de lojas;
• Um comportamento dinâmico na seleção de Estados (UFs) conforme o país configurado.

Pré-requisitos

• Usuário com permissão de acesso ao módulo Lojas;
• Permissão para acessar Configurações de Loja → País / UF;
• Existência de ao menos um país cadastrado no sistema.

Cadastro de País

Acesso

Lojas → Configurações → País / UF

Funcionalidades disponíveis

• Adicionar País
• Editar País
• Excluir País (quando não estiver vinculado a nenhuma UF ou loja)

Campos

• Código do País
• Descrição

Cadastro de Estado (UF)

Acesso

Lojas → Configurações → País / UF → Aba UF

Funcionalidades disponíveis

• Adicionar UF
• Editar UF
• Excluir UF (quando não estiver vinculada a nenhuma loja)

Campos

• Código da UF
• Descrição

Utilização no Cadastro de Lojas

Ao adicionar ou editar uma loja, o sistema passa a exibir os campos País e Estado (UF), com o seguinte comportamento:

Regra 1 – País único

• Quando existir apenas um país cadastrado, o sistema:
  • Infere automaticamente o país;
  • Exibe diretamente a lista de Estados (UFs) disponíveis para seleção.

Regra 2 – Múltiplos países

• Quando existir mais de um país cadastrado, o sistema:
  • Exige a seleção do País;
  • Recarrega dinamicamente a lista de Estados (UFs) conforme o país selecionado.

Benefícios

• Padronização do cadastro de localização das lojas;
• Flexibilidade para operações em múltiplos países;
• Organização clara das Unidades Federativas (UFs) por país;
• Base estruturada para futuras regras e validações por localização;
• Facilidade de manutenção e gestão centralizada.