Grupos de Reservas
Grupos de reservas permitem vincular diversas reservas individuais sob um mesmo agrupamento, facilitando a gestao de hospedagens coletivas. Esta pagina explica o conceito, os casos de uso e como os grupos funcionam hoje no Opero PMS.
Importante: Atualmente nao ha tela para grupos no painel. Os grupos sao criados e gerenciados pela API (
/reservation-groups).
O que e um Grupo de Reservas?
Um grupo de reservas e uma entidade que agrega multiplas reservas individuais sob uma unica referencia. Cada reserva dentro do grupo mantem seu proprio ciclo de vida (check-in, check-out, cobrancas), mas todas compartilham:
- Nome do grupo — identificacao do evento ou motivo (ex: “Reuniao Familia Silva”, “Retiro Corporativo ACME”)
- Hospede principal (lider) — a pessoa responsavel pelo grupo, ponto de contato para comunicacao
- Total consolidado — valor somado das reservas do grupo
- Observacoes — notas internas sobre o grupo (necessidades especiais, contrato, etc.)
Estrutura do Grupo
┌─────────────────────────────────────────────────────────┐
│ GRUPO DE RESERVAS │
│ Nome: "Retiro Corporativo ACME" │
│ Lider: Maria Santos │
│ Status: confirmed │
│ Total: R$ 12.450,00 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────┐ ┌───────────────┐ ┌─────────────┐ │
│ │ Reserva #1 │ │ Reserva #2 │ │ Reserva #3 │ │
│ │ Quarto 101 │ │ Quarto 102 │ │ Quarto 201 │ │
│ │ Maria Santos │ │ Joao Oliveira│ │ Ana Costa │ │
│ │ R$ 4.150,00 │ │ R$ 4.150,00 │ │ R$ 4.150,00 │ │
│ └───────────────┘ └───────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘Cada reserva individual continua aparecendo normalmente no calendario e na tabela de reservas. O campo groupId na reserva e o elo que liga a reserva ao grupo.
Quando usar Grupos
| Caso de uso | Descricao | Exemplo |
|---|---|---|
| Reuniao familiar | Familia que reserva multiplos quartos para um evento | Casamento com 15 quartos para parentes |
| Retiro corporativo | Empresa que hospeda funcionarios para evento de equipe | Workshop de 3 dias com 20 colaboradores |
| Grupo de turismo | Agencia ou operadora que traz um grupo organizado | Excursao de 40 pessoas com guia |
| Equipe esportiva | Time que viaja para competicao | Selecao estadual com 25 atletas + comissao |
| Evento academico | Participantes de congresso ou conferencia | Congresso medico com bloco de 30 quartos |
| Casamento / celebracao | Convidados que ficam hospedados para a festa | Noivos reservam bloco para padrinhos |
Regra pratica: Se tres ou mais reservas compartilham o mesmo motivo, hospede responsavel ou cobranca, agrupe-as.
Ciclo de Vida do Grupo
O grupo possui um status proprio, independente dos status das reservas individuais:
┌─────────┐ ┌────────────┐ ┌────────────┐ ┌──────────────┐
│ draft │─────▶│ confirmed │─────▶│ checked_in │─────▶│ checked_out │
└─────────┘ └────────────┘ └────────────┘ └──────────────┘
│
│ ┌────────────┐
└────────▶│ cancelled │
└────────────┘Descricao de cada status
| Status | Significado |
|---|---|
| draft | Grupo criado, ainda em montagem. E o status inicial. |
| confirmed | Grupo confirmado. |
| checked_in | O grupo esta hospedado. |
| checked_out | O grupo encerrou a estadia. |
| cancelled | O grupo foi cancelado. |
Importante: O status do grupo e definido manualmente (pela API) e nao muda sozinho quando as reservas fazem check-in, check-out ou sao canceladas. Alterar o status do grupo tambem nao altera as reservas.
Criar um Grupo de Reservas
Passo 1: Iniciar o grupo
Crie o grupo informando:
- Nome do grupo — descritivo e unico (ex: “Casamento Silva — Jun/2026”)
- Hospede principal — um hospede ja cadastrado, que sera o lider/responsavel
O grupo e criado com status draft e total zerado.
Passo 2: Adicionar reservas ao grupo
Ha duas formas de vincular reservas (ambas pela API):
Vincular reservas existentes:
- Informe a reserva a ser adicionada ao grupo
- A reserva passa a fazer parte do grupo
Todas as reservas do grupo precisam ser de propriedades com a mesma politica de pagamento; caso contrario, a inclusao e recusada.
Criar reservas em lote dentro do grupo:
- A partir do grupo, crie novas reservas informando propriedade, unidade, hospede e datas para cada uma
- Todas as reservas criadas ja nascem vinculadas ao grupo
Passo 3: Revisar e confirmar
Apos adicionar todas as reservas:
- Confira o total consolidado
- Verifique se todas as unidades estao disponiveis
- Altere o status do grupo para
confirmed
Adicionar e Remover Membros
Adicionar
- Vincule uma reserva existente ao grupo
- Ou crie novas reservas ja dentro do contexto do grupo
Ao adicionar reservas, o total do grupo e recalculado somando os valores de todas as reservas vinculadas.
Remover
Nao ha opcao para remover uma unica reserva do grupo. Ao excluir o grupo, todas as reservas sao desvinculadas e continuam existindo como reservas individuais.
Atencao: Excluir o grupo nao cancela as reservas. Elas apenas deixam de estar vinculadas ao agrupamento.
Consolidacao Financeira
Cada reserva do grupo tem seu proprio folio e e cobrada individualmente. Nao ha conta mestra (master folio) nem fatura consolidada do grupo.
Recalculo do total
O campo totalAmountCents do grupo e recalculado sempre que:
- Uma reserva existente e adicionada ao grupo
- Reservas sao criadas em lote dentro do grupo
Mudancas posteriores no valor de uma reserva nao atualizam o total do grupo.
Todos os valores financeiros sao armazenados em centavos inteiros para evitar erros de arredondamento.
Grupo no Calendario e na Tabela
As reservas de um grupo aparecem normalmente nas visualizacoes padrao (tabela, calendario e mapa), sem indicador de grupo e sem filtro por grupo.
Limitacoes Atuais
| Limitacao | Detalhe |
|---|---|
| Sem tela dedicada de grupo | Os grupos sao criados e gerenciados apenas pela API. Nao ha interface para criar, editar ou visualizar grupos. |
| Check-in/out individual | O check-in e check-out continuam sendo feitos reserva por reserva. Nao ha opcao de check-in em massa para o grupo inteiro. |
| Sem faturamento consolidado | Nao ha fatura unica para o grupo; cada reserva tem seu proprio folio. |
| Sem rooming list | Nao ha funcionalidade de importar lista de quartos (rooming list) de agencias via planilha. |
Boas Praticas
- Nomeie o grupo de forma descritiva — inclua o motivo e a data (ex: “Congresso Medicina — Set/2026”) para facilitar buscas futuras
- Defina o lider cedo — o hospede principal sera o ponto de contato para toda comunicacao
- Use draft para montar — mantenha o grupo em
draftenquanto estiver adicionando reservas, e so confirme quando tudo estiver definido - Confira o total antes de confirmar — garanta que o total reflete todos os membros e tarifas corretas
- Registre observacoes — use o campo de notas para anotar acordos especiais, descontos negociados ou requisitos do grupo
Proximos Passos
- Criar Reserva — como registrar reservas individuais para vincular ao grupo
- Charges e Extras — como adicionar consumos extras nas reservas do grupo
- Check-in — processo de chegada para cada membro do grupo
- Check-out — processo de saida e fechamento financeiro
- Contas a Receber — acompanhamento dos recebimentos