Relatórios de Experiências

O que é

A tela de Relatórios de Experiências mostra o panorama das suas saídas ao longo de um período: quantas sessões aconteceram, quantas pessoas embarcaram, quanto foi vendido, quanto já entrou e quanto ainda falta receber. É uma leitura por período (dia, semana ou mês), diferente da lista de Vendas, que mostra reserva por reserva.

Você normalmente chega aqui a partir do botão Relatórios por Período, na tela de Vendas de Experiências, quando precisa fechar o caixa do mês, escalar equipe para a semana, revisar o mês que passou ou planejar o que já está vendido para os próximos meses. É também de onde você exporta o mesmo recorte em Excel ou PDF para enviar para sócios ou contador.

Como usar

1. Vá em Módulos > Passeios / Experiências > Vendas no sidebar e clique em Relatórios por Período, ou acesse diretamente /admin/passeios/vendas/relatorios.
2. Use os atalhos Esta semana, Este mês, Mês passado, Próximo mês ou Este ano para aplicar um recorte pronto de uma vez. O botão do período ativo fica destacado em verde-azulado.
3. Se preferir um recorte próprio, use a barra de filtros logo abaixo:
   • Buscar por cliente, voucher ou experiência - busca livre pelo nome do cliente, código do voucher ou nome da experiência.
   • Período das saídas - data de início e fim. Conta a data em que a experiência acontece, não a data em que foi vendida.
   • Agrupar por - dia, semana ou mês. Define o tamanho de cada bloco.
   • Todas as experiências - filtra por uma experiência específica.
4. Clique em Filtrar para aplicar. O período padrão, ao abrir a tela sem filtro nenhum, é o mês corrente agrupado por dia.
5. Confira os cinco cartões de indicadores no topo: Saídas, Pessoas, Valor previsto, Recebido e A receber. Eles somam o período filtrado inteiro, não só o que está visível na página.
6. Use o alternador Cards / Lista, acima dos blocos, para escolher a visualização: Cards é mais visual e bom para poucos blocos; Lista é uma tabela compacta e aguenta o ano inteiro dia a dia.
7. Quando o agrupamento é por dia, cada bloco (card ou linha) ganha o link Ver lista, que abre o Relatório do Dia daquela data com a lista completa de passageiros.
8. No rodapé da tela, a tabela Por experiência no período consolida o período inteiro por experiência, da mais movimentada para a menos, para você identificar quais venderam mais.
9. Para levar o mesmo recorte para fora da tela, clique em Excel (baixa uma planilha) ou PDF (abre em uma nova aba, pronta para imprimir), no canto superior direito do cabeçalho.

O que você precisa saber antes

• A data que conta é a da saída, não a da venda. Se você vendeu uma experiência em março para sair em maio, ela aparece no relatório de maio, não no de março. O relatório responde "o que sai neste período", não "o que vendi neste período".
• Os indicadores do topo e a tabela por experiência sempre somam o período inteiro, mesmo que os blocos estejam paginados (24 por página no modo Cards, 60 no modo Lista). Não confie só no que está na tela para saber o total: os cartões já trazem a soma certa.
• "Pessoas" conta pelo peso da categoria escolhida na venda, não pelo número de reservas. Uma categoria configurada como dupla vale por duas pessoas, então o total de pessoas pode ser maior que o de reservas.
• Os botões Excel e PDF ficam apagados (sem clique) quando não há nenhuma reserva no período filtrado. Se não conseguir clicar, o motivo normalmente é esse, e não uma falha da tela.
• O botão Excel gera um arquivo CSV, não um .xlsx de verdade - mas abre normalmente no Excel brasileiro (separador ponto e vírgula, acentuação correta). Cada bloco de período sai com uma linha por experiência mais uma linha de total do bloco, útil tanto para conferir o detalhe quanto para montar um gráfico direto na planilha.
• O link "Ver lista" só aparece quando o agrupamento é por dia. Em semana ou mês, o bloco reúne vários dias diferentes e não haveria uma única lista de passageiros para mostrar.
• O modo de visualização (Cards ou Lista) é só apresentação: os números não mudam, e a escolha continua marcada mesmo depois de clicar em Filtrar.

Casos especiais

Vendas de pacote de experiências

Quando a venda faz parte de um pacote que combina várias experiências, ela entra no relatório como uma única linha (a de menor código dentro do grupo), para não contar a mesma venda mais de uma vez nos totais.

Nenhuma saída no período

Se o período filtrado não tiver nenhuma sessão, a tela mostra a mensagem "Nenhuma saída no período selecionado." no lugar dos blocos, e os botões Excel e PDF ficam desabilitados.

Datas invertidas no filtro de período

Se você digitar uma data final anterior à inicial, o sistema troca as duas automaticamente antes de montar o relatório, em vez de devolver uma lista vazia sem explicação.

Erros comuns e como resolver

• Os botões Excel e PDF não respondem ao clique - Causa: não há nenhuma reserva no período e no filtro atuais. Solução: ajuste o período ou remova o filtro de experiência/busca até aparecer pelo menos um resultado.
• "Nenhuma saída no período selecionado." - Causa: nenhuma experiência tem sessão dentro do intervalo de datas escolhido. Solução: revise o período (lembre que ele considera a data da saída, não da venda) ou o filtro de experiência aplicado.
• O link "Ver lista" não aparece em um bloco - Causa: o agrupamento atual é por semana ou mês. Solução: mude o campo Agrupar por para dia e clique em Filtrar novamente.

Onde encontrar

• URL: /admin/passeios/vendas/relatorios
• Caminho no menu: Módulos > Passeios / Experiências > Vendas > Relatórios por Período
• Permissão necessária: passeios.vendas
• Módulo necessário: Passeios e Experiências (passeios-experiencias)

Veja também

• Experiências - Vendas
• Dashboard Experiências
• Experiências - Visão Geral