Reservas - Detalhes da Reserva

O que é

A página de Detalhes da Reserva e o painel central de uma reserva especifica. Reune, em uma única tela, os dados do passageiro, do responsavel pelo pedido, do grupo (titular + dependentes + convidados), o financeiro consolidado, o histórico de pagamentos, as observações internas e os documentos anexos. Também concentra todas as ações que o admin pode executar sobre essa reserva sem precisar voltar para a listagem.

O usuário normalmente chega aqui clicando em uma reserva na listagem (/admin/reservas), em um card de passageiros de uma excursão (/admin/excursoes/{excursao}/passageiros) ou diretamente por um link encaminhado pelo cliente/atendente. Use esta página sempre que precisar acompanhar pagamentos, corrigir dados, trocar a pessoa que vai viajar, anexar comprovantes ou registrar um combinado interno com a equipe.

Como usar

1. Va em Reservas no menu lateral.
2. Clique na linha da reserva que quer abrir. A URL fica no formato /admin/reservas/{passageiro}.
3. No topo da página você ve o código do pedido, o código da reserva, a data de criação e o badge colorido com o status (Pendente, Confirmado, Cancelado ou Lista de Espera).
4. Use o dropdown Ações (logo abaixo do titulo) para executar:
   • Confirmar Reserva quando o pagamento foi quitado por fora.
   • Cancelar Reserva informando o motivo obrigatório.
   • Aplicar Desconto ou Aplicar Acrescimo com valor e justificativa.
   • Reenviar Confirmação para o cliente (e-mail/WhatsApp).
   • Reenviar Contrato quando o módulo de Contratos Digitais esta ativo.
   • Gerar Link de Pagamento se houver saldo pendente e meio de pagamento habilitado.
   • Transferir para outro cliente (requer permissão reservas.transferir).
5. Role a página e use os cartoes:
   • Dados do Passageiro - nome, CPF, e-mail e telefone. Tem link "Ver perfil completo" para abrir o cliente.
   • Dados do Responsavel - aparece quando o passageiro e dependente (modo escolar).
   • Grupo do Responsavel - lista titular, dependentes e convidados do mesmo pedido. Permite Adicionar Passageiro, Trocar passageiro e remover membros (exceto o titular).
   • Financeiro - total, pago, pendente e composicao do pedido (excursão
     • ingressos + experiências quando aplicavel).
   • Histórico de Pagamentos - parcelas agendadas e pagamentos confirmados.
   • Documentos - anexos (notas fiscais, recibos, comprovantes, contratos).
   • Observações do Admin - campo interno para a equipe.

Casos especiais

Trocar o cliente de um acompanhante

Quando um convidado ou dependente do grupo precisa ser substituido por outro cliente ja cadastrado, clique no icone de seta circular ao lado do nome do membro. Informe o novo cliente (e o dependente, se for o caso) e um motivo opcional. O sistema preserva código da reserva, categoria, transporte, voucher e o financeiro do titular; apenas atualiza os dados pessoais do passageiro. O titular não pode ser trocado - para mudar o titular e necessário cancelar e criar uma nova reserva.

A troca também invalida automaticamente o aceite do contrato do grupo (se o módulo Contratos Digitais estiver ativo), exigindo nova assinatura.

Convite pendente (link não preenchido)

Se o cadastro veio de um link de convite e ainda não foi preenchido pelo convidado, o cartao Dados do Passageiro mostra apenas o e-mail enviado e a marca "Aguardando cadastro via link". Nesse caso aparece a ação Prorrogar Convite (dropdown), que estende a validade por 48h e devolve um novo link para compartilhar.

Reserva cancelada

Quando a reserva esta cancelada, o dropdown Ações muda: aparece Reativar Reserva (Pendente) (restaura soft-delete e devolve para Pendente) e Excluir Reserva (soft delete definitivo). A reativacao também restaura o financeiro e o status do pedido.

Reserva titular de grupo

Quando o passageiro aberto e o titular de um grupo com dependentes/convidados, os valores exibidos no cartao Grupo do Responsavel vem do Order (valor_total_real, valor_pago_real), não do financeiro individual. Os acompanhantes aparecem com "Pago por {titular}" no lugar do valor proprio, porque o financeiro fica consolidado no titular.

Pedido misto (excursão + ingressos + experiências)

Se a mesma order tem ingressos ou experiências alem da excursão, aparece o bloco Composicao do pedido com a quebra por domínio. Cada ingresso vira um link clicavel para a venda do ingresso correspondente.

Erros comuns e como resolver

• "Não e possível trocar o cliente titular. Para mudar o titular, cancele e crie uma nova reserva." - Tentativa de usar "Trocar passageiro" no titular do grupo. Solucao: cancele a reserva e crie outra com o novo titular.
• "Reserva cancelada não pode ser editada." - Você esta tentando trocar o cliente ou alterar uma reserva ja cancelada. Solucao: reative a reserva antes (ação "Reativar Reserva (Pendente)") ou edite outra reserva.
• "Este cliente ja esta cadastrado nessa excursão." - Bloqueio para evitar duplicidade. Solucao: escolha outro cliente ou remova o registro anterior.
• "Limite de 5 documentos atingido." - Cada reserva aceita no máximo 5 arquivos. Solucao: exclua um documento existente antes de anexar outro.
• "Apenas reservas canceladas podem ser excluidas." - A ação Excluir so funciona para status Cancelado. Solucao: cancele primeiro e depois exclua.
• "Reserva alterada por outro processo. Recarregue a página." - Outro usuário alterou a reserva enquanto você editava. Solucao: recarregue (F5) e tente de novo.

Onde encontrar

• URL: /admin/reservas/{passageiro}
• Caminho no menu: Reservas (item fixo do sidebar) - abra a listagem e clique em uma reserva.
• Permissão necessária: ver as reservas (visualizar), editar as reservas (ações), reservas.transferir (transferir para outro cliente).
• Módulo necessário: nenhum para a página; Contratos Digitais habilita o botao "Reenviar Contrato".

Veja também

• Lista de Reservas
• Pagamentos da Reserva
• Confirmar Reserva
• Cancelar Reserva
• Status da Reserva
• Links de Compartilhamento