Financeiro - Dashboard

O que é

O Dashboard Financeiro e a página inicial do modulo de Gestão Financeira. Ele consolida em uma so tela os principais indicadores do mês selecionado (receitas, despesas, resultado e saldo em contas), o grafico de fluxo de caixa dos ultimos 6 meses, a lista de contas bancarias com seus saldos, os proximos vencimentos e contas vencidas, os recebiveis pendentes de passageiros, as cotacoes do dia das moedas estrangeiras usadas em contas e um widget de auditoria da sincronia entre vendas e financeiro.

O usuário normalmente chega aqui ao clicar em Financeiro no menu lateral, logo no início do dia, para ter uma leitura rapida da saude financeira da empresa antes de operar lancamentos, conciliar contas a pagar ou conferir recebimentos de passageiros.

Como usar

1. Va em Financeiro no menu lateral. A página abre ja no mês corrente.
2. No topo, use o seletor Mês (dropdown a esquerda) para escolher outro período. Apenas meses que possuem transacoes lancadas aparecem na lista; o mês atual e sempre incluido. Ao trocar, a página recarrega automaticamente com os novos indicadores.
3. Confira os quatro KPIs no topo:
   • Receitas - total de entradas confirmadas no mês selecionado. Mostra a variacao percentual em relacao ao mês anterior (seta verde para alta, vermelha para queda).
   • Despesas - total de saidas confirmadas no mês, também com variacao vs. mês anterior.
   • Resultado - receitas menos despesas. Fica verde quando positivo e vermelho quando negativo, com o icone correspondente.
   • Saldo em Contas - soma dos saldos atuais de todas as contas ativas. O link Ver contas leva a listagem completa de contas bancarias.
4. Se houver alertas, eles aparecem em cards coloridos logo abaixo dos KPIs:
   • Contas Vencidas (vermelho) - soma das contas a pagar em atraso. Use Ver contas vencidas para abrir a lista filtrada.
   • Proximos Vencimentos (ambar) - quantidade de contas que vencem nos proximos 7 dias. Use Ver contas a pagar para abrir a fila.
5. Analise o grafico Fluxo de Caixa (lado esquerdo). Barras verdes representam receitas e barras vermelhas representam despesas dos ultimos 6 meses, com tooltip mostrando o valor exato em reais.
6. No card Contas (lado direito do grafico) veja todas as contas cadastradas com o saldo atual e o tipo (Caixa, Banco, etc.). Contas em moeda estrangeira mostram a conversao aproximada para reais abaixo do saldo. O link Ver todas leva para a listagem completa.
7. Se você tiver contas em moeda estrangeira, o bloco Cotacoes do Dia exibe a cotacao de compra e venda de cada moeda usada, com variacao do dia e minima/maxima (fonte AwesomeAPI).
8. Os dois cards inferiores resumem pendencias:
   • Contas a Pagar - ate 5 contas entre vencidas e proximas a vencer, com fornecedor, vencimento e valor restante. O atalho Nova abre o cadastro de uma nova conta a pagar.
   • Recebiveis de Passageiros - ate 5 pendencias de passageiros que ainda devem dinheiro a empresa, mostrando cliente, excursão e valor pendente. O valor total agregado aparece no canto direito do titulo.
9. Use o card Ações Rapidas no rodape para criar lancamentos sem sair do dashboard: Nova Receita, Nova Despesa, Nova Conta a Pagar e Transferência.
10. No card Saude da Sincronia (rodape) clique em Auditar agora para rodar a verificacao sob demanda. O widget detecta divergencias entre vendas (excursões, passeios, ingressos) e o modulo financeiro.

Casos especiais

empresa sem transacoes lancadas

Quando ainda não ha nenhuma transacao registrada, o seletor de mês mostra apenas o mês corrente. O grafico de fluxo de caixa fica vazio e o card Contas exibe um estado vazio com o botao Criar conta apontando para o cadastro de uma nova conta bancaria.

Contas em moeda estrangeira

Se alguma conta esta em USD, EUR ou outra moeda estrangeira, o sistema busca as cotacoes do dia automaticamente via serviço de cambio. Cada conta passa a exibir, abaixo do saldo na moeda original, o equivalente aproximado em reais (≈ R$ ...). O bloco Cotacoes do Dia so aparece quando ha pelo menos uma moeda estrangeira em uso.

Filtro por mês via URL

E possível abrir o dashboard ja em um mês especifico passando ?mes=MM-AAAA na URL (ex.: /admin/financeiro?mes=5-2026). O parametro também aceita o formato antigo ?mes=MM&ano=AAAA. Util para favoritar ou compartilhar o painel de um período especifico.

Auditoria com modulo financeiro inativo

O widget Saude da Sincronia pode ser rodado mesmo em empresas sem o módulo de Gestão Financeira ativo - nesse caso, ele retorna a mensagem Modulo de gestao financeira nao esta ativo neste tenant. em vez de inconsistencias.

Inconsistencias detectadas

Quando a auditoria encontra divergencias, o widget lista as categorias afetadas: pagamentos confirmados sem transacao, contas a receber orfas, vendas canceladas sem estorno, categorias do sistema faltando e vendas confirmadas sem receita. A correcao e feita pelo time tecnico via comando php artisan financeiro:reconciliar --tenant=<ID> (a mensagem aparece dentro do proprio card).

Erros comuns e como resolver

• "Falha ao auditar sincronia financeira" - Causa: a chamada AJAX para /admin/financeiro/api/saude-sincronia falhou (rede, sessão expirada ou erro no servidor). Solucao: clicar em Auditar agora novamente; se persistir, recarregar a página para renovar o token CSRF.
• Card "Contas" vazio mesmo com lancamentos antigos - Causa: não ha conta bancaria cadastrada (ou todas estao inativas). Solucao: usar o botao Criar conta dentro do proprio card vazio para cadastrar a primeira conta.
• Mês selecionado não aparece no seletor - Causa: o dropdown lista apenas meses com transacoes. Solucao: lancar a primeira transacao do período (Receita ou Despesa) - o mês passa a aparecer no seletor a partir do próximo carregamento.

Onde encontrar

• URL: /admin/financeiro
• Caminho no menu: Financeiro
• Permissão necessária: ver o financeiro
• Módulo necessário: gestao-financeira

Veja também

• Visao Geral do Financeiro
• Contas Bancarias
• Transacoes Financeiras
• Contas a Pagar
• Categorias Financeiras