Lista de Contas Bancárias / Caixa
Módulo: Financeiro Caminho na aplicação: Menu > Financeiro > Contas Bancárias / Caixa (/financeiro/contas-bancarias) Última atualização: 23/04/2026
Para que serve
Centraliza todas as contas onde o dinheiro do tenant transita: contas bancárias (corrente e poupança), caixas físicos (dinheiro em espécie) e carteiras diversas (vale, carteiras digitais, etc.). Exibe o saldo atual calculado em tempo real para cada conta, somando saldo inicial + baixas de contas a receber/pagar + movimentos avulsos (entradas, saídas e transferências).
Quem pode usar
Usuários com acesso ao módulo Financeiro.
Como usar (passo a passo)
- Acesse Menu > Financeiro > Contas Bancárias / Caixa.
- Use a busca para localizar uma conta por código, banco, agência, conta ou descrição.
- Clique em Nova conta para criar.
- Clique no ícone Editar (lápis) na coluna de ações para abrir o Cadastro de Conta Bancária / Caixa em modo edição.
- Clique no ícone Remover (lixeira) para desativar uma conta sem movimentações. Contas com baixas de CR/CP ou movimentos financeiros não podem ser removidas — inative-as no cadastro.
- A lista carrega mais registros ao rolar (scroll infinito, lotes de 50).
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Código, banco, agência, conta ou descrição | Filtra em tempo real |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Código | Apelido curto da conta (ex.: CB1, CAIXA-MATRIZ). Gerado automaticamente como CB<id_interno> quando não informado |
| Tipo | Tag colorida indicando o tipo: Corrente (azul 🏦), Poupança (verde 🏦), Caixa (dourado 💰), Outros (cinza 📦) |
| Banco | Código FEBRABAN (tag azul) + nome do banco. Exibe "—" quando a conta não é bancária (Caixa ou Outros) |
| Descrição | Apelido descritivo (ex.: "Itaú Matriz Corrente", "Caixa Matriz") |
| Agência / Conta | Agência e conta formatadas (0000-0 / 00000000-0). Exibe "—" quando não há dados bancários |
| Filial | Filial proprietária da conta |
| Saldo atual | Saldo calculado em tempo real (R$ pt-BR). Em vermelho quando negativo |
| Situação | Tag "Ativa" (verde) ou "Inativa" (cinza) |
| Ações | Editar (lápis) e Remover (lixeira) |
Validações e regras
- O saldo atual é uma função calculada, não persistida. Fórmula:
saldo_inicial + (baixas CR do tipo "baixa") − (estornos CR) − (baixas CP do tipo "baixa") + (estornos CP) + (entradas/transferências recebidas em Movimentos) − (saídas/transferências enviadas em Movimentos). - Contas inativas continuam aparecendo na listagem com tag cinza; apenas as ativas aparecem nos seletores das demais telas (baixas, movimentos, liquidação automática).
- Não é possível remover uma conta que tenha baixas de CR/CP ou movimentos financeiros vinculados — o sistema bloqueia com erro 422. Inative-a no cadastro.
- O scroll infinito usa
limit=50por página (default do endpoint).
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar contas bancárias" | Falha de comunicação com a API | Verifique a conexão e recarregue a página |
| "Conta bancaria possui movimentacoes e nao pode ser removida — inative-a em vez disso" | Conta tem baixas de CR/CP vinculadas | Abra o cadastro e desmarque "Ativa" |
| "Conta bancária removida com sucesso" | Confirmação de sucesso | — |
Integrações e dependências
- Serviço:
contasBancariasService(contas-bancarias.service) - Saldo calculado por
movimentosFinanceirosService.saldosPorContas(agregações em lote viagroupBypara evitar N+1) - Referenciada por: Baixas de Contas a Receber, Baixas de Contas a Pagar, Movimentos de caixa/banco, Fluxo de Caixa (filtro) e Forma de Pagamento com liquidação automática
Dúvidas frequentes
Qual a diferença entre "Caixa" e "Corrente"? Conta Corrente (ou Poupança) é uma conta real de banco, com agência, número e código FEBRABAN — usada para receber PIX, TED, boleto etc. Caixa é dinheiro em espécie que fica fisicamente na empresa; não tem dados bancários. Use Caixa para registrar o cofre/gaveta do balcão.
Posso ter múltiplos caixas? Sim. Uma filial pode ter "Caixa Balcão", "Caixa Escritório", "Caixa Viagem" etc. Cada um é uma conta própria com saldo independente.
Quando usar "Outros"? Para contas que não são nem bancárias tradicionais nem dinheiro físico: carteiras digitais (PicPay, PayPal), cartões vale (Alelo, Sodexo), ou qualquer recipiente de saldo que o cliente precisa controlar separadamente.
O saldo inicial é o saldo atual? Não. O saldo inicial é o ponto de partida — o valor que a conta tinha no momento do cadastro. O saldo atual (coluna da listagem) é o saldo inicial + toda a movimentação acumulada depois.
Histórico de alterações
| Data | Alteração |
|---|---|
| 23/04/2026 | Documento inicial criado. Inclui suporte a contas Caixa (sem dados bancários) e Outros, além da coluna "Saldo atual". |