Criar Propriedade
Este guia explica como cadastrar uma nova propriedade no Opero PMS. Uma propriedade representa qualquer estabelecimento de hospedagem — hotel, pousada, hostel, flat ou aluguel por temporada. Toda a operacao do sistema (unidades, reservas, tarifas, financeiro) acontece dentro do contexto de uma propriedade.
Pre-requisitos
Antes de criar uma propriedade, certifique-se de que:
- Conta ativa — voce possui acesso ao Opero com perfil de Administrador ou Operacional
- Dados cadastrais — nome, tipo e dados de contato da propriedade
- Proprietario (Owner) — ao menos um proprietario cadastrado no sistema
Passo a Passo
Passo 1: Iniciar o Cadastro
Acesse Menu lateral > Propriedades e clique no botao + Nova Propriedade no topo do painel de propriedades, a esquerda. O formulario de criacao sera exibido em um dialogo modal.
Passo 2: Informacoes Basicas
Preencha os campos obrigatorios:
| Campo | Obrigatorio | Descricao | Exemplo |
|---|---|---|---|
| Nome da Propriedade | Sim | Nome comercial da propriedade (minimo 2 caracteres) | Hotel Beira Mar |
| Slug | Nao | Endereco publico da propriedade. Se ficar vazio, e gerado a partir do nome (ex: hotel-beira-mar) | hotel-beira-mar |
| Tipo | Sim | Classificacao do estabelecimento (veja tabela de tipos abaixo) | Hotel |
| Proprietario | Sim | Pessoa fisica ou juridica dona do estabelecimento | Grupo Beira Mar Ltda |
| Nao | E-mail de contato principal | contato@beiramar.com.br | |
| Telefone | Nao | Telefone da recepcao ou administracao | (48) 3456-7890 |
Passo 3: Pais e Moeda
| Campo | Obrigatorio | Descricao | Exemplo |
|---|---|---|---|
| Pais | Nao (padrao BR) | Pais da propriedade, selecionado na lista | BR |
| Moeda | Nao (padrao BRL) | Moeda transacional: BRL, USD, EUR, GBP, ARS, CLP, COP, MXN, PEN, UYU, PYG ou BOB | BRL |
Nota: Endereco, latitude/longitude, CNPJ, website e descricao nao fazem parte dos formularios de criacao ou edicao. Endereco, coordenadas, website e descricao sao aceitos apenas pela API; o CNPJ nao pode ser informado nem pela API de propriedades.
Passo 4: Configuracoes Operacionais
| Campo | Padrao | Descricao |
|---|---|---|
| Horario de check-in | 14:00 | Hora padrao de entrada dos hospedes (formato HH:MM) |
| Horario de check-out | 11:00 | Hora padrao de saida dos hospedes (formato HH:MM) |
Os campos abaixo nao aparecem no dialogo de criacao; a propriedade e criada com os valores padrao. Fuso horario e inicio do ano fiscal podem ser alterados depois pelo botao Editar.
| Campo | Padrao | Descricao |
|---|---|---|
| Fuso horario | America/Sao_Paulo | Timezone da propriedade |
| Idioma padrao (Locale) | pt-BR | Idioma padrao da propriedade |
| Inicio do ano fiscal | 01 (Janeiro) | Mes em que comeca o exercicio contabil |
Importante: Os horarios de check-in e check-out so podem ser informados na criacao; o formulario Editar nao tem esses campos. Revise com cuidado antes de salvar.
Passo 5: Informacoes Complementares (Opcional)
| Campo | Descricao | Exemplo |
|---|---|---|
| Estrelas | Numero de 1 a 5 conforme a categoria do estabelecimento | 4 |
| Propriedade Master | Vinculo opcional a uma propriedade master para consolidacao financeira. Padrao: Nenhuma (independente) | Grupo Beira Mar |
Passo 6: Confirmar e Salvar
Revise todos os dados preenchidos e clique em Criar Propriedade. O sistema:
- Valida os campos obrigatorios
- Gera o slug a partir do nome quando o campo Slug fica vazio (ex: “Hotel Beira Mar” vira
hotel-beira-mar); se o slug ja existir na plataforma, acrescenta um sufixo (-2,-3, …) - Cria a propriedade e a seleciona na lista, exibindo seus detalhes
- Disponibiliza o portal de reservas em
https://{slug}.opero.global - Dispara a geracao do inventario de disponibilidade; como a propriedade ainda nao tem unidades, o inventario e gerado quando as unidades forem cadastradas
Tipos de Propriedade
| Tipo | Codigo | Descricao |
|---|---|---|
| Hotel | hotel | Estabelecimento hoteleiro tradicional com quartos privativos |
| Pousada | inn | Hospedagem de menor porte, geralmente familiar, com atendimento personalizado |
| Aluguel por Temporada | rental | Casas, apartamentos ou chacaras alugados por periodo (Airbnb-style) |
| Flat / Apartamento | flat | Unidades de flat ou apart-hotel com servicos hoteleiros |
| Hostel | hostel | Hospedagem com quartos compartilhados ou dormitorios |
| Resort | resort | Resort |
| Outro | other | Qualquer outro tipo de acomodacao |
Nota: O tipo de propriedade e informativo e aparece em listagens e no portal de reservas. Ele nao altera o comportamento funcional do sistema — todas as funcionalidades estao disponiveis para qualquer tipo.
Facilidades (Facilities)
As facilidades declaradas aparecem na aba Info e sao enviadas ao portal de reservas. Os formularios da propriedade nao tem campo de facilidades: a lista e gravada pela API (campo facilities). A lista de facilidades reconhecidas esta em Configuracoes da Propriedade.
Nota: A lista de facilidades e flexivel (armazenada como JSONB). Valores fora da lista reconhecida sao exibidos como foram gravados.
Politicas da Propriedade
As politicas sao configuradas na aba Configuracoes da propriedade apos a criacao. Apenas a politica de pagamento altera o fluxo de reserva; as demais ficam registradas na propriedade, sem cobranca ou aplicacao automatica.
Politica de Cancelamento
| Configuracao | Descricao | Exemplo |
|---|---|---|
| Horas para cancelamento gratuito | Numero de horas antes do check-in em que o hospede pode cancelar sem custo | 48 |
| Tipo de penalidade | O que e cobrado em caso de cancelamento fora do prazo | Primeira diaria |
| Percentual de penalidade | Quando tipo = percentual, qual o valor cobrado sobre o total da reserva | 50% |
Tipos de penalidade disponiveis:
| Tipo | Codigo | Descricao |
|---|---|---|
| Sem penalidade | — | Nenhuma penalidade registrada |
| Primeira diaria | first_night | Penalidade de uma noite |
| Estadia completa | full_stay | Penalidade do valor integral da reserva |
| Percentual | percentage | Penalidade de um percentual (1 a 100%) do valor total |
Politica de Pagamento
| Modo | Codigo | Descricao |
|---|---|---|
| Pagamento antecipado | prepayment_required | Hospede paga 100% no momento da reserva online (padrao) |
| Pagamento integral no check-in | pay_at_check_in_full | Reserva confirmada sem cobranca; pagamento total na chegada |
| Pagamento parcial no check-in | pay_at_check_in_partial | Percentual de deposito cobrado na reserva; saldo no check-in |
Quando o modo e
pay_at_check_in_partial, configure tambem o campo Percentual de deposito (ex: 30% do valor total).
Politica de Animais de Estimacao
| Configuracao | Descricao |
|---|---|
| Permitido | Se animais sao aceitos na propriedade (sim/nao) |
| Taxa por animal por estadia | Valor da taxa por animal (registrado; nao e somado automaticamente a reserva) |
| Peso maximo | Limite de peso do animal em quilogramas (0 = sem limite) |
Politica de Fumantes
| Opcao | Codigo | Descricao |
|---|---|---|
| Permitido | allowed | Permitido fumar em todas as areas |
| Nao permitido | not_allowed | Propriedade 100% livre de fumaca |
| Areas designadas | designated_areas | Fumantes apenas em areas especificas sinalizadas |
Politica de Criancas
| Configuracao | Descricao |
|---|---|
| Permitido | Se criancas sao aceitas na propriedade (sim/nao) |
| Idade minima | Idade minima para criancas se hospedarem (0 = todas as idades) |
Tipos de Cama
Ao configurar as unidades da propriedade, voce seleciona os tipos de cama disponiveis. Esses sao os tipos suportados pelo sistema:
| Tipo | Codigo | Descricao |
|---|---|---|
| Solteiro | single | Cama de solteiro (90 cm) |
| Casal | double | Cama de casal padrao (140 cm) |
| Queen | queen | Cama queen size (160 cm) |
| King | king | Cama king size (190 cm) |
| Twin | twin | Cama twin (1 lugar); para duas camas separadas, informe quantidade 2 |
| Sofa-cama | sofa_bed | Sofa que converte em cama |
| Beliche | bunk | Cama beliche (comum em hostels e dormitorios) |
| Futon | futon | Futon estilo japones |
Nota: Os tipos de cama sao usados no cadastro de unidades, nao diretamente na propriedade. Consulte a documentacao de Unidades para mais detalhes.
Boas Praticas
-
Preencha todos os campos — mesmo os opcionais. Informacoes completas melhoram a experiencia do hospede no motor de reservas e facilitam relatorios gerenciais.
-
Revise o fuso horario — o botao Editar oferece uma lista fixa (America/Sao_Paulo, America/Buenos_Aires, America/Santiago, America/Bogota, America/Mexico_City, America/New_York, Europe/Madrid, Europe/Lisbon e UTC). Fusos fora dessa lista (ex: Manaus, Fernando de Noronha) so podem ser gravados pela API.
-
Configure politicas antes de abrir reservas — a politica de pagamento define se o portal de reservas cobra o valor total, um deposito ou nada no momento da reserva. Defina-a antes de comecar a receber reservas pelo motor de reservas.
-
Use Master Property para redes — se voce gerencia mais de uma propriedade, vincule-as a uma Master Property na criacao para obter o relatorio consolidado.
-
CNPJ e NF-e — a emissao de documentos fiscais (NF-e) exige propriedade no Brasil (pais BR) com CNPJ cadastrado. O CNPJ nao e editavel nos formularios de propriedade.
Proximos Passos
Apos criar a propriedade, siga esta ordem para deixar tudo pronto para receber reservas:
- Cadastrar unidades — crie os quartos, camas ou apartamentos da propriedade
- Configurar tarifas — defina precos por tipo de quarto e temporada
- Configurar politicas — ajuste cancelamento, pagamento, pets e fumantes
- Cadastrar servicos — adicione servicos extras (cafe da manha, estacionamento, transfer)
- Configurar o portal de reservas — publique seu motor de reservas diretas
Dica: Consulte o guia completo de Onboarding da Primeira Propriedade para um passo a passo integrado que cobre todas as etapas acima.