Movimentos de Caixa / Banco
Módulo: Financeiro Caminho na aplicação: Menu > Financeiro > Movimentos Caixa/Banco (/financeiro/movimentos) Última atualização: 23/04/2026
Para que serve
Registra entradas, saídas e transferências de dinheiro que não passam por Contas a Receber ou Contas a Pagar. Serve para:
- Entradas avulsas: receitas eventuais que não geram CR (venda de sucata em dinheiro, gorjeta recebida).
- Saídas avulsas — despesas de pronto pagamento: lanche da equipe, frete do motoboy, combustível, material de escritório, manutenção pequena — pagas direto do caixa sem emitir CP.
- Transferências entre contas: sangria (caixa → banco), suprimento (banco → caixa, para formar troco), transferências entre bancos próprios.
Cada movimento afeta imediatamente o saldo da(s) conta(s) envolvida(s) e aparece no Fluxo de Caixa.
Quem pode usar
Usuários com acesso ao módulo Financeiro.
Como usar (passo a passo)
Registrar uma entrada
- Clique em Entrada (verde).
- No modal, informe filial, data, conta de destino (onde o dinheiro entra), valor, categoria (opcional), descrição.
- Clique em Registrar.
Registrar uma saída
- Clique em Saída (vermelho).
- No modal, informe filial, data, conta de origem (de onde o dinheiro sai), valor, categoria (opcional), descrição.
- Clique em Registrar.
Registrar uma transferência
- Clique em Transferência (azul).
- No modal, informe filial, data, conta de origem e conta de destino (devem ser diferentes), valor, descrição.
- O mesmo valor é subtraído da origem e somado no destino, em um evento único e atômico.
- Clique em Registrar.
Filtrar
Use os campos de filtro no topo: busca livre (descrição/número), filial, conta (mostra movimentos em que a conta é origem OU destino), tipo (entrada/saída/transferência), categoria e período.
Editar
Clique no ícone Editar na coluna de ações. É possível alterar data, valor, categoria, descrição, forma de pagamento e observações. Tipo, filial e contas origem/destino não podem ser alterados em edição — se precisar, remova e registre novamente.
Remover
Clique no ícone Remover (lixeira) e confirme. Soft delete — o movimento some da lista e deixa de impactar o saldo, mas fica preservado para auditoria.
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Texto da descrição, número ou categoria | Filtra em tempo real |
| Filial | Não | Lista | Padrão: todas |
| Conta | Não | Lista de contas cadastradas | Mostra todos os movimentos da conta (como origem ou destino) |
| Tipo | Não | Entrada, Saída ou Transferência | — |
| Categoria | Não | Lista das categorias já usadas no tenant | Autocomplete com as mais usadas |
| Período | Não | Intervalo de datas (DD/MM/AAAA) | — |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Data | DD/MM/AAAA |
| Nº | Número do documento (auto: MF<id_interno> se vazio) |
| Tipo | Tag colorida com ícone: Entrada (verde ⬆️), Saída (vermelho ⬇️), Transferência (azul ⇄) |
| Descrição | Texto livre + tag da categoria embaixo, quando houver |
| Contas | Conta afetada (entrada/saída) ou fluxo Origem → Destino (transferência) |
| Valor | R$ colorido por tipo (verde entrada, vermelho saída, azul transferência) |
| Ações | Editar (lápis) e Remover (lixeira) |
Modal — Registrar/Editar movimento
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Filial | Sim | Filial proprietária do movimento | Desabilitado em edição |
| Tipo | Sim | Entrada, Saída ou Transferência | Desabilitado em edição |
| Data | Sim | DD/MM/AAAA | Pré-preenchida com hoje |
| Conta de origem | Sim (saída e transferência) | Conta ativa da filial selecionada | Somente contas da filial selecionada aparecem |
| Conta de destino | Sim (entrada e transferência) | Conta ativa da filial selecionada | Em transferência, deve ser diferente da origem |
| Valor | Sim | Valor em R$ maior que zero | — |
| Categoria | Não | Texto livre com autocomplete | Ex.: "Frete", "Alimentação", "Material de escritório", "Combustível" |
| Forma de pagamento | Não | Lista de formas ativas | Informativa |
| Descrição | Sim | Texto livre (até 500 caracteres) | Ex.: "Lanche equipe comercial", "Motoboy pedido PV123" |
| Observações | Não | Texto livre (até 1000 caracteres) | — |
Validações e regras
- Entrada exige conta de destino.
- Saída exige conta de origem.
- Transferência exige origem e destino, e elas devem ser diferentes.
- A conta selecionada deve pertencer à filial selecionada. Se não pertencer, o backend recusa com "Conta bancaria pertence a outra filial".
- Contas inativas ou deletadas não podem ser usadas — o sistema recusa com "Conta bancaria inativa" ou "Conta bancaria nao encontrada".
- O valor deve ser positivo (> 0). O sinal (entrada/saída) é definido pelo tipo, não pelo valor.
- Em transferências, o efeito é atômico: se a transação falhar, nem origem nem destino são afetados.
- Categorias são texto livre, mas o autocomplete sugere categorias já usadas no tenant — mantenha nomenclatura consistente para relatórios úteis.
- Movimentos deletados (soft delete) deixam de contar no saldo da conta e não aparecem na listagem/relatórios, mas permanecem no banco para auditoria.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Valor deve ser maior que zero" | Campo valor com 0 ou negativo | Informe um valor positivo |
| "Conta de destino obrigatoria para entrada" | Entrada sem conta de destino | Selecione a conta |
| "Conta de origem obrigatoria para saida" | Saída sem conta de origem | Selecione a conta |
| "Conta de origem obrigatoria para transferencia" / "Conta de destino obrigatoria para transferencia" | Transferência incompleta | Selecione ambas as contas |
| "Conta de destino deve ser diferente da origem" | Transferência com a mesma conta nos dois lados | Escolha contas diferentes |
| "Conta bancaria nao encontrada" | ID inválido ou conta de outro tenant | Recarregue e selecione novamente |
| "Conta bancaria inativa" | Conta foi desativada | Reative ou escolha outra conta |
| "Conta bancaria pertence a outra filial" | Conta selecionada não é da filial | Mude a filial ou a conta |
| "Movimento registrado com sucesso" / "Movimento atualizado com sucesso" / "Movimento removido" | Confirmação de sucesso | — |
Integrações e dependências
- Serviço:
movimentosFinanceirosService(movimentos-financeiros.service) - Contas selecionáveis vêm de Contas Bancárias / Caixa
- Formas de pagamento vêm de Formas de Pagamento (opcional, apenas informativo neste fluxo)
- Todos os movimentos alimentam o Fluxo de Caixa e afetam o Saldo atual da conta na Lista de Contas Bancárias / Caixa
- Transferências são neutras no consolidado do Fluxo de Caixa — só aparecem quando há filtro por conta específica
Dúvidas frequentes
Quando usar Movimento avulso e quando usar Conta a Pagar? Use Conta a Pagar quando o fornecedor gerou nota/duplicata com prazo (mesmo que você pague à vista no ato — a obrigação existiu). Use Movimento avulso > Saída para pequenas despesas sem documento fiscal/duplicata (lanche, estacionamento, motoboy avulso). O critério prático: se não faz sentido gerar CP, é movimento avulso.
Como faço a sangria do caixa para o banco? Registre uma Transferência com conta de origem = Caixa e conta de destino = Conta Bancária. O saldo do caixa cai e o saldo do banco sobe. Pronto — sem precisar criar CR ou CP.
Posso anexar o recibo? O modelo suporta o campo comprovante_url (upload para S3), mas a UI ainda não expõe upload na versão atual — vai ser adicionada em iteração futura.
E se o movimento foi lançado errado? Edite (para ajustar valor/descrição/data) ou remova e lance de novo (para corrigir tipo ou contas). A remoção é soft — o valor volta imediatamente para o saldo.
Como apuro "quanto gastei com motoboy neste mês"? Filtre por: categoria = "Frete" (ou "Motoboy", como você cadastrou), tipo = Saída, período do mês. O total aparece no rodapé (
Histórico de alterações
| Data | Alteração |
|---|---|
| 23/04/2026 | Documento inicial criado. Suporta entradas avulsas, saídas avulsas e transferências atômicas entre contas. |