Propriedades
O que e uma Propriedade
Uma Propriedade representa qualquer estabelecimento de hospedagem gerenciado pelo Opero: hotel, hostel, pousada, flat, apartamento por temporada ou qualquer outro tipo de acomodacao.
Cada propriedade e uma entidade operacional independente dentro do sistema. Ela possui suas proprias unidades (quartos/camas), tarifas, reservas, equipe de governanca e configuracoes financeiras. Toda a operacao do PMS acontece no contexto de uma propriedade.
Lista de Propriedades
Ao acessar Menu lateral → Propriedades, voce vera, no painel a esquerda, a lista de todas as propriedades cadastradas na sua conta (tenant). Cada cartao da lista exibe:
| Campo | Descricao |
|---|---|
| Nome | Nome comercial da propriedade |
| Proprietario | Proprietario (Owner) da propriedade |
| Tipo | Hotel, Pousada, Aluguel, Flat ou Outro |
| Cidade/Pais | Cidade do endereco e codigo do pais |
| Estrelas | Classificacao, quando informada |
| Unidades | Quantidade de unidades cadastradas |
Busca
O campo Buscar propriedades… filtra a lista por nome, proprietario ou cidade.
Dica: Se voce gerencia multiplas propriedades, clique em outra propriedade no painel a esquerda para alternar entre elas.
Detalhes da Propriedade
Ao clicar em uma propriedade na lista, voce acessa a tela de detalhes organizada em abas: Info, Unidades, Tarifas, Receitas, Canais, Mapa e Configuracoes. O botao Editar, no topo, abre o formulario de edicao (nome, tipo, pais, moeda, fuso horario e inicio do ano fiscal).
Aba: Info
Informacoes cadastrais da propriedade. Fuso horario, horarios de check-in/check-out e inicio do ano fiscal aparecem na aba Configuracoes; as coordenadas, na aba Mapa. A aba Info tambem mostra o endereco do portal de reservas (https://{slug}.opero.global) e as galerias de fotos e videos.
| Campo | Descricao | Exemplo |
|---|---|---|
| Nome | Nome comercial | Hotel Beira Mar |
| Slug | Identificador publico; define o endereco do portal de reservas | hotel-beira-mar |
| Tipo | Classificacao do estabelecimento | Hotel |
| Contato principal | contato@beiramar.com.br | |
| Telefone | Telefone da recepcao | (11) 3456-7890 |
| CNPJ | Documento fiscal (Brasil) | 12.345.678/0001-90 |
| Endereco | Rua, cidade, estado, CEP e pais | Rua das Flores, Florianopolis, SC |
| Pais | Codigo ISO do pais | BR |
| Moeda transacional | Moeda padrao para tarifas e cobrancas | BRL (Real Brasileiro) |
| Fuso horario | Timezone operacional | America/Sao_Paulo |
| Idioma padrao | Locale da propriedade (padrao pt-BR) | pt-BR |
| Classificacao (estrelas) | Numero de estrelas (1 a 5) | 4 |
| Horario de check-in | Hora padrao de entrada | 14:00 |
| Horario de check-out | Hora padrao de saida | 11:00 |
| Inicio do ano fiscal | Mes de inicio do exercicio contabil | 01 (Janeiro) |
| Website | URL do site da propriedade | https://beiramar.com.br |
| Descricao | Texto descritivo para o motor de reservas | — |
| Coordenadas | Latitude e longitude para mapa | -27.5954, -48.5480 |
Aba: Unidades
Lista todas as unidades (quartos, camas, apartamentos) cadastradas nesta propriedade. Acesso rapido para criar, visualizar e editar unidades e gerenciar suas fotos.
Aba: Tarifas
Tarifas e promocoes por canal de distribuicao. Permite configurar precos por tipo de unidade, periodo de validade e promocoes.
Aba: Receitas
Calendario de receitas com tarifas e ocupacao por tipo de quarto e data, alem de descontos por estadia (LOS), allotments por canal e regras de yield.
Aba: Canais
Conexao da propriedade com canais OTA (Booking.com, Airbnb, Expedia e outros).
Aba: Mapa
Localizacao da propriedade, a partir das coordenadas ou do endereco cadastrado.
Aba: Configuracoes
Horarios de check-in/check-out, politicas da propriedade e padroes operacionais. Veja Configuracoes da Propriedade.
Facilidades (Facilities)
A propriedade pode declarar uma lista de facilidades oferecidas. Elas aparecem na aba Info e sao enviadas ao portal de reservas (a exibicao depende do template do site). A lista de facilidades reconhecidas esta em Configuracoes da Propriedade.
Nota: A lista de facilidades e flexivel (campo JSONB): valores fora da lista reconhecida sao exibidos como foram gravados. Os formularios da propriedade nao tem campo de facilidades; a lista e gravada pela API (campo
facilities).
Politicas da Propriedade
Cada propriedade pode configurar politicas na aba Configuracoes. Apenas a politica de pagamento altera o fluxo de reserva; as demais ficam registradas na propriedade:
Politica de Cancelamento
| Configuracao | Descricao |
|---|---|
| Cancelamento gratuito | Numero de horas antes do check-in para cancelar sem custo |
| Tipo de penalidade | Sem penalidade, primeira diaria, estadia completa ou percentual |
| Percentual de penalidade | Quando tipo = percentual, qual o valor cobrado |
Politica de Pagamento
| Modo | Descricao |
|---|---|
| Pagamento antecipado (padrao) | Hospede paga 100% no momento da reserva online |
| Pagamento no check-in (integral) | Reserva confirmada sem cobranca; pagamento integral na chegada |
| Pagamento no check-in (parcial) | Percentual de deposito cobrado na reserva; saldo no check-in |
Outras Politicas
| Politica | Opcoes |
|---|---|
| Animais de estimacao | Permitido (com ou sem taxa e limite de peso) ou Nao permitido |
| Fumantes | Permitido, Nao permitido ou Areas designadas |
| Criancas | Permitido (com idade minima opcional) ou Nao permitido |
Multi-propriedade
O Opero suporta a gestao de multiplas propriedades dentro de uma unica conta (tenant). Isso significa que:
- Um unico login — o usuario acessa todas as propriedades da organizacao
- Dados isolados — cada propriedade tem suas proprias unidades, reservas e financeiro
- Alternancia rapida — o painel lateral da tela de Propriedades permite navegar entre propriedades sem logout
- Consolidacao financeira — via Master Properties (veja abaixo)
Quando usar multi-propriedade
- Redes hoteleiras com multiplas unidades
- Grupos que administram hoteis + hostels
- Operadores que gerenciam propriedades de terceiros
Master Properties (Propriedade Master)
Uma Master Property e uma entidade de consolidacao que agrupa duas ou mais propriedades para fins financeiros. Ela NAO recebe reservas diretamente — todas as operacoes acontecem nas propriedades filhas.
Para que serve
| Funcao | Descricao |
|---|---|
| Consolidacao de DRE | Relatório de resultados unificado do grupo |
| Comparativo entre filiais | Receita, despesa e resultado de cada propriedade do grupo, lado a lado |
| Relatorio para investidores | Visao macro do portfólio de propriedades |
Como funciona
Master Property: "Grupo Beira Mar"
├── Hotel Beira Mar — Florianopolis
├── Pousada Beira Mar — Garopaba
└── Hostel Beira Mar — Balneario Camboriu- Cada propriedade filha opera de forma independente
- A Master Property agrega os dados financeiros automaticamente
- O vinculo e opcional — uma propriedade pode existir sem Master Property
Criar uma Master Property
A interface ainda nao tem uma tela para criar Master Properties. A criacao e feita pela API (POST /api/tenants/{tenantId}/properties/master), informando o nome do grupo e o proprietario (Owner).
O vinculo e feito na criacao da propriedade filha, no campo Propriedade Master do dialogo Nova Propriedade. O formulario Editar nao tem esse campo.
Importante: A Master Property e apenas para consolidacao financeira. Ela nao possui unidades, tarifas ou reservas proprias.
Quem pode gerenciar propriedades
| Papel | Permissoes |
|---|---|
| Admin | Criar, visualizar, editar e excluir propriedades e Master Properties |
| Operacional | Criar, visualizar, editar e excluir propriedades e Master Properties |
| Financeiro | Sem acesso a propriedades por padrao |
Nota: A exclusao de propriedades so esta disponivel pela API; a interface nao tem botao de excluir. Nao ha como desativar uma propriedade.
Integracao com outros modulos
- Unidades → Cada propriedade contem N unidades com tipos e capacidades diferentes
- Reservas → Toda reserva pertence a uma unidade dentro de uma propriedade
- Financeiro → Lancamentos contabeis sao vinculados a propriedade (centro de custo)
- Governanca → Tarefas de limpeza sao criadas por propriedade
- Motor de Reservas → O site publico exibe informacoes da propriedade (descricao, fotos, facilidades)
- Dashboard → KPIs de ocupacao, receita e RevPAR sao calculados por propriedade