Master Properties

Uma Master Property (Propriedade Master) e uma entidade virtual de agrupamento usada para consolidacao financeira de multiplas propriedades. Ela nao possui unidades, tarifas ou reservas proprias — sua funcao e exclusivamente agregar dados financeiros das propriedades vinculadas, permitindo visoes consolidadas para redes hoteleiras e operacoes multi-filial.

O que e uma Master Property?

No Opero, cada propriedade opera de forma independente: tem suas unidades, reservas, hospedes e lancamentos financeiros. Porem, organizacoes que administram mais de uma propriedade precisam de uma visao unificada dos resultados financeiros do grupo.

A Master Property resolve esse problema. Ela funciona como um “guarda-chuva” financeiro que agrupa propriedades sem interferir na operacao individual de cada uma.

Hierarquia no sistema


┌─────────────────────────────────────────────────────────────┐
│  TENANT (Conta da organizacao)                              │
│                                                             │
│  ┌───────────────────────────────────────────────────────┐  │
│  │  OWNER (Proprietario)                                 │  │
│  │                                                       │  │
│  │  ┌─────────────────────────────────────────────────┐  │  │
│  │  │  MASTER PROPERTY: "Grupo Beira Mar"             │  │  │
│  │  │  (entidade virtual — sem unidades)              │  │  │
│  │  │                                                 │  │  │
│  │  │  ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │  │  │
│  │  │  │Hotel Beira  │ │Pousada Beira│ │Hostel     │ │  │  │
│  │  │  │Mar — Fpolis │ │Mar — Garopab│ │Beira Mar  │ │  │  │
│  │  │  │  12 quartos │ │  8 quartos  │ │  40 camas │ │  │  │
│  │  │  │  Reservas   │ │  Reservas   │ │  Reservas │ │  │  │
│  │  │  └─────────────┘ └─────────────┘ └───────────┘ │  │  │
│  │  └─────────────────────────────────────────────────┘  │  │
│  │                                                       │  │
│  │  ┌─────────────┐                                      │  │
│  │  │Flat Centro  │  (propriedade independente,          │  │
│  │  │— Fpolis     │   sem Master Property)               │  │
│  │  │  6 unidades │                                      │  │
│  │  └─────────────┘                                      │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

A Master Property possui apenas quatro campos:

Campo	Tipo	Descricao
id	UUID	Identificador unico
tenantId	UUID	Conta (tenant) a que pertence
ownerId	UUID	Proprietario responsavel pelo grupo
name	Texto	Nome do grupo de consolidacao

Quando usar

Cenario	Exemplo	Beneficio
Rede hoteleira	5 hoteis da mesma bandeira em cidades diferentes	DRE consolidado da rede inteira
Operacao multi-filial	Hotel + pousada + hostel do mesmo dono	Comparativo de desempenho entre filiais
Holding / investidores	Fundo que possui participacao em diversas propriedades	Relatorio financeiro unico para prestacao de contas
Franquias regionais	Franqueador que monitora resultados de franqueados na regiao	Visao macro de receita e custos por regiao

Regra pratica: Se voce precisa de um relatorio financeiro que some receitas e despesas de mais de uma propriedade, crie uma Master Property.

Criar uma Master Property

Acesse Configuracoes → Master Properties
Clique em Nova Master Property
Preencha os campos:
- Nome — nome descritivo do grupo (ex: “Grupo Beira Mar”, “Rede Sunset Hotels”)
- Proprietario (Owner) — selecione o proprietario responsavel
Clique em Salvar

A Master Property e criada sem propriedades vinculadas. O proximo passo e vincular as propriedades existentes.

Vincular e desvincular propriedades

Vincular uma propriedade

Acesse Propriedades e selecione a propriedade desejada
Na aba Detalhes, localize o campo Grupo de consolidacao (Master Property)
Selecione a Master Property no dropdown
Salve as alteracoes

A propriedade passa a fazer parte do grupo. Seus dados financeiros serao incluidos nos relatorios consolidados.

Desvincular uma propriedade

