Financeiro - Relatório Financeiro da Excursão

O que é

Página que consolida o resultado financeiro de uma excursão específica: quanto a viagem deveria gerar, quanto já entrou em caixa, quanto custou e qual o lucro estimado. Substitui a planilha externa de fechamento que muitos operadores ainda mantêm fora do sistema.

O admin chega aqui normalmente em dois momentos: durante a venda, para acompanhar o percentual recebido e o saldo a receber por passageiro; e depois da volta da viagem, para fechar o caixa, conferir os custos pagos e medir a margem real. Os custos variáveis (lançados como "valor por passageiro") são expandidos automaticamente pela quantidade de passageiros ativos da excursão - a mesma regra usada no card Rentabilidade Real da aba Custeio.

Como usar

1. Vá em Operacional > Excursões no sidebar e abra a excursão desejada.
2. Na navegação superior da excursão (x-excursão-nav), clique em Financeiro. O sistema redireciona para a lista de passageiros; de lá, abra o Relatório Financeiro pela mesma navegação ou acesse diretamente /admin/excursoes/{excursao}/financeiro/relatorio.
3. Confira no topo os quatro cards de resumo:
   • Receita Total - valor que a excursão deveria gerar (soma de valor_total de todos os passageiros não cancelados / não transferidos).
   • Recebido - soma dos pagamentos confirmados e não estornados, com o % do total já recebido.
   • A Receber - saldo pendente + parcial.
   • Custos Totais - soma dos custos da excursão (com variáveis já multiplicados por pax ativo).
4. Use o Extrato de Resultado logo abaixo para ver a conta Receita Total − Custos Totais = Lucro Estimado com a margem em percentual.
5. Com o módulo Gestão Financeira ativo, aparecem três cards extras em gradiente: Lucro Esperado, Lucro Atual (recebido menos custos pagos) e Margem de Lucro.
6. Analise os dois cards lado a lado:
   • Pagamentos por Forma - quanto entrou em PIX, dinheiro, cartão, boleto, transferência ou link de pagamento, com barra de percentual sobre o total recebido.
   • Custos por Categoria - quanto cada categoria do plano de contas representa do custo total, ordenado do maior para o menor.
7. Role até Últimos Pagamentos Recebidos para ver as últimas 10 transações com Passageiro, Forma, Data, Valor e Recibo compartilhável. Se houver mais que 10, clique em Ver todos os {N} pagamentos no cabeçalho do card.
8. Confira Custos Detalhados com fornecedor, descrição, categoria, vencimento, status e valor. Custos variáveis exibem a conta "R$ X × N pax" abaixo do valor total.
9. Em Status dos Passageiros veja a contagem dividida em Pagos, Parcial e Pendentes.
10. Para gerar o PDF do fechamento, clique em Exportar PDF no canto superior direito (abre em nova aba via Gotenberg, com DomPDF como fallback).

Casos especiais

Excursão sem o módulo Gestão Financeira

Os três cards de gradiente (Lucro Esperado, Lucro Atual, Margem de Lucro) ficam ocultos. No final da página aparece o banner verde-cyan "Quer uma Gestão Financeira ainda mais completa?" com botão Conhecer Módulo apontando para a contratação do módulo. O extrato simples de resultado e os custos detalhados continuam funcionando porque o cadastro de custos da excursão (FinContaPagar vinculado) está disponível sem o módulo completo.

Custos variáveis (por passageiro)

Custos com tipo_custo = variavel (ex: ingresso, alimentação) são expandidos pelo número de passageiros ativos da excursão (todos exceto cancelado e reembolsado). O valor exibido na coluna Valor já é o total real (unitário × pax) e a linha abaixo mostra a conta explícita: R$ 56,00 × 42 pax. Custos com tipo_custo = fixo (ex: fretamento) ou sem tipo definido entram como total único.

Card Caixa em Dinheiro

Opcional por empresa - só aparece quando a configuração relatorio_caixa_dinheiro_ativo está ligada em Configurações > Empresa. Mostra Recebido em dinheiro menos Despesas pagas em dinheiro (ou Todas as despesas pagas, conforme o modo escolhido) e o Saldo em caixa. Útil para conferir o malote da viagem.

Ver lista completa de pagamentos

Por padrão, o card lista apenas os 10 pagamentos mais recentes. Para auditar todas as transações, clique em Ver todos os {N} pagamentos no cabeçalho (o link só aparece quando há mais de 10) ou adicione ?todos=1 na URL. Use Ver apenas os últimos 10 para voltar.

Discrepância entre transações listadas e contagem de "Pagos"

A própria página alerta no subtítulo: a lista exibe somente transações registradas. Cortesias (R$ 0), ajustes manuais e pagamentos agrupados (1 transação para múltiplos assentos) podem fazer com que o número de linhas seja menor que o total de passageiros com status "Pagos" no resumo. Isso é esperado, não um bug.

Exportar PDF

O botão Exportar PDF usa o Gotenberg quando disponível (pdf.gotenberg.relatorio-financeiro) e cai para DomPDF (pdf.relatorio-financeiro) como fallback. O PDF mostra a versão completa dos pagamentos (não só os últimos 10) e agrupa o status financeiro por comprador, somando titular + dependentes/convidados em uma linha com as transações aninhadas.

Erros comuns e como resolver

• Lucro divergente do card Rentabilidade Real da aba Custeio - Causa: até abril/2026 os custos variáveis eram somados sem expansão. Solução: hoje o relatório usa a mesma regra de pax ativo do CusteioService::calcularRentabilidadeReal. Confirme que os custos variáveis têm o campo Tipo do custo preenchido como "variável" no cadastro de Contas a Pagar ligado à excursão.
• Custos não aparecem no relatório - Causa: lançamento sem excursao_id vinculado ou com status = cancelado. Solução: ao criar a conta a pagar, selecione a excursão no campo correspondente; contas canceladas são excluídas da soma por design.
• "Nenhum pagamento registrado" mesmo com vendas confirmadas - Causa: os pagamentos podem estar com status diferente de confirmado ou estornados. Solução: revise os pagamentos na página financeira do passageiro e confirme/estorne conforme necessário.
• Margem negativa surpreendente - Causa: custos variáveis grandes multiplicados por todos os pax ativos. Solução: revise se o cadastro do custo é mesmo por passageiro ou se deveria ser fixo.

Onde encontrar

• URL: /admin/excursoes/{excursao}/financeiro/relatorio
• Caminho no menu: abra Operacional > Excursões, escolha a excursão, use a navegação Financeiro dentro da excursão e em seguida Relatório Financeiro.
• Permissão necessária: ver as viagens
• Módulo necessário: Gestão Financeira para os cards de lucro e margem; o relatório básico (receita, recebido, a receber, extrato simples, custos detalhados) funciona mesmo sem o módulo.

Veja também

• Visão Geral do Financeiro
• Dashboard Financeiro
• Contas a Pagar
• Transações Financeiras