Hospedagem - Cadastrar nova hospedaria

O que é

A página Nova Hospedagem cria um registro de hospedaria (hotel, pousada, resort, hostel, chácara, camping ou outro) no catálogo do módulo Hospedagem. A hospedaria cadastrada fica disponível para ser vinculada a excursões e, a partir dessa vinculação, é possível gerar quartos, alocar passageiros e emitir o rooming list.

O cadastro é centralizado: a mesma hospedaria pode ser reaproveitada em quantas excursões forem necessárias, sem precisar recadastrar dados de endereço, contato e políticas a cada viagem.

Como usar

1. Vá em Módulos > Hospedagem no sidebar para abrir a listagem.
2. Clique em Nova Hospedagem (botão no topo da listagem) ou acesse direto /admin/hospedagem/create.
3. Preencha o bloco Dados da Hospedagem:
   • Nome (obrigatório) - nome do estabelecimento (ex.: "Hotel Fazenda Boa Vista").
   • Tipo (obrigatório) - Hotel, Pousada, Resort, Hostel, Chácara, Camping ou Outro.
   • Telefone, E-mail e Website - contato principal da hospedaria. O e-mail é validado em formato; o website é normalizado para iniciar com https://.
4. Preencha o bloco Endereço:
   • Digite o CEP para preenchimento automático de Logradouro, Bairro, Cidade e Estado via consulta /admin/api/cep.
   • Ajuste Número e Complemento se necessário.
5. Preencha o bloco Contato no Estabelecimento (opcional) com o nome, telefone e e-mail da pessoa responsável na hospedaria.
6. Defina as Políticas:
   • Horário de Check-in e Horário de Check-out (formato HH:mm).
   • Política de Cancelamento - texto livre exibido como referência interna.
7. Marque as Amenidades disponíveis (Wi-Fi, Piscina, Estacionamento, Ar-condicionado, Café da manhã, Restaurante, Academia, Spa, Lavanderia, Recepção 24h, Pet Friendly, Acessibilidade).
8. Adicione Quartos / Acomodações clicando em Adicionar. Para cada tipo informe:
   • Nome do Tipo (obrigatório) - ex.: "Casal Standard", "Suíte Master".
   • Capacidade Mínima e Capacidade Máxima (obrigatórias, entre 1 e 20).
   • Descrição (opcional).
9. Adicione Suplementos clicando em Adicionar. Para cada suplemento informe:
   • Nome (obrigatório) - ex.: "Meia-pensão".
   • Tipo (obrigatório) - Refeição, Acomodação, Transfer ou Outro.
   • Preço Padrão (obrigatório, em reais).
   • Cobrança (obrigatório) - Por pessoa, Por quarto ou Por noite.
10. Em Configurações, mantenha Hospedagem ativa marcado para que ela apareça na seleção ao vincular em excursões. Desmarque para deixar como rascunho.
11. Use Observações Internas para anotações da equipe (não são exibidas ao cliente).
12. Confirme em um dos botões do rodapé:
    • Criar Hospedagem - salva e volta para a listagem.
    • Criar e continuar editando - salva e abre a tela de edição da hospedaria recém-criada.
    • Criar e adicionar outra - salva e abre um novo formulário em branco.

Casos especiais

Hospedaria sem quartos ou suplementos definidos

Os blocos Quartos / Acomodações e Suplementos são opcionais no cadastro. É possível salvar a hospedaria apenas com dados gerais e completar essas configurações depois, em editar.

Tipo de quarto com nome repetido

Ao salvar, o sistema usa firstOrCreate por nome dentro da hospedaria, então tipos de quarto com nome igual não são duplicados - apenas o primeiro é criado.

Endereço sem CEP brasileiro

Se o CEP não retornar resultados na consulta automática, preencha manualmente Logradouro, Bairro, Cidade e Estado. Todos os campos de endereço são opcionais.

Hospedaria desativada

Marcando Hospedagem ativa como desativada, a hospedaria continua salva, mas não aparece nas listas de seleção ao vincular em excursões.

Erros comuns e como resolver

• "O campo nome é obrigatório." - Causa: nome em branco. Solução: preencher Nome no bloco Dados da Hospedagem.
• "O campo tipo é obrigatório." - Causa: tipo não selecionado ou valor inválido. Solução: escolher uma das opções do select Tipo (Hotel, Pousada, Resort, Hostel, Chácara, Camping ou Outro).
• "O campo e-mail deve ser um endereço de e-mail válido." - Causa: formato inválido no e-mail principal ou de contato. Solução: usar formato [email protected].
• "O campo website deve ser uma URL válida." - Causa: URL malformada. Solução: digitar URL completa (ex.: https://www.hotel.com.br). O campo normaliza automaticamente para https:// ao sair do input.
• "O campo política checkin não corresponde ao formato H:i." - Causa: horário fora do padrão HH:mm. Solução: informar no formato 14:00.
• "Nome do Tipo" ou "Capacidade" em vermelho - Causa: linha de tipo de quarto adicionada sem preencher os campos obrigatórios. Solução: preencher ou remover a linha clicando no X do canto superior direito do bloco.
• "Erro ao cadastrar hospedagem: ..." - Causa: exceção durante a transação no banco. Solução: tentar novamente; se persistir, contatar o suporte com a mensagem completa.

Onde encontrar

• URL: /admin/hospedagem/create
• Caminho no menu: Módulos > Hospedagem > Nova Hospedagem
• Permissão necessária: ver a hospedagem + criar a hospedagem
• Módulo necessário: Hospedagem

Veja também

• Listagem de Hospedagens
• Alocação de Quartos