Skip to Content
PMS CoreUnidades

Unidades (Quartos, Camas, Apartamentos)

Uma Unidade e a menor entidade reservavel dentro de uma propriedade no Opero. Pode ser um quarto de hotel, uma cama em dormitorio, um apartamento ou uma villa. Toda reserva esta vinculada a exatamente uma unidade.


O que e uma Unidade

A unidade representa o espaco fisico que o hospede ocupa durante a estadia. No Opero, unidades pertencem sempre a uma propriedade e herdam o contexto de multi-tenancy dela. Exemplos:

Tipo de PropriedadeExemplos de Unidades
HotelQuarto 101, Suite Presidencial, Quarto Deluxe 305
HostelCama A1 (beliche superior), Cama B3 (individual)
PousadaChalé Jardim, Quarto Colonial
Flat/ApartamentoApt 3B, Cobertura, Studio 12

Campos principais

CampoDescricao
IdentificacaoNumero ou nome do quarto (ex: “101”, “Suite A”)
NomeNome descritivo opcional (ex: “Quarto Vista Mar”)
AndarLocalizacao vertical dentro da propriedade
TipoCategoria fixa da unidade (ex: standard, superior, deluxe, suite, dormitory, apartment, villa)
EstiloPrivativo (private) ou compartilhado (shared)
CapacidadeNumero maximo de hospedes (adultos + criancas + bebes)
Preco baseValor de referencia por diaria, na moeda da propriedade (ex: 145,00 — nao em centavos)
StatusEstado atual da unidade (disponivel, ocupado, limpeza, etc.)

Unidade vs. Tipo de Quarto (Room Type)

O que agrupa unidades com caracteristicas semelhantes e o campo Tipo de cada unidade. Pense nele como uma “categoria” de quarto:

Tipo: standard ├── Quarto 101 ├── Quarto 102 └── Quarto 103 Tipo: suite ├── Suite A └── Suite B

As tarifas e o site de reservas agrupam as unidades por esse campo Tipo; uma tarifa tambem pode valer para uma unidade especifica ou para a propriedade toda.

O Tipo de Quarto (Room Type) e um cadastro separado, por propriedade: cada um possui um codigo unico por propriedade (ex: STD, DLX, STE), ocupacao maxima padrao e lista de amenidades base. Hoje o formulario de unidade nao vincula a unidade a um Tipo de Quarto. A pagina de tipos de quarto fica em /settings/room-types (titulo Room Types) e nao tem atalho no menu.


Criando Unidades

  1. Acesse Menu lateral → Propriedades, selecione a propriedade e abra a aba Unidades (a unidade sera criada nessa propriedade). A pagina Menu lateral → Unidades lista as unidades de todas as propriedades, mas nao tem botao de criacao — o lapis de editar leva a essa aba.
  2. Clique em Nova Unidade
  3. Preencha os campos obrigatorios:
    • Identificacao (campo ID / Number) — numero ou nome da unidade. O sistema nao impede repeticao; mantenha-o unico dentro da propriedade
    • Configuracao de camas — pelo menos uma cama
  4. Configure os campos opcionais conforme necessidade:
    • Nome, tipo, estilo, andar, capacidade, preco base, area
    • Vista, politica de fumantes, acessibilidade
  5. Salve (Create Unit)

Dica: Para hostels, marque o estilo como “Compartilhado” (shared). Isso habilita a venda por cama individual, permitindo multiplas reservas simultaneas na mesma unidade.


Importacao em Massa (Planilha)

Para criar muitas unidades de uma vez, use o botao Import units na pagina Unidades (menu lateral):

  1. Clique em “Download template (.xlsx)” — o arquivo ja traz os nomes das suas propriedades numa aba de referencia.
  2. Preencha uma unidade por linha, na primeira aba. Apenas duas colunas sao obrigatorias: property (deve casar com o nome — ou o slug — de uma propriedade existente, sem diferenciar maiusculas) e identification.
  3. Envie o .xlsx preenchido (Choose file) e clique em Import.
  4. O resultado mostra quantas unidades foram criadas e, por linha que falhou, o motivo exato (ex.: propriedade desconhecida, identificador ausente). Linhas validas sao importadas mesmo que outras falhem — corrija as linhas reportadas e reenvie apenas elas.

Colunas do modelo

ColunaObrigatoriaObservacoes
propertySimNome da propriedade (nao um ID). Deve ja existir.
identificationSimIdentificador da unidade (mantenha-o unico dentro da propriedade)
typeNaoUm de: standard, superior, suite, deluxe, dormitory, bunk, apartment, villa
capacity, basePrice, floor, nameNaoMesmo significado do formulario de unidade individual
maxAdults, maxChildren, maxInfantsNaoNumerico
viewType, smokingPolicy, roomStyleNaoviewType = um codigo de vista ja cadastrado (ex: sea_view, no_view); smokingPolicy = smoking, non_smoking ou both; roomStyle = private ou shared
accessibilityNaotrue / false

