Skip to Content
Plataforma AdminEntitlements

Entitlements e Feature Flags

O sistema de entitlements controla quais funcionalidades estao ativas para cada tenant. Ele combina o plano base contratado com add-ons adquiridos na Loja Opero e concessoes manuais da equipe de suporte.


Como Funciona

Cada tenant possui um conjunto de feature keys ativas. Essas chaves determinam:

  • Quais modulos aparecem no menu lateral
  • Quais endpoints da API estao disponiveis
  • Quais permissoes CASL sao efetivamente aplicadas
Plano (Basic/Professional/Enterprise) ↓ Plan Defaults (features inclusas no plano) + Add-ons da Loja (compras via Store) + Concessoes N1 (grants manuais do suporte) = Entitlements Efetivos do Tenant

Fontes de Entitlements

Cada entitlement ativo possui uma fonte que indica como foi habilitado:

FonteDescricaoQuem ativa
PLAN_DEFAULTIncluso no plano contratado. Ativado automaticamente na criacao do tenant.Sistema
STORE_PURCHASEComprado pelo tenant na Loja Opero. Vinculado a um add-on no contrato.Usuario do tenant
N1_GRANTConcedido manualmente pelo Superuser N1. Usado para trials, cortesias ou suporte.Equipe Opero

Planos e Features Padrao

O plano (Basic, Professional ou Enterprise) e definido pela equipe Opero ao criar a conta. Hoje todos os planos recebem as mesmas features padrao:

FeatureBasicProfessionalEnterprise
PMS Core (pms.core)SimSimSim
Financial Basic (financial.basic: COA/USALI, razao, AP/AR, caixa, conciliacao)SimSimSim
Dominio customizado do portal (custom_domain)SimSimSim
Moedas padrao: local + USD ou EUR (multi_currency.default)SimSimSim
Retencao de auditoria de 30 dias (audit.retention_30d)SimSimSim
Suporte da comunidade (support.community)SimSimSim

Todo o resto — gateways de pagamento (inclusive o Opero Payment), Financial Overview Services, Orcamento, Ativo Imobilizado, Intangiveis, Emprestimos, Estoque, NFS-e, API, retencao de auditoria estendida, channel manager, Operations Services e suporte pago — e add-on da Loja.

Nota: Features nao inclusas no plano podem ser adquiridas individualmente na Loja Opero.


Tipos de Cobranca

Cada feature no catalogo possui um tipo de cobranca:

TipoDescricaoExemplo
FREEInclusa gratuitamente no planoPMS Core
FLAT_MONTHLYValor fixo mensal adicionado a faturaFinancial Overview Services: US$ 49/mes
METEREDCobrado por uso (por requisicao, por GB, etc.)Armazenamento de auditoria: US$ 0,50 por GB-mes
TIEREDValor fixo mensal + cobranca por usoAPI Read/Write: US$ 149/mes + US$ 0,001 por requisicao

Visualizar Entitlements Ativos

Para ver quais features estao ativas no seu tenant:

  1. Acesse Configuracoes > Planos e Recursos
  2. A tela (somente leitura) mostra:
    • Funcionalidades ativas, com nome e descricao
    • Nivel de suporte (community, business ou enterprise)
    • Acesso a API (nenhum, somente leitura ou leitura/escrita)

Comprar Add-ons

Para ativar uma feature que nao esta no seu plano:

  1. Acesse a Loja no menu lateral (secao Configuracoes)
  2. Navegue pelo catalogo de funcionalidades
  3. Clique em “Ativar” na feature desejada
  4. Confirme — o valor sera adicionado a sua proxima fatura
  5. A feature e ativada imediatamente

A compra exige um contrato de pagamento ativo do tenant com a Opero. Sem ele, a Loja recusa a contratacao e o suporte Opero precisa criar o contrato antes.

Para cancelar um add-on:

  1. Acesse a Loja
  2. Localize o add-on ativo
  3. Clique em “Desativar”
  4. A feature sera desativada; o mes corrente ainda e cobrado e as proximas faturas deixam de incluir o add-on

Sem fidelidade: Add-ons podem ser cancelados a qualquer momento, sem multa.


Concessoes N1 (Administracao Opero)

Superusuarios N1 podem conceder ou revogar features manualmente para qualquer tenant:

AcaoEndpointDescricao
Listar entitlementsGET /api/superuser/tenants/:id/entitlementsVer features ativas de um tenant
Conceder featurePOST /api/superuser/tenants/:id/entitlementsAtivar feature com motivo
Revogar featureDELETE /api/superuser/tenants/:id/entitlements/:keyDesativar feature com motivo

O motivo (reason) da concessao ou revogacao fica gravado no proprio registro do entitlement.

Casos de uso:

  • Trial gratuito de 30 dias de uma feature premium
  • Cortesia para parceiros estrategicos
  • Ativacao emergencial durante investigacao de suporte

Impacto nos Papeis (CASL)

Os entitlements interagem diretamente com o sistema de permissoes:

  1. O papel do usuario define o que ele pode fazer (acoes sobre entidades)
  2. Os entitlements definem quais entidades existem para o tenant
  3. Se uma feature esta desabilitada, as entidades relacionadas ficam inacessiveis — mesmo para admins

Exemplo: Se o tenant nao contratou o add-on Estoque (financial.inventory), nem um usuario com papel Admin consegue acessar o estoque: o item some do menu e a tela informa que o modulo nao esta contratado, com link para a Loja.


Perguntas Frequentes

Posso testar uma feature antes de comprar? Sim. Entre em contato com o suporte para solicitar um trial. A equipe N1 pode conceder acesso temporario.

O que acontece com meus dados se eu cancelar um add-on? Os dados nao sao excluidos. Eles ficam preservados mas inacessiveis ate que a feature seja reativada.

Posso mudar de plano? O plano e definido pela equipe Opero na criacao da conta e hoje todos os planos incluem as mesmas features padrao. O que muda o que voce tem acesso sao os add-ons da Loja.

Last updated on