Skip to Content
PMS CorePropriedadesMaster Properties

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:

CampoTipoDescricao
idUUIDIdentificador unico
tenantIdUUIDConta (tenant) a que pertence
ownerIdUUIDProprietario responsavel pelo grupo
nameTextoNome do grupo de consolidacao

Quando usar

CenarioExemploBeneficio
Rede hoteleira5 hoteis da mesma bandeira em cidades diferentesDRE consolidado da rede inteira
Operacao multi-filialHotel + pousada + hostel do mesmo donoComparativo de desempenho entre filiais
Holding / investidoresFundo que possui participacao em diversas propriedadesRelatorio financeiro unico para prestacao de contas
Franquias regionaisFranqueador que monitora resultados de franqueados na regiaoVisao 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

A interface ainda nao tem uma tela para criar, renomear ou excluir Master Properties. Essas operacoes sao feitas pela API (/api/tenants/{tenantId}/properties/master). Para criar, informe:

  • Nome — nome descritivo do grupo (ex: “Grupo Beira Mar”, “Rede Sunset Hotels”)
  • Proprietario (Owner) — o proprietario responsavel

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


Vincular e desvincular propriedades

Vincular uma propriedade

O vinculo e feito na criacao da propriedade:

  1. Acesse Propriedades e clique em + Nova Propriedade
  2. No campo Propriedade Master (grupo de consolidacao — opcional), selecione a Master Property
  3. Clique em Criar Propriedade

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

O formulario Editar nao tem o campo Propriedade Master. Para vincular uma propriedade ja existente, e preciso usar a API (PUT /api/tenants/{tenantId}/properties/{id} com masterPropertyId).

Desvincular uma propriedade

Desvincular tambem so e possivel pela API: envie masterPropertyId: null no PUT da propriedade.

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

A exclusao e feita pela API (DELETE /api/tenants/{tenantId}/properties/master/{id}). 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. O relatorio consolidado soma valores de todas as propriedades do grupo.

Relatorios disponiveis

RelatorioDescricao
Consolidado por PropriedadeDRE consolidado: receitas, despesas e resultado de cada propriedade do grupo, lado a lado, e o total do grupo no periodo

Para acessar, va em Menu lateral → Relatorios Financeiros → Consolidado por Propriedade e selecione a Master Property.

Como funciona internamente

A consolidacao opera da seguinte forma:

  1. Identifica todas as propriedades cujo masterPropertyId aponta para a Master Property selecionada
  2. Calcula, para cada uma, o DRE do periodo a partir dos lancamentos contabilizados (status POSTED)
  3. Apresenta receita, despesa e resultado de cada propriedade
  4. Soma esses valores para obter o total consolidado do grupo

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


Limitacoes

LimitacaoDetalhe
Sem operacao propriaA Master Property nao possui unidades, tarifas, reservas ou hospedes. Toda operacao acontece nas propriedades filhas.
Sem lancamentos diretosNao e possivel criar lancamentos contabeis diretamente na Master Property. Os lancamentos pertencem as propriedades.
Um nivel de hierarquiaNao e possivel criar Master Properties aninhadas (uma Master Property dentro de outra). A hierarquia e de apenas um nivel.
Mesmo tenantTodas as propriedades de uma Master Property devem pertencer ao mesmo tenant. Nao ha consolidacao cross-tenant.
Sem conversao de moedaO relatorio consolidado soma os valores das propriedades sem conversao cambial. Agrupe apenas propriedades com a mesma moeda transacional.

Boas praticas

  1. Nomeie de forma clara — use nomes que identifiquem o grupo facilmente (ex: “Rede Sunset — Nordeste” em vez de “Grupo 1”)
  2. Vincule apenas propriedades relacionadas — a consolidacao so faz sentido para propriedades que compartilham a mesma gestao ou prestacao de contas
  3. Revise vinculos periodicamente — ao adquirir ou vender uma propriedade, atualize os vinculos da Master Property
  4. Use em conjunto com centros de custo — combine a consolidacao da Master Property com centros de custo detalhados para analises mais granulares
  5. 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

Last updated on