Reservas - Links e Reenvios

O que é

A página de detalhes da reserva concentra três fluxos de compartilhamento com o cliente em um mesmo lugar: gerar um link de pagamento via meio de pagamento, gerar links mágicos para que outros passageiros completem o cadastro na mesma compra e reenviar a confirmação da reserva por e-mail ou WhatsApp. Todos os recursos ficam atrás do menu Ações, no canto superior direito da página da reserva.

Você normalmente chega aqui quando o cliente perdeu o e-mail original, pediu para refazer o link de cobrança, ou quando uma compra única vai receber mais passageiros (família, grupo de amigos, escola). Cada link tem regra própria de validade, e os botões só aparecem se o cenário fizer sentido - por exemplo, Gerar Link de Pagamento só é exibido enquanto houver valor pendente e meio de pagamento ativo.

Como usar

Gerar link de pagamento

1. Abra a reserva em Reservas > (selecione a reserva) - URL "/admin/reservas/{passageiro}".
2. Clique no botão Ações (canto superior direito) e escolha Gerar Link de Pagamento.
3. No modal, escolha o que será cobrado:
   • Parcela - quando a reserva tem plano de pagamento, lista cada parcela com vencimento e valor.
   • Valor total pendente - soma tudo que falta pagar.
   • Valor personalizado - digite no campo Valor (em reais).
4. Clique em Gerar Link. O sistema chama o meio de pagamento ativo (Mercado Pago, Asaas, Pagar.me, InfinitePay etc.) e devolve a URL.
5. Use os atalhos do estado de sucesso:
   • Copiar link (ícone de prancheta) - copia a URL para a área de transferência.
   • WhatsApp - abre o WhatsApp Web/app com a mensagem e o número do comprador já preenchidos.
   • QR Code - mostra um QR Code que abre a página de pagamento ao escanear (não é QR de PIX direto).

Completar dados do cliente quando faltarem

Se o comprador não tiver nome, CPF, e-mail ou celular cadastrados, o modal muda para o estado Faltam dados do cliente com aviso amarelo. Preencha os campos obrigatórios e clique em Salvar dados e gerar link - o sistema atualiza o cadastro do cliente comprador e segue para a geração do link na mesma ação.

Ao digitar CPF ou e-mail, o modal valida em tempo real se aquele dado já pertence a outro cliente na sua empresa. Se houver conflito, aparece o aviso em vermelho abaixo do campo com o nome do cliente duplicado.

Reenviar a confirmação da reserva

1. Em Ações, escolha Reenviar Confirmação.
2. No modal, marque os Canais de envio desejados:
   • E-mail - vai para o endereço do passageiro ou, na falta, do cliente vinculado.
   • WhatsApp - aparece apenas quando o módulo whatsapp-mensagens está ativo e o cliente tem celular ou telefone cadastrado.
3. Clique em Reenviar. Pelo menos um canal precisa estar marcado.

O sistema dispara a notificação ReservaConfirmadaClienteNotification para e-mail e usa o WhatsAppNotificationService para WhatsApp. O toast mostra quais canais saíram com sucesso e quais falharam.

Gerar links mágicos para passageiros adicionais

Use este fluxo quando o comprador fez uma reserva única e quer que outros passageiros (família, grupo, colegas) preencham os próprios dados sem precisar fazer outra compra. O endpoint é POST /admin/reservas/{passageiro}/gerar-links e recebe quantidade de 1 até 10.

Cada link gerado:

• É um endereço público no formato /reserva/completar/{token}.
• Tem 48 horas de validade.
• Mantém vínculo com o comprador original (mesma compra, mesmos dados de excursão e embarque).

O cliente que abre o link vê os dados da excursão, mantém o ponto de embarque do comprador, preenche os próprios dados pessoais e finaliza o cadastro como passageiro adicional dentro da mesma reserva.

Casos especiais

Reserva cancelada

Quando o status é cancelado, a opção Gerar Link de Pagamento não aparece no menu. Para registrar pagamento de uma reserva cancelada é preciso reativá-la antes.

Reserva sem valor pendente

A entrada Gerar Link de Pagamento só é exibida quando o valor pendente é maior que zero. Se já está tudo pago, o item simplesmente não aparece - não é erro, é comportamento esperado.

Cliente sem cadastro completo

Mesmo com meio de pagamento ativo, todos os adquirentes (Mercado Pago, Asaas, Pagar.me etc.) exigem nome, CPF, e-mail e telefone do pagador. O modal entra em modo "completar dados" e bloqueia a geração até preencher. Os dados são salvos diretamente no cadastro do cliente comprador.

Reserva sem cliente vinculado

Tanto Gerar Link de Pagamento quanto Reenviar Confirmação falham com a mensagem "Reserva sem cliente vinculado" quando o passageiro não tem relação com um registro de cliente. Vincule o cliente antes (na própria página de detalhes) e tente de novo.

WhatsApp sem o módulo ativo

Sem o módulo whatsapp-mensagens, o canal WhatsApp não aparece no modal de reenviar confirmação. O atalho WhatsApp dentro do modal de link de pagamento continua funcionando porque ele apenas abre o wa.me no navegador do operador, sem usar a API da sua empresa.

Erros comuns e como resolver

• "Não há valor pendente para gerar link de pagamento." - A reserva está quitada ou o valor digitado é zero. Confira o financeiro da reserva ou informe um valor maior que zero no campo Valor.
• "Nenhum meio de pagamento de pagamento configurado." - Configure um meio de pagamento em Configurações > Pagamentos e ative-o antes de tentar novamente.
• "Meio de pagamento não suporta geração de link de pagamento." - O meio de pagamento ativo na sua empresa não implementa createPreference. Troque por um dos suportados (Mercado Pago, Asaas, Pagar.me, InfinitePay).
• "Faltam dados obrigatórios do cliente para gerar o link." - O modal troca de estado e mostra o formulário para você preencher nome, CPF, e-mail e celular do comprador antes de gerar.
• "Os dados informados já pertencem a outro cliente." - O CPF ou e-mail digitado bate com outro cliente do mesmo empresa. Localize o cliente duplicado citado na mensagem ou ajuste o dado para algo único.
• "Selecione ao menos um canal de envio." - No modal de Reenviar Confirmação, marque pelo menos uma das opções (E-mail ou WhatsApp).
• "Cliente sem e-mail cadastrado." / "Cliente sem telefone cadastrado."
  • O canal escolhido depende de um dado que não existe no cadastro. Atualize o cliente e tente de novo.
• "Reserva sem cliente vinculado. Não é possível reenviar." - Vincule a reserva a um cliente antes de reenviar a confirmação ou gerar link de pagamento.

Onde encontrar

• URL: /admin/reservas/{passageiro}
• Caminho no menu: Reservas > (selecione a reserva) > Ações
• Permissão necessária: editar as reservas
• Módulo necessário: nenhum para link de pagamento e link mágico; whatsapp-mensagens apenas para o canal WhatsApp em Reenviar Confirmação.

Veja também

• Detalhes da Reserva
• Pagamentos da Reserva
• Criar Reserva
• Confirmar Reserva