Acesse a propriedade vinculada
No campo Grupo de consolidacao, selecione a opcao vazia (nenhum)
Salve

A propriedade volta a ser independente. Seus dados financeiros deixam de aparecer nos relatorios consolidados da Master Property.

Nota tecnica: O vinculo e feito pelo campo masterPropertyId na propriedade. Esse campo e uma chave estrangeira opcional (FK nullable). Desvincular simplesmente define o campo como NULL.

Exclusao de uma Master Property

Ao excluir uma Master Property, nenhuma propriedade filha e removida. O sistema apenas remove o vinculo: todas as propriedades que pertenciam ao grupo tem seu masterPropertyId definido como NULL automaticamente (cascade para nulo).

As propriedades continuam existindo e operando normalmente — apenas perdem a associacao ao grupo de consolidacao.

Atenção: A exclusao e irreversivel. Relatorios consolidados historicos que referenciavam essa Master Property nao poderao ser regenerados apos a exclusao.

Consolidacao financeira

A principal funcionalidade da Master Property e agregar dados financeiros das propriedades vinculadas. Os relatorios consolidados somam valores de todas as propriedades do grupo.

Relatorios disponiveis

Relatorio	Descricao
DRE Consolidado	Demonstrativo de Resultado do Exercicio somando receitas e despesas de todas as filiais
Orcamento consolidado	Visao orcamentaria unificada do grupo (requer add-on FOS)
Comparativo entre filiais	Benchmark lado a lado de indicadores como ocupacao, RevPAR, ADR e receita total
Fluxo de caixa do grupo	Entradas e saidas consolidadas de todas as propriedades

Como funciona internamente

As queries de consolidacao financeira operam da seguinte forma:

Identificam todas as propriedades cujo masterPropertyId aponta para a Master Property selecionada
Somam os lancamentos contabeis (journal entries) de todas essas propriedades no periodo solicitado
Agrupam por conta contabil (COA) seguindo a estrutura USALI
Apresentam o resultado como se fosse uma unica entidade financeira

Importante: A consolidacao e uma operacao de leitura. Nenhum lancamento contabil e criado na Master Property — os lancamentos permanecem nas propriedades originais.

Limitacoes

Limitacao	Detalhe
Sem operacao propria	A Master Property nao possui unidades, tarifas, reservas ou hospedes. Toda operacao acontece nas propriedades filhas.
Sem lancamentos diretos	Nao e possivel criar lancamentos contabeis diretamente na Master Property. Os lancamentos pertencem as propriedades.
Um nivel de hierarquia	Nao e possivel criar Master Properties aninhadas (uma Master Property dentro de outra). A hierarquia e de apenas um nivel.
Mesmo tenant	Todas as propriedades de uma Master Property devem pertencer ao mesmo tenant. Nao ha consolidacao cross-tenant.
Moeda unica por relatorio	O relatorio consolidado exibe valores na moeda do tenant. Propriedades com moedas transacionais diferentes terao valores convertidos pela taxa configurada.

Boas praticas

Nomeie de forma clara — use nomes que identifiquem o grupo facilmente (ex: “Rede Sunset — Nordeste” em vez de “Grupo 1”)
Vincule apenas propriedades relacionadas — a consolidacao so faz sentido para propriedades que compartilham a mesma gestao ou prestacao de contas
Revise vinculos periodicamente — ao adquirir ou vender uma propriedade, atualize os vinculos da Master Property
Use em conjunto com centros de custo — combine a consolidacao da Master Property com centros de custo detalhados para analises mais granulares
Nao confunda com Grupos de Reservas — Master Property e para consolidacao financeira entre propriedades; Grupos de Reservas sao para agrupar reservas de hospedes dentro de uma mesma propriedade

Proximos Passos

Criar Propriedade — como cadastrar uma nova propriedade para vincular ao grupo
Configuracoes da Propriedade — ajustes individuais de cada propriedade
Visao Geral do Financeiro — modulo financeiro onde os relatorios consolidados sao acessados
Centros de Custo — complemento para analise granular dentro do grupo
Relatorios Financeiros — todos os relatorios disponiveis, incluindo consolidacoes