Excursões - Relatórios Consolidados

O que é

A área de Relatórios Consolidados reúne dois espaços complementares. O primeiro é a central em Relatórios > Consolidados (/admin/relatorios), com abas para Excursões, Vendas, Clientes, Guias, Cupons e DRE, mais abas extras conforme os módulos ativos (Financeiro, CRM, Ingressos, Experiências). O segundo é o Relatório Financeiro Consolidado de cada excursão, acessado pelo botão dentro da aba Financeiro da viagem, com receita, custos, lucro, formas de pagamento e custos detalhados.

Você normalmente chega aqui para fechar uma viagem (somar pagos vs. pendentes, identificar formas de pagamento mais usadas), para gerar o PDF financeiro de uma excursão para o sócio ou contador, ou para analisar o desempenho da agência por período no DRE.

Como usar

Central de relatórios (/admin/relatorios)

1. Vá em Relatórios > Consolidados no sidebar.
2. Escolha o Período nos campos de data no topo ou clique em um preset rápido: Hoje, 7 dias, 30 dias, Mês atual, Trimestre ou Ano.
3. Clique em Filtrar (botão azul à direita) para recarregar os cards e gráficos.
4. Selecione a aba desejada: Excursões, Vendas, Clientes, Guias, Cupons, DRE (e as abas de módulo, marcadas com a tag "módulo").
5. No seletor Visão logo abaixo das abas, escolha o sub-relatório (por período, por status, visão geral, etc., conforme a aba).
6. Clique em Colunas (engrenagem) para escolher quais colunas aparecem na tabela. A escolha é salva por usuário.
7. Para baixar os dados, clique em Exportar e selecione o formato no modal. Requer a permissão de exportar os relatórios.

Análise com IA

1. Com a aba e o período já configurados, clique em Analisar com IA (botão violeta com ícone de estrela no topo direito).
2. Aguarde a mensagem "Analisando..." - o sistema envia os dados para o Gemini e devolve um diagnóstico textual no painel ao lado.

DRE - Demonstração do Resultado do Exercício

1. Clique na aba DRE.
2. A tabela mostra Receita Bruta, Deduções, Custos, Despesas, Resultado Operacional, Resultado Líquido e a coluna de comparativo com o período anterior.
3. Use Exportar Excel (verde) para baixar a planilha ou Imprimir (indigo) para abrir a versão para impressão em nova aba.

Relatório Financeiro Consolidado por excursão

1. Abra a excursão em Excursões > Todas as Excursões.
2. Clique na aba Financeiro.
3. Clique em Relatório Consolidado (ou acesse /admin/excursoes/{excursao}/financeiro/relatorio).
4. Confira os cards Receita Total, Recebido, A Receber e Custos Totais, o Extrato de Resultado com lucro e margem, o gráfico Pagamentos por Forma e a tabela Custos Detalhados.
5. Para baixar a versão em PDF, clique em Exportar PDF (botão indigo no topo, abre em nova aba).
6. Se houver mais de 10 pagamentos, clique em Ver todos os {n} pagamentos no card Últimos Pagamentos Recebidos para abrir a listagem completa.

Relatórios de vendedores e responsáveis

1. Abra a excursão e vá em Passageiros.
2. Use os links Relatório de Vendedores ou Relatório de Responsáveis para ver as quebras agrupadas.
3. Cada um tem botão para gerar a versão em PDF (/admin/excursoes/{excursao}/passageiros/relatorio-vendedores/pdf e /relatorio-responsaveis/pdf).

Casos especiais

Caixa em Dinheiro

O card Caixa em Dinheiro só aparece no relatório consolidado da excursão se a configuração estiver ativa em Configurações > Empresa. O cálculo subtrai dos pagamentos recebidos em dinheiro:

• apenas os custos pagos em dinheiro, no modo padrão, ou
• todos os custos pagos, se o modo estiver configurado como tal.

A regra usada aparece na nota abaixo do card.

Custos variáveis por passageiro

Custos cadastrados como variável por passageiro são expandidos automaticamente no relatório, multiplicando o valor unitário pelo número de passageiros ativos. Isso garante que o total bata com a aba Custeio > Rentabilidade Real. A coluna Valor já mostra o total expandido; o valor unitário aparece no detalhe da linha.

Cards de Lucro avançados

Os cards Lucro Esperado, Lucro Atual e Margem de Lucro (faixa colorida com gradiente) só aparecem se o módulo Gestão Financeira estiver ativo na sua empresa. Sem o módulo, o relatório mostra apenas o Extrato de Resultado simples.

Abas de módulo na central

As abas Financeiro, CRM, Ingressos e Experiências só aparecem se o respectivo módulo estiver ativo. Sem o módulo, a aba some do menu sem mensagem de erro.

Pagamentos confirmados e cortesias

A tabela Últimos Pagamentos Recebidos lista apenas transações registradas e confirmadas (não estornadas). Cortesias (R$ 0), ajustes manuais e pagamentos agrupados (uma transação para múltiplos assentos) podem fazer o total da lista ficar menor que o número de passageiros com status Pago.

Erros comuns e como resolver

• Aba some depois de mudar de plano - Causa: módulo desativado. Solução: reativar o módulo em Configurações > Módulos ou usar apenas as abas básicas (Excursões, Vendas, Clientes, Guias, Cupons, DRE).
• Botão Exportar não aparece - Causa: usuário sem permissão de exportar os relatórios. Solução: pedir ao Proprietário para adicionar a permissão ao perfil em Configurações > Perfis de Acesso.
• PDF do relatório fica em branco - Causa: serviço Gotenberg indisponível. Solução: tentar novamente em alguns minutos; se persistir, abrir chamado no Suporte.
• Margem de Lucro 0% - Causa: receita total zerada (nenhum passageiro ativo ou todos cancelados). Solução: revisar status dos passageiros antes de fechar o relatório.
• Totais divergentes entre tela e PDF - Não deve ocorrer; ambos usam a mesma regra de expansão de custos variáveis. Se acontecer, verifique se o período/filtro foi alterado entre as duas ações.

Onde encontrar

• URL principal: /admin/relatorios
• URL por excursão: /admin/excursoes/{excursao}/financeiro/relatorio
• Caminho no menu: Relatórios > Consolidados
• Permissão para visualizar: ver os relatórios (central) ou ver as viagens (por excursão)
• Permissão para exportar: exportar os relatórios
• Módulo necessário: nenhum (abas Financeiro, CRM, Ingressos e Experiências exigem o respectivo módulo ativo)

Veja também

• Financeiro da Excursão
• Gerenciar Passageiros
• Checklist de Embarque
• Visão Geral das Excursões