Skip to Content
PMS CoreReservasGrupos de Reservas

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 usoDescricaoExemplo
Reuniao familiarFamilia que reserva multiplos quartos para um eventoCasamento com 15 quartos para parentes
Retiro corporativoEmpresa que hospeda funcionarios para evento de equipeWorkshop de 3 dias com 20 colaboradores
Grupo de turismoAgencia ou operadora que traz um grupo organizadoExcursao de 40 pessoas com guia
Equipe esportivaTime que viaja para competicaoSelecao estadual com 25 atletas + comissao
Evento academicoParticipantes de congresso ou conferenciaCongresso medico com bloco de 30 quartos
Casamento / celebracaoConvidados que ficam hospedados para a festaNoivos 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

StatusSignificado
draftGrupo criado, ainda em montagem. E o status inicial.
confirmedGrupo confirmado.
checked_inO grupo esta hospedado.
checked_outO grupo encerrou a estadia.
cancelledO 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:

  1. Nome do grupo — descritivo e unico (ex: “Casamento Silva — Jun/2026”)
  2. 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:

  1. Informe a reserva a ser adicionada ao grupo
  2. 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:

  1. A partir do grupo, crie novas reservas informando propriedade, unidade, hospede e datas 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
  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
  • 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

LimitacaoDetalhe
Sem tela dedicada de grupoOs grupos sao criados e gerenciados apenas pela API. Nao ha interface para criar, editar ou visualizar grupos.
Check-in/out individualO 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 consolidadoNao ha fatura unica para o grupo; cada reserva tem seu proprio folio.
Sem rooming listNao ha funcionalidade de importar lista de quartos (rooming list) de agencias via planilha.

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 reservas, e so confirme quando tudo estiver definido
  4. Confira o total antes de confirmar — garanta que o total 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 — acompanhamento dos recebimentos
Last updated on