Financeiro - Contas Bancárias

O que é

A página de Contas Bancárias reúne todas as contas usadas para movimentar o dinheiro da empresa: contas correntes, contas poupança, caixas (dinheiro em espécie), cartões de crédito, cartões de débito e contas de investimento. Cada conta cadastrada vira origem ou destino dos lançamentos feitos em Transações e Contas a Pagar, e o saldo é atualizado automaticamente conforme essas movimentações são confirmadas.

O usuário costuma chegar aqui na primeira configuração do módulo Financeiro (para cadastrar pelo menos uma conta antes de lançar receitas e despesas) e depois recorre à página para acompanhar o saldo consolidado, abrir extratos por período, gerar comprovantes em PDF ou desativar contas que não estão mais em uso.

Como usar

1. Vá em Financeiro > Contas Bancárias no menu lateral (ou abra diretamente /admin/financeiro/contas).
2. No topo da listagem aparece o card Saldo Total (em R$), somando todas as contas ativas - contas em moeda estrangeira são convertidas pela cotação automática do Banco Central.
3. Clique em Nova Conta (botão flutuante no canto superior direito) para abrir o formulário de cadastro.
4. Preencha os campos do bloco Dados da Conta:
   • Nome da Conta - identificação livre exibida nas listagens e nos lançamentos (ex.: "Conta Principal", "Caixa da Loja"). Obrigatório, até 100 caracteres.
   • Tipo de Conta - escolha entre Caixa, Conta Bancária, Cartão de Crédito, Cartão de Débito ou Investimento. Obrigatório e define quais campos extras aparecem.
   • Moeda - padrão BRL (Real Brasileiro). Suporta USD, EUR, GBP, ARS, PYG, UYU, CLP, COP e PEN. Ao escolher moeda diferente do real, o sistema busca a cotação atual e mostra um badge com o valor em R$.
   • Banco, Agência e Número da Conta - opcionais, apenas para identificação.
   • Saldo Inicial - obrigatório, aceita 0,00. Esse valor vira o Saldo atual no momento do cadastro e passa a ser ajustado conforme as transações.
   • Cor de Identificação - define a faixa colorida no topo do card da conta.
5. Se o tipo for Cartão de Crédito, o bloco Configurações do Cartão fica visível com os campos Limite do Cartão, Dia do Fechamento e Dia do Vencimento (números de 1 a 31).
6. No bloco Opções, marque Conta ativa (padrão marcado) e, se quiser, Conta padrão - só uma conta pode ser padrão por vez; ao marcar uma nova, a anterior é desmarcada automaticamente.
7. Conclua em Criar Conta. Para encadear cadastros, use Salvar e Continuar Editando ou Salvar e Criar Nova, ambos no rodapé do formulário.

Editar uma conta existente

1. No card da conta, clique em Editar (botão azul).
2. Os mesmos blocos do cadastro aparecem; o Saldo Inicial não pode mais ser alterado (apenas as transações ajustam o saldo).
3. Salve em Salvar ou Salvar e Continuar Editando.

Ver o extrato e exportar

1. No card da conta, clique em Extrato.
2. Use os campos Data Início e Data Fim para filtrar o período (padrão: mês atual).
3. Clique em Exportar (botão cinza no topo) para abrir o menu com três opções:
   • Visualizar PDF - abre o extrato em nova aba; gerado pelo Gotenberg quando disponível, com fallback automático para DomPDF.
   • Exportar CSV - baixa um .csv com BOM UTF-8, separador ;, pronto para abrir no Excel.
   • Imprimir - abre a versão para impressão em nova aba.

Casos especiais

Conta em moeda estrangeira

Ao escolher uma moeda diferente de BRL, o sistema consulta a cotação no momento do cadastro, salva em taxa_cambio e exibe a equivalência em reais (≈ R$). No card da listagem e no extrato, o saldo aparece na moeda original e a conversão fica logo abaixo. A cotação é atualizada automaticamente quando a conta é listada e ainda não tem taxa registrada.

Cartão de Crédito

Os campos Limite, Dia do Fechamento e Dia do Vencimento só aparecem quando o tipo selecionado é Cartão de Crédito. No card da listagem, o sistema mostra uma barra de uso do limite: até 80% fica em azul, acima disso vira vermelho. O valor disponível é calculado como limite - |saldo atual|.

Conta padrão

A conta marcada como padrão aparece com a tag azul Padrão no card e é pré-selecionada nos novos lançamentos. Sempre que outra conta é marcada como padrão (no cadastro ou na edição), o sistema remove o marcador da anterior - não existe ação separada "Definir como Padrão" nesta página.

Desativar em vez de excluir

Use o menu de três pontos (ícone vertical no canto inferior direito do card) para Desativar Conta. Contas inativas ficam com a opacidade reduzida, deixam de somar no Saldo Total e somem das seleções de lançamento, mas o histórico fica preservado. Para reativar, basta abrir o mesmo menu e clicar em Ativar Conta.

Erros comuns e como resolver

• "Esta conta possui transações e não pode ser excluída. Desative-a em vez disso." - Causa: existe pelo menos uma transação (receita, despesa ou transferência) registrada na conta ou tendo ela como destino. Solução: abra o menu de três pontos do card e use Desativar Conta para retirá-la do uso sem perder o histórico.
• "Cotacao indisponivel" - Causa: a API de câmbio do Banco Central não respondeu ou a moeda escolhida está temporariamente sem cotação. Solução: tente novamente em alguns minutos; enquanto não houver taxa, a conta entra no Saldo Total com valor convertido zero.
• "Moeda invalida" - Causa: tentativa de buscar cotação para um código fora da lista suportada (somente BRL, USD, EUR, GBP, ARS, PYG, UYU, CLP, COP, PEN). Solução: selecione uma das moedas disponíveis no campo Moeda.
• Saldo aparece diferente do esperado - Causa: o saldo só se atualiza com transações confirmadas. Solução: confira em Financeiro > Transações se há lançamentos pendentes que precisam ser confirmados.

Onde encontrar

• URL: /admin/financeiro/contas
• Caminho no menu: Financeiro > Contas Bancárias
• Permissões necessárias: ver o financeiro e financeiro.contas
• Módulo necessário: gestão-financeira (Gestão Financeira)

Veja também

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