Grupos de Reservas

Grupos de reservas permitem vincular diversas reservas individuais sob um mesmo agrupamento, facilitando a gestao operacional e financeira de hospedagens coletivas. Esta pagina explica o conceito, os casos de uso, o ciclo de vida e como trabalhar com grupos no Opero PMS.

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 e cobranca
• Total consolidado — valor somado de todas as reservas do grupo, recalculado automaticamente
• 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

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

Importante: O status do grupo e independente das reservas individuais. Um grupo pode estar checked_in mesmo que algumas reservas ainda estejam confirmed (membros que ainda nao chegaram).

Criar um Grupo de Reservas

Passo 1: Iniciar o grupo

Crie o grupo informando:

1. Nome do grupo — descritivo e unico (ex: “Casamento Silva — Jun/2026”)
2. Hospede principal — selecione um hospede existente ou cadastre um novo. Esse 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:

Vincular reservas existentes:

1. Localize a reserva na lista ou calendario
2. Abra os detalhes da reserva
3. No campo Grupo, selecione o grupo desejado
4. A reserva passa a fazer parte do grupo

Criar reservas em lote dentro do grupo:

1. A partir do grupo, crie novas reservas informando datas, tipo de quarto e hospede para cada uma
2. Todas as reservas criadas ja nascem vinculadas ao grupo

Passo 3: Revisar e confirmar

Apos adicionar todas as reservas:

1. Confira o total consolidado (recalculado automaticamente)
2. Verifique se todas as unidades estao disponiveis
3. Altere o status do grupo para confirmed

Adicionar e Remover Membros

Adicionar

• Vincule uma reserva existente ao grupo pelo campo groupId
• Ou crie uma nova reserva ja dentro do contexto do grupo

Ao adicionar uma reserva, o total do grupo e recalculado automaticamente somando os valores de todas as reservas vinculadas.

Remover

• Desvincule a reserva removendo o groupId
• A reserva continua existindo como reserva individual
• O total do grupo e recalculado (subtraindo o valor da reserva removida)

Atenção: Remover uma reserva do grupo nao a cancela. Ela apenas deixa de estar vinculada ao agrupamento.

Master Folio — Conta Mestra do Grupo

O conceito de Master Folio e central para a gestao financeira de grupos. Ele representa a conta consolidada do grupo inteiro:

┌──────────────────────────────────────────────────┐
│           MASTER FOLIO — Retiro ACME             │
├──────────────────────────────────────────────────┤
│  Reserva #1 — Qto 101 (3 noites × R$ 350)       │
│    Diarias ........................ R$  1.050,00  │
│    Minibar ........................ R$     45,00  │
│  ────────────────────────────────────────────     │
│  Reserva #2 — Qto 102 (3 noites × R$ 350)       │
│    Diarias ........................ R$  1.050,00  │
│    Transfer aeroporto ............. R$    120,00  │
│  ────────────────────────────────────────────     │
│  Reserva #3 — Qto 201 (3 noites × R$ 420)       │
│    Diarias ........................ R$  1.260,00  │
│    Cafe da manha extra ............ R$    135,00  │
│  ════════════════════════════════════════════     │
│  TOTAL DO GRUPO .................. R$  3.660,00   │
│  Pago ............................. R$  2.000,00  │
│  Saldo ............................ R$  1.660,00  │
└──────────────────────────────────────────────────┘

O Master Folio permite que o lider do grupo (ou a empresa responsavel) pague tudo de uma vez, em vez de cada hospede pagar individualmente.

Consolidacao Financeira

A cobranca de grupos pode seguir diferentes modelos:

Recalculo automatico do total

O campo totalAmountCents do grupo e recalculado automaticamente sempre que:

• Uma reserva e adicionada ao grupo
• Uma reserva e removida do grupo
• O valor de uma reserva individual e alterado (mudanca de datas, upgrade, etc.)

Todos os valores financeiros sao armazenados em centavos inteiros para evitar erros de arredondamento. O valor exibido na interface e convertido para reais (dividido por 100) na camada de apresentacao.

Grupo no Calendario e na Tabela

As reservas de um grupo aparecem normalmente nas visualizacoes padrao:

• Tabela — reservas do grupo aparecem na lista com um indicador visual (icone de grupo) e o nome do grupo como coluna adicional
• Calendario — cada reserva ocupa sua celula no timeline, com cor ou borda diferenciada indicando que faz parte de um grupo
• Filtro por grupo — e possivel filtrar a lista de reservas pelo nome do grupo para ver apenas seus membros

Limitacoes Atuais

Dica: Mesmo sem uma tela dedicada, voce pode usar o filtro por grupo na lista de reservas para ter uma visao focada de todos os membros.

Boas Praticas

1. Nomeie o grupo de forma descritiva — inclua o motivo e a data (ex: “Congresso Medicina — Set/2026”) para facilitar buscas futuras
2. Defina o lider cedo — o hospede principal sera o ponto de contato para toda comunicacao
3. Use draft para montar — mantenha o grupo em draft enquanto estiver adicionando/removendo reservas, e so confirme quando tudo estiver definido
4. Confira o total antes de confirmar — garanta que o recalculo automatico reflete todos os membros e tarifas corretas
5. 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 — faturamento consolidado pos-grupo