Financeiro - Visão Geral do Módulo

O que é

O Financeiro é o módulo de gestão financeira do Viagilize. Reúne, em um único lugar, todo o controle do dinheiro da operação: as contas onde o dinheiro fica (caixa, banco, cartão), a classificação das movimentações (categorias de receita e despesa), o lançamento de receitas e despesas, o controle de contas a pagar e a receber, e os painéis e relatórios que mostram a saúde financeira do negócio.

O módulo só aparece no sidebar quando o módulo Gestão Financeira está ativo no plano da sua empresa e o usuário tem a permissão de ver o financeiro. A partir daí, o item Gestão Financeira abre o dashboard e dá acesso aos submenus de Contas, Categorias, Transações, Contas a Pagar, Contas a Receber, DRE e demais relatórios.

Como usar

Use o módulo seguindo esta ordem na primeira configuração:

1. Vá em Módulos > Gestão Financeira no sidebar para abrir o dashboard inicial em /admin/financeiro.
2. Cadastre as Contas (caixa, conta corrente, cartão, investimento) em Financeiro > Contas. Sem conta cadastrada não é possível lançar movimentações.
3. Crie as Categorias de receita e despesa em Financeiro > Categorias para classificar os lançamentos e alimentar os relatórios por categoria.
4. Registre as Transações (receitas, despesas e transferências) em Financeiro > Transações, confirmando cada lançamento para que afete o saldo da conta.
5. Controle compromissos futuros em Financeiro > Contas a Pagar e Financeiro > Contas a Receber, com baixa por pagamento ou recebimento.
6. Acompanhe os indicadores no Dashboard (KPIs do mês, fluxo de caixa dos últimos 6 meses, saldo por conta, próximos vencimentos, vencidos e recebíveis de passageiros) e analise resultados em DRE e no Relatório Financeiro da Excursão.

Casos especiais

Módulo não aparece no sidebar

O item Gestão Financeira só é exibido quando o módulo gestao-financeira está habilitado no plano. Se o menu não aparece, você precisa ativar o módulo. Tentativas de acessar /admin/financeiro sem o módulo são bloqueadas pelo uma trava de acesso.

Conta em moeda estrangeira

O dashboard detecta contas com moeda estrangeira e busca a cotação atual via CotacaoCambioService para exibir os saldos convertidos. Não há configuração manual - basta que a conta esteja marcada como moeda estrangeira no cadastro.

Auditoria de sincronia com vendas

O dashboard expõe um widget de saúde da sincronia entre vendas e financeiro (endpoint financeiro.api.saude-sincronia), que roda a auditoria sob demanda e mostra inconsistências entre os pagamentos das excursões e os lançamentos financeiros correspondentes.

Permissões granulares por subárea

Além de ver o financeiro, cada submenu tem sua própria permissão (financeiro.contas, financeiro.categorias, financeiro.transacoes, financeiro.contas-pagar, financeiro.contas-receber) e há permissões específicas para confirmar transação (financeiro.transacoes.confirmar), pagar conta (financeiro.contas-pagar.pagar) e receber conta (financeiro.contas-receber.receber). Usuários sem a permissão de uma subárea não veem o respectivo item.

Erros comuns e como resolver

• "Módulo Financeiro indisponível" / página retorna 403 ao abrir /admin/financeiro - Causa: módulo gestao-financeira desativado no plano da sua empresa. Solução: ativar o módulo na assinatura ou consultar o suporte comercial.
• Menu Financeiro não aparece para um usuário específico - Causa: o usuário não tem a permissão de ver o financeiro no papel. Solução: ajustar o papel em Configurações > Perfis e Permissões incluindo ver o financeiro e, se necessário, as permissões dos subitens.
• Saldo da conta não muda após lançar transação - Causa: a transação está com status Pendente e ainda não foi confirmada. Solução: abrir a transação e clicar em Confirmar para efetivar a baixa no saldo.

Onde encontrar

• URL: /admin/financeiro
• Caminho no menu: Módulos > Gestão Financeira
• Permissão necessária: ver o financeiro (subáreas exigem permissões específicas, ver acima)
• Módulo necessário: gestao-financeira

Veja também

• Dashboard Financeiro
• Contas Bancárias
• Categorias Financeiras
• Transações Financeiras
• Contas a Pagar
• DRE - Demonstração de Resultado
• Relatório Financeiro da Excursão