Reservas — Visão Geral

O módulo de Reservas é o coração operacional do Opero PMS. Ele gerencia todo o ciclo de vida de uma hospedagem: desde o momento em que um hóspede solicita uma acomodação até a finalização financeira após sua saída. Nesta página você entenderá como as reservas funcionam, quais estados elas podem assumir e como navegar pela interface principal.

O que é uma Reserva?

Uma reserva é o registro formal de que um hóspede (ou grupo de hóspedes) terá direito a ocupar uma ou mais unidades de acomodação durante um período específico de datas. A reserva contém:

• Hóspede principal — a pessoa responsável pela estadia
• Datas de entrada e saída — o período de ocupação
• Unidade(s) atribuída(s) — o quarto, cama ou apartamento reservado
• Tarifa aplicada — o preço por noite ou por período
• Status de pagamento — quanto já foi pago e quanto falta
• Observações e solicitações especiais — preferências do hóspede (andar alto, cama extra, berço, etc.)

Toda reserva pertence a uma propriedade específica e está vinculada ao tenant (conta) da sua organização.

Ciclo de Vida da Reserva

Uma reserva passa por estados sequenciais ao longo do tempo. Cada transição de estado é registrada na trilha de auditoria do sistema.

Diagrama de Estados

┌──────────┐     ┌────────────┐     ┌────────────┐     ┌──────────────┐     ┌─────────────┐
│ Pendente │────▶│ Confirmada │────▶│ Check-in   │────▶│  Check-out   │────▶│ Finalizada  │
└──────────┘     └────────────┘     └────────────┘     └──────────────┘     └─────────────┘
                       │                                                            ▲
                       │         ┌─────────────┐                                    │
                       ├────────▶│  Cancelada  │                                    │
                       │         └─────────────┘                                    │
                       │         ┌─────────────┐                                    │
                       └────────▶│   No-show   │────────────────────────────────────┘
                                 └─────────────┘

Descrição de Cada Estado

Dica: O estado “Finalizada” é diferente de “Check-out”. Uma reserva pode estar com check-out feito mas ainda aguardando emissão de nota fiscal ou conciliação bancária antes de ser finalizada.

Interface Principal — Lista de Reservas

Ao acessar PMS > Reservas no menu lateral, você verá a lista principal de reservas com as seguintes funcionalidades:

Filtros Disponíveis

Três Modos de Visualização

O módulo de reservas oferece três formas de visualizar os dados, cada uma otimizada para um cenário:

1. Tabela (Lista)

A visualização padrão. Mostra as reservas em formato de lista com colunas configuráveis:

• Código da reserva
• Hóspede
• Datas (entrada/saída)
• Unidade
• Status
• Pagamento
• Canal de origem
• Valor total

É ideal para buscas rápidas, filtragem avançada e operações em massa (como confirmar múltiplas reservas de uma vez).

2. Calendário (Timeline)

Mostra as reservas como blocos coloridos em um calendário horizontal, onde:

• O eixo vertical representa as unidades (quartos/camas)
• O eixo horizontal representa os dias
• Cada bloco colorido é uma reserva, com cor indicando o status

É ideal para verificar disponibilidade visual, identificar gaps entre reservas e fazer drag-and-drop de realocação.

3. Mapa (Floor Plan)

Mostra a planta baixa da propriedade com as unidades representadas visualmente. Cada unidade exibe seu status atual (livre, ocupada, suja, em manutenção). É ideal para propriedades que precisam de uma visão espacial da operação.

Status de Pagamento

Independentemente do status da reserva, cada reserva possui um indicador financeiro que mostra a situação do pagamento:

Importante: O status de pagamento é atualizado automaticamente quando pagamentos são registrados no módulo financeiro ou quando o gateway de pagamento (Stripe, PIX) notifica o sistema.

Ações Rápidas

Na lista de reservas, cada linha oferece ações rápidas acessíveis pelo menu de contexto (tres pontos) ou por botões diretos:

Notificações Automáticas

O sistema pode enviar notificações automáticas ao hóspede em momentos-chave do ciclo de vida:

• Confirmação de reserva — e-mail com detalhes da estadia
• Lembrete de check-in — 24h antes da data de entrada
• Resumo de check-out — fatura detalhada após a saída
• Solicitação de avaliação — após o check-out

Nota: As notificações automáticas dependem da configuração do módulo OCP (Opero Communication Platform). Consulte a seção de Comunicações para configurar os canais (e-mail, WhatsApp, SMS).

Permissões

O acesso ao módulo de reservas é controlado por papéis (CASL):

Sistema de Status (3 Dimensões Independentes)

O Opero separa o status da reserva em 3 dimensões que funcionam de forma independente:

1. Status da Reserva (Ciclo de Vida)

Importante: Reservas canceladas não desaparecem da listagem. Ficam visíveis com badge “Cancelada” e incluem o motivo e a data do cancelamento.

2. Status de Pagamento (Financeiro)

Prejuízo e Voluntário são definidos manualmente pelo operador. O sistema de pagamento automático nunca sobrescreve esses status.

3. Status do Hóspede (Operacional)

• Check-in: hóspede entrou na propriedade
• Check-out: hóspede saiu da propriedade

Estes são parte do ciclo de vida da reserva e representam a presença física do hóspede.

Código de Confirmação

Toda reserva recebe um código de confirmação no formato A4-LF-99-XK (8 caracteres) no momento da criação. Este código:

• É gerado automaticamente (não precisa esperar processamento)
• É enviado por e-mail ao hóspede
• Pode ser usado para buscar a reserva no sistema
• Aparece na listagem e nos detalhes da reserva

Confirmação por E-mail

Quando uma reserva é criada:

1. O hóspede recebe um e-mail com link de confirmação (válido por 24h)
2. Ao clicar no link, o status muda de Pendente para Confirmada
3. O e-mail do hóspede é automaticamente verificado

O front desk também pode confirmar manualmente clicando no botão Confirmar na listagem de reservas.

Carrinho Abandonado

Se um hóspede iniciar uma reserva no Guest Booking Portal mas não concluir (ex: saiu antes de pagar), os dados são capturados como reserva abandonada.

O front desk pode visualizar esses carrinhos no dashboard para follow-up e tentar converter em reserva.

Próximos Passos

• Criar Reserva — aprenda a registrar uma nova reserva
• Check-in — entenda o processo de chegada do hóspede
• Check-out — entenda o processo de saída
• No-show e Cancelamento — gerencie ausências e cancelamentos