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
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:
- Acesse Propriedades e clique em + Nova Propriedade
- No campo Propriedade Master (grupo de consolidacao — opcional), selecione a Master Property
- 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
masterPropertyIdna propriedade. Esse campo e uma chave estrangeira opcional (FK nullable). Desvincular simplesmente define o campo comoNULL.
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
| Relatorio | Descricao |
|---|---|
| Consolidado por Propriedade | DRE 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:
- Identifica todas as propriedades cujo
masterPropertyIdaponta para a Master Property selecionada - Calcula, para cada uma, o DRE do periodo a partir dos lancamentos contabilizados (status POSTED)
- Apresenta receita, despesa e resultado de cada propriedade
- 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
| 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. |
| Sem conversao de moeda | O relatorio consolidado soma os valores das propriedades sem conversao cambial. Agrupe apenas propriedades com a mesma moeda transacional. |
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