Reservas - Listagem

O que é

A tela de Reservas consolida todos os passageiros das excursões do empresa em um único painel: cada cartão representa uma reserva (um comprador titular ou o representante do grupo escolar), com status da reserva, status financeiro, origem da venda, código do pedido, valores e atalhos para ações.

Você normalmente chega aqui para conferir vendas do dia, identificar reservas com pagamento parcial ou pendente, encontrar uma reserva específica pelo código/CPF/nome ou exportar a lista para uma planilha. É também o ponto de entrada para abrir os detalhes de cada reserva, registrar pagamentos e cancelar/confirmar manualmente.

Como usar

1. Vá em Reservas no menu lateral.
2. Confira os cinco cartões no topo: Total, Pendentes, Parciais, Confirmados e A Receber (soma de valor_pendente de todos os financeiros não cancelados da sua empresa). O cartão de Total mostra também quantas reservas estão canceladas.
3. Use a barra de filtros logo acima da lista:
   • Busca - aceita nome, e-mail, CPF, código do passageiro (QR code), código de reserva ou código do pedido. Você pode passar vários códigos separados por vírgula (ex: ABC123,DEF456) para buscar em lote.
   • Excursão - restringe a uma excursão publicada.
   • Origem - Site (checkouts e convites pelo site) ou Admin (cadastros manuais pela área administrativa).
   • Status - Pendente (sem pagamento), Parcial (pagou parte), Pago (quitado) ou Cancelado. O status é calculado dinamicamente a partir dos valores da order (quando existe) ou do financeiro individual.
4. Para cada reserva, clique em Gerenciar (botão colorido dentro do cartão) para abrir os detalhes, registrar pagamento, gerar links ou cancelar. Use Ver excursão para ir direto à lista de passageiros daquela excursão.
5. Para cadastrar manualmente, clique em Nova Reserva (canto superior direito) - abre o modal de cadastro rápido com seleção de excursão, cliente, embarque, categoria e assento.

Exportar a lista

1. Clique em Exportar (botão verde no fim da barra de filtros).
2. No modal Exportar reservas, escolha o formato:
   • CSV (Excel) - gera arquivo reservas_AAAA-MM-DD_HHMMSS.csv com BOM UTF-8 e separador ;.
   • PDF - abre em nova aba, agrupado por excursão, com totais de valor, pago e pendente.
3. Marque as colunas desejadas (agrupadas em Identificação, Cliente, Excursão, Financeiro, Observações e Outros). Use os atalhos Marcar todas, Restaurar padrão e Desmarcar todas no topo da lista.
4. Clique em Exportar no rodapé do modal. Os filtros ativos (busca, status, excursão, origem, datas) são preservados na exportação.

Casos especiais

Reservas em grupo (comprador com dependentes)

Quando um comprador faz uma reserva com vários passageiros vinculados, a lista mostra apenas um cartão por pedido: o titular real (quando o comprador viaja), ou o primeiro dependente do order (modo escolar), ou o primeiro passageiro do pedido se o comprador não viaja. Junto ao nome aparece a badge +N dependente(s) indicando os demais membros do grupo. Para ver todos, abra o cartão em Gerenciar ou em Ver excursão.

Reservas com excursão excluída

Reservas continuam aparecendo mesmo se a excursão tiver sido excluída (soft-delete), para permitir auditoria de histórico. A relação é carregada com withTrashed.

Vagas sem valor (múltiplos assentos)

Vagas secundárias de reservas que ocupam múltiplos assentos não aparecem na listagem - o filtro esconde registros com financeiro zerado (valor_total = 0 e valor_pago = 0). Elas continuam contabilizadas na capacidade da excursão.

Convites pendentes

Placeholders de convite ainda não cadastrados (cadastrado_via = convite_pendente) ficam fora da listagem principal - eles aparecem apenas no detalhe da reserva do comprador como links de compartilhamento. Veja Links de compartilhamento.

Alerta de pagamentos aguardando

Se você tem PIX direto ou transferência bancária ativos como forma de pagamento com confirmação manual e há pagamentos registrados aguardando aprovação, uma faixa laranja aparece logo acima dos filtros. Clique para ir à fila de aprovação em /admin/reservas/pagamentos-aguardando.

Erros comuns e como resolver

• "Nenhum resultado encontrado" com filtros aplicados - Causa: combinação de filtros não retorna registros. Solução: clique em Limpar filtros na própria mensagem ou ajuste busca/status.
• Reserva não aparece na lista mesmo existindo - Causa: a reserva pode ser uma vaga secundária (valor zerado) ou um convite pendente. Solução: abra o pedido do comprador titular pela busca por código de pedido (#XXXX) - os passageiros vinculados ficam visíveis ali.
• Valor "A Receber" parece alto demais - Causa: o cálculo soma todos os financeiros da sua empresa, excluindo apenas passageiros cancelados/transferidos. Reservas pendentes antigas continuam somando. Solução: filtre por Pendente para investigar reservas que ainda não tiveram pagamento.

Onde encontrar

• URL: /admin/reservas
• Caminho no menu: Reservas
• Permissão necessária: ver as reservas (para listar) e criar as reservas (para o botão Nova Reserva)
• Módulo necessário: nenhum

Veja também

• Visão Geral das Reservas
• Detalhes da Reserva
• Criar Reserva
• Status da Reserva
• Pagamentos da Reserva
• Links de Compartilhamento