Hospedagem - Distribuicao de Quartos

O que é

Página dedicada de gestão e alocacao dos quartos contratados em uma hospedagem vinculada a uma excursão. O usuário chega aqui depois de cadastrar a hospedagem na aba Hospedagens da edição da excursão e preencher o allotment (quantidade de quartos por tipo). A partir dai a página gera automaticamente os quartos individuais e permite distribuir os passageiros confirmados e pendentes em cada quarto.

A interface mostra a esquerda a lista de Sem Quarto (passageiros da excursão ainda não alocados nesta hospedagem) e a direita os quartos agrupados por tipo, cada um com indicador visual do status (disponivel, parcial, ocupado, bloqueado) e contagem ocupacao/capacidade. No topo, um painel com totais (total de quartos, passageiros alocados, capacidade total e sem quarto) e o dropdown Rooming List para gerar/enviar a lista final ao hotel.

A página depende do módulo hospedagem ativo e da permissão de alocar a hospedagem para as ações de alocacao. A geracao da rooming list em PDF utiliza o serviço Gotenberg.

Como usar

1. Va em Viagens no sidebar e abra a excursão desejada.
2. Na página de edição, abra a aba Hospedagens e clique no botao Distribuicao de Quartos da hospedagem que você quer organizar.
3. Confirme no topo as estatisticas: Total Quartos, Passageiros Alocados, Capacidade Total e Sem Quarto.
4. Para alocar manualmente:
   • Na coluna Sem Quarto (esquerda), use o campo Buscar passageiro... para localizar o passageiro e clique no nome dele. Um aviso azul confirma que ele esta selecionado.
   • Na area de quartos (direita), clique em qualquer quarto com vaga (cartao destacado com anel indigo). O passageiro entra no quarto e a contagem ocupacao/capacidade e o status do quarto são atualizados.
5. Para alocar em lote, clique em Alocar Automaticamente (cabecalho, botao indigo). O sistema agrupa passageiros pelo order_id (mesmo pedido) e tenta manter o grupo no mesmo quarto, priorizando quartos com maior capacidade. Passageiros do mesmo pedido que não caibam juntos são alocados individualmente em quartos com vaga.
6. Para remover um passageiro de um quarto, clique no icone de lixeira acima do avatar do passageiro dentro do cartao do quarto.
7. Para editar um quarto individual, clique no icone de lapis no cabecalho do cartao do quarto. E possível ajustar número, andar, observações (ate 500 caracteres) e status entre disponivel e bloqueado.
8. Para zerar tudo, clique em Limpar Alocacoes (cabecalho). A ação remove todas as alocacoes desta hospedagem e devolve cada quarto ao status disponivel.
9. Quando a distribuicao estiver pronta, abra o dropdown Rooming List (cabecalho, botao verde) e escolha Baixar PDF, Baixar Excel, Gerar Link (link publico compartilhavel) ou Enviar por E-mail (com observações opcionais).
10. Use Histórico de Envios dentro do mesmo dropdown para auditar quem gerou ou enviou cada versão da rooming list (formato, data, autor e destinatario quando aplicavel).

Casos especiais

Quartos ainda não foram gerados

Os quartos individuais são criados a partir do allotment (QuartoDisponivel) cadastrado na hospedagem. Se o painel direito exibe a mensagem "Nenhum quarto disponível - Configure o allotment na hospedagem para que os quartos sejam gerados automaticamente", volte para a hospedagem (aba Hospedagens da excursão), preencha a quantidade por tipo de quarto e salve. A página entao gera os quartos nomeados como <Tipo> #1, <Tipo> #2, etc., respeitando a capacidade maxima do TipoQuarto.

Manter familias e grupos juntos

A alocacao automática usa o order_id do passageiro para agrupar quem comprou junto. Antes de rodar, certifique-se de que os membros da familia/grupo estao na mesma reserva. Quando o tamanho do grupo cabe em um único quarto, o sistema escolhe o quarto com capacidade exata ou maior.

Bloquear um quarto

Use o icone de lapis no cabecalho do quarto e mude o status para bloqueado. Quartos bloqueados ficam visualmente em cinza e não recebem novas alocacoes nem pela alocacao automática nem pelo clique manual.

Passageiros não aparecem na lista

A lista Sem Quarto so mostra passageiros da excursão com status confirmado ou pendente que ainda não estao alocados em nenhum quarto desta hospedagem. Cancelados, sem assento, no-show ou ja alocados em outro quarto desta mesma hospedagem não aparecem.

Compartilhar rooming list com o hotel sem login

Use Gerar Link dentro do dropdown Rooming List. O sistema cria um token publico, e a URL retornada (/rooming-list/<token>) pode ser aberta sem autenticacao. O mesmo token também entrega PDF (/rooming-list/<token>/pdf) e Excel (/rooming-list/<token>/excel).

Erros comuns e como resolver

• "Passageiro ja esta alocado no quarto ''." - Causa: tentativa de alocar um passageiro que ja ocupa outro quarto desta mesma hospedagem. Solucao: localize-o no quarto atual e remova com a lixeira antes de alocar no novo quarto.
• "Quarto esta na capacidade maxima (X pessoas)." - Causa: o TipoQuarto.capacidade_max foi atingido. Solucao: aloque o passageiro em outro quarto com vaga ou aumente o allotment de um tipo com capacidade maior.
• "Hospedagem não pertence a esta excursão" - Causa: a URL contem um ID de hospedagem que não e da excursão informada. Solucao: volte pela aba Hospedagens da excursão e clique novamente em Distribuicao de Quartos.
• "Erro ao gerar PDF. Verifique se o serviço Gotenberg esta disponível." - Causa: o serviço Gotenberg responsavel por renderizar o PDF da rooming list não esta acessivel. Solucao: tente novamente em alguns instantes; se persistir, abra um chamado no suporte.
• "Configure o allotment para comecar" - Causa: nenhum QuartoDisponivel cadastrado na hospedagem. Solucao: cadastre o allotment na aba Hospedagens da excursão.

Onde encontrar

• URL: /admin/excursoes/{excursao}/hospedagem/{hospedagem}/quartos
• Caminho no menu: Viagens > Editar Excursão > Hospedagens > Distribuicao de Quartos
• Permissão necessária: ver a hospedagem para visualizar, alocar a hospedagem para alocar/desalocar/limpar e editar a hospedagem para editar quartos
• Módulo necessário: hospedagem

Veja também

• Cadastrar Hospedagem
• Listagem de Hospedagens
• Relatório de Ocupacao