Reservas - Criar Reserva

O que é

Tela usada para abrir uma reserva nova pelo painel administrativo, sem precisar entrar antes na excursão. É o caminho indicado quando a venda chega por telefone, WhatsApp ou balcão e o atendente já está na lista de Reservas atendendo o cliente.

O botão Nova Reserva abre uma modal que primeiro pede a excursão e depois carrega cliente, embarque, categoria, transporte, valor e status no mesmo formato do cadastro de passageiros da excursão. Ao salvar, o sistema cria a Order (pedido), o passageiro, o financeiro com plano de pagamento e - se o status for Confirmado - também registra o pagamento de imediato. No final, o admin é redirecionado para a página de detalhes da reserva recém-criada.

Existe também o caminho equivalente dentro de Viagens > Excursões > (excursão) > Passageiros > Adicionar Passageiro, que usa a mesma modal e o mesmo endpoint. A diferença é só o ponto de entrada: aqui você já está na lista geral de Reservas e a excursão é escolhida dentro da modal.

Como usar

1. Vá em Reservas no menu lateral (ou abra direto /admin/reservas).
2. Clique em Nova Reserva (botão verde no canto superior direito, acima dos filtros).
3. Selecione a excursão no primeiro campo da modal. Só aparecem excursões publicadas.
4. Selecione o cliente em Clique para selecionar um cliente:
   • Use a busca por nome, CPF, telefone ou e-mail para localizar.
   • Se não existir, clique em Cadastrar novo cliente e preencha o Cadastro Rápido de Cliente. Os campos exibidos seguem a configuração de Cadastros Personalizados (apenas os marcados como visíveis no cadastro rápido aparecem). Confirme em Cadastrar e selecionar.
5. Preencha os campos da reserva:
   • Embarque - obrigatório em excursões com transporte. Em Pacote de Viagem sem embarques o campo some.
   • Categoria - habilita após escolher o embarque; define o preço aplicado.
   • Transporte - habilita após a categoria. Veículos esgotados aparecem desabilitados com aviso Transporte lotado.
   • Assento - opcional. Clique em Selecionar para abrir o mapa de assentos do veículo.
   • Valor - preenchido automaticamente pelo preço cadastrado. Pode ser editado.
   • Status - Pendente (não cobra) ou Confirmado (registra pagamento imediato se houver valor).
   • Forma de Pagamento - aparece só com Status = Confirmado. Opções: PIX, Dinheiro, Transferência, Cartão, Boleto, Cheque.
   • Vendedor - opcional. Aparece se você tiver vendedores cadastrados.
   • Observação - texto livre, até 500 caracteres.
6. Confirme em Adicionar. O sistema mostra o toast "Passageiro adicionado com sucesso!" e redireciona para a página de detalhes da reserva criada.

Casos especiais

Pacote de Viagem (sem transporte próprio)

Em excursões marcadas como Pacote de Viagem sem embarques nem transportes cadastrados, os campos Embarque, Transporte e Assento somem do formulário. A capacidade passa a ser controlada pelas Vagas Máximas da excursão.

Vagas bloqueadas para venda online

Se a excursão tem vagas reservadas para uso administrativo, a modal exibe um aviso amarelo no topo informando quantas estão bloqueadas para venda online e quantas estão livres. Cadastros manuais a partir do admin consomem essas vagas bloqueadas normalmente.

Cliente já tem reserva na mesma excursão

Se o cliente escolhido já tem reserva ativa nessa excursão, o sistema bloqueia com o erro "Este cliente já está cadastrado nesta excursão". Quando a jornada do cliente da excursão permite múltiplos assentos, aparece o botão Desbloquear e adicionar mesmo assim, que cria a nova entrada como poltrona extra vinculada ao pedido existente.

Criar pela página da excursão

Existe o caminho alternativo em Viagens > Excursões > (abrir excursão) > Passageiros > Adicionar Passageiro. É o mesmo formulário, mesmo endpoint e mesmas validações - apenas com a excursão já pré-selecionada. Veja o detalhamento em Passageiros - Cadastrar Passageiro.

Reserva criada com Status = Confirmado

Quando Status = Confirmado e Valor > 0, a Forma de Pagamento é aplicada e o pagamento é registrado imediatamente no financeiro do passageiro e na Order. Com Status = Pendente, o sistema gera o plano de pagamento automático conforme as parcelas configuradas na excursão e a reserva aguarda os pagamentos no fluxo normal.

Erros comuns e como resolver

• "Selecione a excursão" - Causa: tentativa de salvar antes de escolher a excursão na modal. Solução: escolha a excursão no primeiro campo antes de prosseguir.
• "Selecione um cliente" - Causa: tentativa de salvar sem selecionar cliente. Solução: use Clique para selecionar um cliente e busque, ou cadastre um novo.
• "Selecione o embarque" / "Selecione a categoria" / "Selecione o transporte" - Causa: campos obrigatórios não preenchidos. Solução: complete os campos na ordem em que ficam habilitados.
• "Este cliente já está cadastrado nesta excursão" - Causa: o cliente já tem reserva ativa na excursão. Solução: edite a reserva existente; ou, se a jornada permitir múltiplos assentos, use Desbloquear e adicionar mesmo assim.
• "Não existe preço configurado para a combinação de embarque e categoria selecionada. Configure o preço antes de adicionar passageiros." - Causa: matriz de preços incompleta. Solução: vá em Editar Excursão > Preços e cadastre o valor da combinação.
• "O assento {n} já está ocupado neste veículo. Selecione outro assento." - Causa: outra reserva ocupou o assento entre a abertura da modal e o salvamento. Solução: escolha outro assento.
• "Veículo '{nome}' esgotado! Capacidade de {n} passageiros atingida. Selecione outro veículo ou use 'Lista de Espera'." - Causa: transporte chegou à capacidade. Solução: escolha outro veículo, aumente a capacidade, ou cadastre o cliente na Lista de Espera.
• "Pacote esgotado! Capacidade de {n} vagas atingida." - Causa: em Pacote de Viagem, o total de vagas máximas foi atingido. Solução: ajuste Vagas Máximas ou cancele alguma reserva.
• "Erro ao carregar dados" - Causa: falha de rede ao buscar embarques/categorias/transportes da excursão. Solução: feche a modal, abra novamente e tente outra excursão; se persistir, atualize a página.

Onde encontrar

• URL: /admin/reservas (botão Nova Reserva)
• Caminho alternativo: /admin/excursoes/{excursao}/passageiros (botão Adicionar Passageiro)
• Caminho no menu: Reservas (item fixo do sidebar)
• Permissão necessária: ver as reservas (entrar na lista) e criar as reservas (ver o botão e abrir a modal). Para cadastrar cliente novo direto na modal: criar os clientes.
• Módulo necessário: nenhum

Veja também

• Visão Geral das Reservas
• Lista de Reservas
• Detalhes da Reserva
• Pagamentos da Reserva
• Confirmar Reserva
• Passageiros - Cadastrar Passageiro