Dica: Salve o arquivo como .xlsx (formato Excel), nao .csv. Nomes de propriedade desconhecidos ou ambiguos sao reportados por linha, sem falhar o arquivo inteiro.


Ciclo de Vida do Status

Cada unidade possui um status que reflete sua situacao operacional atual. O ciclo padrao e:

available ──(check-in)──→ occupied ──(check-out)──→ cleaning ──(limpeza OK)──→ available qualquer status ──(desativar unidade)──→ out_of_service
StatusDescricaoQuando usar
availablePronta para receber hospedeAutomatico ao concluir a tarefa de limpeza
occupiedHospede em casa (checked in)Automatico no check-in
cleaningGovernanca em andamentoAutomatico no check-out
maintenanceEm reparo ou reformaNenhum fluxo atual coloca a unidade neste status
out_of_serviceIndisponivel por tempo indeterminadoAutomatico ao desativar a unidade

Nota: No check-out o Opero cria automaticamente uma tarefa de limpeza urgente para a unidade; quando a tarefa e concluida na Governanca, a unidade volta para available. O status nao e editavel no formulario da unidade. Para tirar uma unidade de venda por um periodo (manutencao, reforma, uso do proprietario, etc.), use Reservas → Bloquear unidade — o bloqueio vale so para as datas escolhidas e nao altera o status.


Configuracao de Camas

O Opero suporta uma configuracao de camas estruturada por unidade, compativel com OTAs (Booking.com, Expedia, etc.):

Tipo de CamaLugares por Cama
single (solteiro)1
double (casal)2
queen2
king2
twin (duas de solteiro)1
sofa_bed (sofa-cama)1
bunk (beliche)2
futon1

Exemplo de configuracao

Um quarto “Familia” com 1 cama queen e 1 beliche:

[ { "type": "queen", "count": 1 }, { "type": "bunk", "count": 1 } ]

Capacidade calculada: (1 x 2) + (1 x 2) = 4 lugares

Camas para dormitorios (hostels)

O Opero ainda nao permite cadastrar camas individuais, com status proprio, dentro de um dormitorio — nem pela tela nem pela API. Para um dormitorio, use o estilo compartilhado (shared) e descreva as camas na configuracao de camas acima.


Calculo de Capacidade

A capacidade total de uma unidade e definida por tres campos independentes:

CampoDescricaoPadrao
maxAdultsMaximo de adultos2
maxChildrenMaximo de criancas1 no formulario (2 se a coluna ficar vazia na importacao)
maxInfantsMaximo de bebes (bercos)1

O campo capacity representa a capacidade total geral. Ao configurar a cama (bedConfiguration), o sistema calcula automaticamente os lugares disponiveis com base nos tipos de cama — e o formulario nao aceita capacidade total maior que esse numero, nem maximo de adultos maior que a capacidade total.


Boas Praticas

  1. Padronize a identificacao — Use um formato consistente dentro de cada propriedade (ex: “101, 102, 103” ou “Suite A, Suite B”)
  2. Use o campo Tipo com criterio — Tarifas e o site de reservas agrupam as unidades pelo Tipo; escolha-o de forma consistente
  3. Configure camas corretamente — A configuracao de camas alimenta o motor de reservas e as OTAs. Dados incorretos causam overbooking
  4. Mantenha o status atualizado — Registre check-in, check-out e conclusao da limpeza no sistema: e isso que muda o status. O site de reservas so lista unidades com status available
  5. Dormitorios = estilo compartilhado — Sempre marque unidades de hostel como shared para habilitar venda por cama
  6. Nao delete unidades com reservas — O Opero recusa excluir uma unidade com reservas (exceto canceladas) e oferece Deactivate Unit, que a deixa out_of_service e mantem o historico

Integracao com outros modulos

  • Reservas → Cada reserva referencia uma unidade (nao ha reserva de cama individual)
  • Tarifas → Precos sao definidos por tipo de unidade ou unidade especifica
  • Governanca → Uma tarefa de limpeza e criada automaticamente para a unidade no check-out
  • Motor de Reservas → Exibe unidades disponiveis com fotos, amenidades e capacidade
  • Dashboard → Ocupacao, ADR e RevPAR da propriedade sao calculados a partir das reservas (noites e receita) sobre o numero de unidades, nao do status das unidades
Last updated on