Reservas - Visão Geral

O que é

O módulo de Reservas é a tela onde sua equipe acompanha cada compra feita para uma excursão: quem é o passageiro, em qual viagem, por qual canal entrou (site, admin ou link de convite), quanto vale o pedido, quanto já foi pago e o que ainda falta. Cada linha da lista representa um passageiro (registro de ExcursaoPassageiro), normalmente o titular do pedido (Order), com badges indicando o status da reserva e o status do pagamento de forma independente.

Você costuma chegar aqui em três situações: para localizar uma reserva específica (por nome, CPF, e-mail, código de reserva ou código do pedido), para acompanhar o que está pendente de pagamento ou de confirmação manual, e para agir sobre uma reserva - confirmar, cancelar, registrar um pagamento offline ou gerar links para que passageiros adicionais completem o cadastro.

Como usar

1. Acesse Reservas no menu lateral (item fixo do sidebar).
2. Confira o painel superior com cinco cartões de estatísticas: Total, Pendentes, Parciais, Confirmados e A Receber (valor pendente somado da sua empresa). Quando houver reservas canceladas, elas aparecem em vermelho no canto direito do cartão Total.
3. Se a faixa laranja Pagamentos aguardando confirmação estiver visível, clique nela para revisar pagamentos manuais (PIX direto ou transferência) antes de seguir.
4. Use a barra de filtros para localizar reservas:
   • Buscar por nome, email, CPF ou código... - aceita nome do cliente, e-mail, CPF, QR Code, código da reserva ou código do pedido. Permite vários códigos separados por vírgula (ex.: ABC123, DEF456).
   • Excursão - restringe a uma viagem publicada específica.
   • Origem - filtra por Site (checkout/convite) ou Admin (cadastro manual).
   • Status - combina status da reserva e do pagamento: Pendente, Parcial, Pago ou Cancelado.
5. Para cada card da lista, use o botão Gerenciar (cor varia conforme o status) para abrir os Detalhes da reserva.
6. Use o botão Nova Reserva (canto superior direito, em verde) para cadastrar manualmente um passageiro. Disponível apenas para perfis com a permissão de criar as reservas.
7. Use Exportar (à direita na barra de filtros) para gerar a planilha com as colunas selecionadas, respeitando os filtros aplicados.

Casos especiais

Reservas com dependentes ou convidados

Quando um comprador adiciona dependentes ou usa links de convite, a listagem mostra apenas o titular do pedido com um selo roxo +N dependentes. Os valores do card (Total, Pago, Pendente) refletem o pedido consolidado, não só o passageiro principal. Para ver cada acompanhante, abra os Detalhes da reserva.

Excursão excluída (soft-delete)

Reservas cuja excursão foi excluída continuam acessíveis pela listagem e pela tela de detalhes - útil para revisar histórico financeiro. O controlador carrega a excursão com withTrashed() para evitar 404.

Origem da reserva

O selo Site aparece para vendas vindas do checkout público e dos links de convite (checkout_*, link_convite, link_convite_dependente, convite_pendente). O selo Admin aparece para cadastros manuais (admin_*). Convites pendentes (cliente ainda não se cadastrou pelo link) não contam como reserva real e ficam fora desta lista.

Status visual vs status no banco

A coluna mostra dois badges: status da reserva (Pendente / Confirmado / Cancelado / Lista Espera, vindo da coluna status) e status do pagamento (Pgto Pendente / Parcial / Pago, calculado em tempo real a partir de order.valor_pago e order.valor_pendente, com fallback para o financeiro individual quando não há pedido). Para entender a diferença, consulte Status da reserva.

Erros comuns e como resolver

• "Esta reserva não pode ser confirmada." - A confirmação manual só é permitida para reservas no status Pendente. Reabra a tela de detalhes e verifique o status atual antes de clicar em Confirmar.
• "Apenas reservas canceladas podem ser reativadas." - A ação Reativar só fica disponível para reservas previamente canceladas. Se a reserva está ativa, use Cancelar primeiro, ou ajuste o status pela tela de detalhes.
• Reserva não encontrada / 404 ao abrir detalhes - Significa que o passageiro pertence a outra empresa ou que a excursão foi removida do banco (não apenas soft-deleted). Volte para a listagem e abra a partir do card.
• A Receber não bate com o esperado - O card A Receber soma apenas o financeiro de passageiros ativos (exclui cancelado e transferido). Filtre por Cancelado para comparar.

Onde encontrar

• URL: /admin/reservas
• Caminho no menu: Reservas (item fixo no sidebar)
• Permissão necessária: ver as reservas (a ação Nova Reserva exige criar as reservas; Confirmar, Cancelar e demais ações exigem editar as reservas)
• Módulo necessário: nenhum

Veja também

• Lista de reservas - filtros, busca e leitura dos cards
• Criar reserva - cadastro manual pelo admin
• Detalhes da reserva - financeiro, dependentes e ações
• Confirmar reserva - confirmação manual de pendentes
• Cancelar reserva - cancelamento com motivo obrigatório
• Links de compartilhamento - convidar passageiros adicionais
• Pagamentos da reserva - registrar e confirmar pagamentos
• Requisitos para embarque - documentos e pré-requisitos
• Status da reserva - diferença entre status de reserva e de pagamento