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 Propriedade | Exemplos de Unidades |
|---|---|
| Hotel | Quarto 101, Suite Presidencial, Quarto Deluxe 305 |
| Hostel | Cama A1 (beliche superior), Cama B3 (individual) |
| Pousada | Chalé Jardim, Quarto Colonial |
| Flat/Apartamento | Apt 3B, Cobertura, Studio 12 |
Campos principais
| Campo | Descricao |
|---|---|
| Identificacao | Numero ou nome do quarto (ex: “101”, “Suite A”) |
| Nome | Nome descritivo opcional (ex: “Quarto Vista Mar”) |
| Andar | Localizacao vertical dentro da propriedade |
| Tipo | Categoria fixa da unidade (ex: standard, superior, deluxe, suite, dormitory, apartment, villa) |
| Estilo | Privativo (private) ou compartilhado (shared) |
| Capacidade | Numero maximo de hospedes (adultos + criancas + bebes) |
| Preco base | Valor de referencia por diaria, na moeda da propriedade (ex: 145,00 — nao em centavos) |
| Status | Estado 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 BAs 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
- 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.
- Clique em Nova Unidade
- 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
- Configure os campos opcionais conforme necessidade:
- Nome, tipo, estilo, andar, capacidade, preco base, area
- Vista, politica de fumantes, acessibilidade
- 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):
- Clique em “Download template (.xlsx)” — o arquivo ja traz os nomes das suas propriedades numa aba de referencia.
- 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.
- Envie o
.xlsxpreenchido (Choose file) e clique em Import. - 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
| Coluna | Obrigatoria | Observacoes |
|---|---|---|
property | Sim | Nome da propriedade (nao um ID). Deve ja existir. |
identification | Sim | Identificador da unidade (mantenha-o unico dentro da propriedade) |
type | Nao | Um de: standard, superior, suite, deluxe, dormitory, bunk, apartment, villa |
capacity, basePrice, floor, name | Nao | Mesmo significado do formulario de unidade individual |
maxAdults, maxChildren, maxInfants | Nao | Numerico |
viewType, smokingPolicy, roomStyle | Nao | viewType = um codigo de vista ja cadastrado (ex: sea_view, no_view); smokingPolicy = smoking, non_smoking ou both; roomStyle = private ou shared |
accessibility | Nao | true / 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| Status | Descricao | Quando usar |
|---|---|---|
| available | Pronta para receber hospede | Automatico ao concluir a tarefa de limpeza |
| occupied | Hospede em casa (checked in) | Automatico no check-in |
| cleaning | Governanca em andamento | Automatico no check-out |
| maintenance | Em reparo ou reforma | Nenhum fluxo atual coloca a unidade neste status |
| out_of_service | Indisponivel por tempo indeterminado | Automatico 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 Cama | Lugares por Cama |
|---|---|
single (solteiro) | 1 |
double (casal) | 2 |
queen | 2 |
king | 2 |
twin (duas de solteiro) | 1 |
sofa_bed (sofa-cama) | 1 |
bunk (beliche) | 2 |
futon | 1 |
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:
| Campo | Descricao | Padrao |
|---|---|---|
| maxAdults | Maximo de adultos | 2 |
| maxChildren | Maximo de criancas | 1 no formulario (2 se a coluna ficar vazia na importacao) |
| maxInfants | Maximo 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
- Padronize a identificacao — Use um formato consistente dentro de cada propriedade (ex: “101, 102, 103” ou “Suite A, Suite B”)
- Use o campo Tipo com criterio — Tarifas e o site de reservas agrupam as unidades pelo Tipo; escolha-o de forma consistente
- Configure camas corretamente — A configuracao de camas alimenta o motor de reservas e as OTAs. Dados incorretos causam overbooking
- 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 - Dormitorios = estilo compartilhado — Sempre marque unidades de hostel como
sharedpara habilitar venda por cama - Nao delete unidades com reservas — O Opero recusa excluir uma unidade com reservas (exceto canceladas) e oferece Deactivate Unit, que a deixa
out_of_servicee 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