Contas Financeiras: gestão de caixas, contas bancárias e carteiras

A tela de Contas Financeiras é onde são cadastradas todas as contas bancárias, caixas físicos e carteiras operacionais da clínica, servindo de destino para os recebimentos e origem dos pagamentos.

Como acessar

No menu do CRM, acesse Financeiro → Cadastros → Contas Financeiras (rota /app/contas).

Permissões necessárias: O acesso à tela exige a permissão financeiro.contas e o módulo financeiro. A criação e edição de contas exigem a permissão financeiro.contas.gerenciar.

Tipos de contas financeiras (TipoConta)

Ao cadastrar uma conta, você deve selecionar seu tipo:

1. Caixa (caixa): Caixa físico em dinheiro da recepção ou balcão da clínica.
2. Banco (banco): Conta corrente ou poupança em instituição financeira (ex: Itaú, Bradesco, Banco do Brasil, Santander, Nubank).
3. Carteira Digital (carteira_digital): Conta de pagamentos online (ex: Mercado Pago, PicPay).
4. Maquininha / Adquirente (maquininha): Conta transitória de recebimentos de adquirentes ou gateways.

Campos do cadastro

O cadastro abre em uma página própria (/app/contas/new ou /app/contas/:contaId). Para uma conta manual, informe:

• Nome da Conta: Identificação interna (ex: “Conta Corrente Itaú”, “Caixa Recepção 01”).
• Tipo de Conta: Seleção do tipo (Caixa, Banco, Carteira ou Maquininha).
• Banco: instituição financeira, quando aplicável.
• Agência e Conta Corrente: Dados bancários de identificação da conta.
• Saldo Inicial: valor de abertura da conta ao iniciar o uso do CRM. Aceita saldo positivo, zero ou negativo.
• Exigir conciliação: define se a conta deve ser comparada com um extrato externo.
• Cor: identificação visual da conta.
• Status (Ativo / Inativo): Interruptor para ativar ou desativar a conta.

Ao criar uma conta, a tela permite escolher uma conta manual ou iniciar uma configuração integrada. Conforme o tipo e a disponibilidade da clínica, existem configurações para Asaas, Sicredi, Itaú, PagoLivre, Afinz e Payer. Credenciais e testes de conexão aparecem somente para a integração escolhida.

Como definir o saldo inicial corretamente

O Saldo Inicial deve representar o saldo da conta imediatamente antes da primeira movimentação que será registrada no CRM. Por exemplo: se o primeiro lançamento importado é de 1º de setembro, use o saldo bancário ao final de 31 de agosto.

Não informe o saldo atual do banco e depois importe todas as movimentações que formaram esse saldo. Isso contabilizaria o mesmo período duas vezes.

Se a conta estava devedora, por exemplo no cheque especial, informe o sinal de menos: -500 ou -500,00 para um saldo de menos R$ 500,00. Também é possível colar -R$ 500,00, R$ -500,00 ou (500,00). Confira se o sinal negativo permanece no campo antes de salvar.

Campos de preço, parcela, pagamento e desconto não aceitam valores negativos. Ao tentar informar um negativo, o campo mostra “Valor não pode ser negativo” e não substitui o último valor aceito por um positivo. Apague ou corrija a entrada antes de continuar. Em lançamentos, informe o valor positivo e escolha Entrada ou Saída para indicar o sentido da movimentação.

Ajustar o saldo de abertura de uma conta existente

O saldo de abertura pode ser corrigido depois da criação quando a conta for bancária, manual e estiver ativa. A opção não aparece em caixas, carteiras, maquininhas, contas inativas ou contas conectadas a uma integração bancária.

Para fazer o ajuste:

1. Acesse Financeiro → Cadastros → Contas Financeiras.
2. Na conta desejada, clique em Editar.
3. Na seção Saldo de abertura, clique em Ajustar saldo de abertura.
4. Informe o novo valor. Ele pode ser positivo, zero ou negativo.
5. Preencha o motivo do ajuste.
6. Confira a Diferença aplicada e o Novo saldo atual antes de confirmar.

É necessário ter permissão para gerenciar contas financeiras. O sistema calcula a diferença entre o saldo de abertura anterior e o novo valor e aplica somente essa diferença ao saldo atual. Por exemplo: se o saldo de abertura passar de R$ 0,00 para R$ 500,00, o saldo atual aumenta R$ 500,00.

O ajuste preserva todos os lançamentos existentes e não cria uma entrada ou saída pendente de conciliação. O motivo, o responsável e os valores anterior e novo ficam registrados para auditoria.

Clique em Ver histórico, ao lado do ajuste, para consultar todos os ajustes, inclusive de meses anteriores. Cada registro mostra data e hora, responsável, valor anterior, valor novo, diferença e motivo. O histórico também pode ser consultado quando a conta estiver inativa.

No Extrato, os ajustes aparecem em linhas destacadas no período em que foram feitos. Eles não compõem os totais de receitas ou despesas e não ficam pendentes de conciliação. Para vê-los, mantenha os filtros de tipo e vínculo em Todos; o filtro de origem pode estar em Todos ou Manual.

Use essa opção somente para corrigir a base anterior ao primeiro lançamento do extrato. Uma entrada ou saída que realmente aconteceu no banco deve ser registrada ou importada como movimentação, e não como saldo de abertura. Não crie uma nova conta e não reimporte o extrato para compensar a diferença.

Em contas integradas, o saldo pode ser obtido diretamente do provedor. Nesses casos, siga o saldo da integração e evite ajustes manuais sem antes confirmar a origem da divergência.

Ações e cartões de resumo (ContasPage)

• Cartões de Saldo: Exibem o Saldo Total Disponível e o Saldo Total Previsto somados entre todas as contas ativas da clínica.
• Botão Extrato: abre /app/contas/:contaId/extrato, com as movimentações daquela conta.
• Editar: abre o cadastro da conta, quando o usuário possui permissão de gestão.
• Ajustar saldo de abertura: aparece na edição de contas bancárias manuais ativas para usuários com permissão de gestão.

O endereço antigo /app/contas-financeiras redireciona para /app/contas.

Excluir ou desativar uma conta

Na edição da conta, Excluir remove o cadastro permanentemente quando não há movimentações ou vínculos que impeçam a remoção. A ação exige permissão para gerenciar contas financeiras.

Saldo inicial e ajustes de abertura, sozinhos, não impedem a exclusão. Ao excluir uma conta sem movimentações nem vínculos operacionais, seus ajustes de abertura e registros auxiliares de auditoria de saldo também são removidos.

Contas com movimentações ou outros vínculos protegidos não podem ser excluídas. A mensagem informa a quantidade e o período dos lançamentos ou o tipo e a quantidade de vínculos encontrados (por exemplo, contas a receber ou formas de pagamento). Revise o vínculo indicado antes de tentar novamente. Nesse caso, o sistema informa o impedimento e preserva a conta e seus registros. Para deixar de usar a conta, desligue Ativo no cadastro e clique em Salvar. Contas inativas deixam de aparecer na seleção de pagamentos e mantêm o histórico.

Para reativar, encontre a conta na lista, clique em Editar, ligue Ativo e salve. A linha esmaecida identifica uma conta inativa; Editar (com permissão de gestão), Extrato e Ver histórico continuam disponíveis.

Guias relacionados

• Movimentações financeiras
• Contas a pagar
• Contas a receber