Excursões - Financeiro da Excursão

O que é

O Financeiro da Excursão é o painel consolidado de uma viagem específica. Ele soma o que cada passageiro deve, o que já foi pago, os custos lançados em Contas a Pagar vinculadas à excursão e calcula o lucro esperado, o lucro atual (recebido menos pago) e a margem.

O usuário normalmente chega aqui depois de cadastrar passageiros e custos, para saber quanto a viagem rendeu, quanto ainda falta receber e se ela é lucrativa. A URL /admin/excursoes/{excursao}/financeiro redireciona para a lista de passageiros (onde os pagamentos individuais são lançados) e o relatório consolidado fica em /admin/excursoes/{excursao}/financeiro/relatorio, acessado pela aba Financeiro dentro da navegação da excursão.

Como usar

1. Vá em Excursões no menu lateral e abra a excursão desejada.
2. Na barra de navegação interna da excursão, clique em Financeiro.
3. Leia os quatro cards do topo:
   • Receita Total - soma do valor cobrado de todos os passageiros não cancelados nem transferidos.
   • Recebido - soma de pagamentos confirmados (não estornados), com o percentual sobre a Receita Total.
   • A Receber - pendente, com a contagem de passageiros pendentes e parciais.
   • Custos Totais - soma das contas a pagar vinculadas à excursão, com o quanto ainda está a pagar.
4. Confira o Extrato de Resultado: Receita Total menos Custos Totais igual a Lucro Estimado, com a margem em percentual.
5. Se o módulo Gestão Financeira estiver ativo, aparecem três cards extras: Lucro Esperado, Lucro Atual (recebido menos custos pagos) e Margem de Lucro.
6. Use o card Pagamentos por Forma para ver a distribuição entre Dinheiro, PIX, Cartão de Débito, Cartão de Crédito, Transferência, Boleto e Link de Pagamento.
7. Use o card Custos por Categoria para ver onde está concentrado o gasto da viagem.
8. Revise os Últimos Pagamentos Recebidos (mostra 10 por padrão). Se houver mais, clique em Ver todos os {N} pagamentos para listar tudo, ou em Ver apenas os últimos 10 para colapsar de volta.
9. Confira Custos Detalhados para ver cada conta a pagar com fornecedor, descrição, categoria, vencimento, status e valor. Quando o custo é variável, o valor unitário aparece multiplicado pelos passageiros ativos (ex.: R$ 56,00 × 30 pax).
10. Veja o Status dos Passageiros no rodapé: contagens de Pagos, Parcial e Pendentes.
11. Para exportar, clique em Exportar PDF no canto superior direito - o sistema usa o Gotenberg quando disponível; senão, faz fallback para DomPDF.

Casos especiais

Caixa em Dinheiro (opcional)

Quando você ativa Caixa em Dinheiro em Configurações > Empresa, um card extra aparece somando os pagamentos recebidos em dinheiro e subtraindo os custos pagos. O modo de dedução é configurável:

• dinheiro - subtrai apenas custos pagos com a forma de pagamento "dinheiro".
• todos - subtrai todos os custos pagos da excursão, independente da forma.

O saldo é exibido em verde quando positivo e em vermelho quando negativo.

Custos variáveis × custos fixos

A agregação expande custos variáveis pelo número de passageiros ativos (não cancelados nem reembolsados), igual à aba Custeio > Rentabilidade Real. Custos fixos (ex.: fretamento) entram pelo valor cheio. Custos sem tipo_custo definido (lançamentos manuais antigos) são tratados como fixos, para compatibilidade.

Acesso pela URL canônica

/admin/excursoes/{excursao}/financeiro é um redirecionamento para a aba Passageiros da excursão - é lá que cada pagamento, desconto, acréscimo, estorno e reembolso é registrado. O relatório consolidado descrito acima fica em /admin/excursoes/{excursao}/financeiro/relatorio.

Sem o módulo Gestão Financeira

Os cards de Lucro Esperado, Lucro Atual e Margem de Lucro (gradientes coloridos) não aparecem. O Extrato de Resultado simples (Receita − Custos = Lucro Estimado) e os totais continuam disponíveis. No rodapé, um banner verde sugere ativar o módulo.

Exportar todos os pagamentos

Para mostrar todos os pagamentos em vez de só os últimos 10, acesse /admin/excursoes/{excursao}/financeiro/relatorio?todos=1 ou clique no link Ver todos os {N} pagamentos no cabeçalho do card.

Erros comuns e como resolver

• Margem aparece diferente da aba Custeio - Causa: custos variáveis sem tipo_custo definido sendo tratados como fixos. Solução: abrir a aba Custeio da excursão, editar o custo e marcar como variável para que seja multiplicado pelos passageiros ativos.
• "Nenhum pagamento registrado" - Causa: a excursão ainda não tem pagamentos confirmados e não estornados. Solução: ir em Passageiros, abrir um passageiro e usar Registrar Pagamento.
• "Nenhum custo registrado" - Causa: não há FinContaPagar vinculada à excursão. Solução: clicar em Adicionar custo no estado vazio ou ir em Gerenciar custos (aba Custeio da edição da excursão).
• PDF não baixa ou volta em branco - Causa: Gotenberg fora do ar e fallback DomPDF com layout pesado. Solução: tentar novamente; se persistir, abrir o relatório na tela e usar a impressão do navegador como alternativa.
• Total "Recebido" menor que a contagem de "Pagos" no rodapé - Causa esperada: cortesias (R$ 0), ajustes manuais e pagamentos agrupados (uma transação para múltiplos assentos) contam como passageiro pago mas geram menos linhas de transação. Não é erro - está documentado no próprio card.

Onde encontrar

• URL: /admin/excursoes/{excursao}/financeiro
• URL do relatório consolidado: /admin/excursoes/{excursao}/financeiro/relatorio
• Caminho no menu: Excursões > (abrir excursão) > aba Financeiro
• Permissão necessária: ver as viagens
• Módulo necessário: nenhum (o relatório básico funciona sem módulo; o módulo Gestão Financeira desbloqueia os cards de Lucro Esperado, Lucro Atual e Margem)

Veja também

• Gerenciar Passageiros
• Categorias e Preços
• Relatórios Consolidados
• Visão Geral de Excursões