Contas bancárias

A tela de Contas bancárias é o cadastro das contas que sua empresa movimenta: o caixa físico, as contas em banco e contas virtuais de controle interno. Toda movimentação financeira — recebimento, pagamento, venda à vista, transferência ou lançamento manual — acontece em uma conta daqui, e é o saldo dela que o extrato reflete.

Além de sustentar o extrato, o cadastro de contas alimenta duas outras rotinas:

• nas formas de pagamento das categorias À vista e Boleto bancário, a conta destino define em qual conta o valor recebido é registrado;
• quando a conta está vinculada a um banco com integração de cobrança, ela pode emitir boletos diretamente pelo sistema — a seção Emissão de boletos deste cadastro configura o convênio bancário usado nessa emissão.

Como acessar

No menu lateral, abra Financeiro › Cadastros › Contas bancárias. Se o item não aparecer, seu perfil de acesso ainda não tem permissão para esse cadastro — peça ao administrador do sistema. O mesmo vale para o botão de criar e para as ações de editar e excluir, que dependem das permissões correspondentes.

A lista de contas

Ao abrir a tela, você vê as contas cadastradas, com as inativas sempre no final da lista, independentemente da ordenação escolhida. Por padrão, a tabela mostra:

• Descrição — o nome ou apelido da conta, como ela aparece nas seleções de lançamento e de forma de pagamento.
• Ativo — um selo Sim ou Não que indica se a conta está disponível para seleção em novos lançamentos e cadastros.
• Instituição financeira — o banco vinculado, do cadastro de instituições financeiras; fica - quando a conta não é bancária (um caixa, por exemplo).
• Tipo de conta — Corrente, Poupança, Pagamento ou Investimento; fica - quando a conta não tem instituição vinculada.
• Agência — o número da agência, com o dígito quando cadastrado (1234-5).
• Conta — o número da conta, com o dígito quando cadastrado (12345-6).

Pelo controle de colunas, você pode exibir também Dígito da agência, Dígito da conta, Criado em e Atualizado em separadamente.

• Busca rápida: procura pela descrição da conta.
• Filtros avançados: refine por Descrição, Ativo, Instituição financeira, Tipo de conta, Agência, Dígito da agência, Conta, Dígito da conta, Criado em e Atualizado em.
• Ordenação: clique no título de qualquer coluna filtrável para ordenar por ela — as contas inativas continuam no final, mesmo assim.

Cadastrar e editar

Use Nova conta bancária, no canto superior direito, para incluir uma conta. Para alterar uma já existente, abra o menu de ações (ícone de três pontos) na linha e escolha Editar. Nos dois casos a janela que abre é a mesma, com o título Nova conta ao criar ou Editar conta ao editar.

Identificação

• Descrição (obrigatório, até 100 caracteres): o nome pelo qual a conta vai aparecer nas seleções de lançamento e de forma de pagamento. Escreva de forma reconhecível — por exemplo, Conta corrente principal.
• Ativo (obrigatório): Sim mantém a conta disponível para seleção em novos lançamentos; Não a esconde das seleções, sem apagá-la. Uma conta nova nasce como Sim.
• Instituição financeira (opcional): o banco da conta, do cadastro de instituições financeiras. A lista oferece apenas instituições ativas; comece a digitar para localizar. Deixe em branco para uma conta que não é bancária — um caixa físico ou uma conta virtual de controle interno, por exemplo.

A instituição decide o que mais aparece

Selecionar uma instituição financeira é o que torna a conta bancária: só então os campos de agência, conta e a opção de emissão de boletos aparecem no formulário. Sem instituição, o cadastro fica só com Descrição e Ativo — é o caso do caixa da empresa e de contas virtuais internas, como as usadas para créditos de cliente. Limpar a instituição de uma conta já bancária remove esses campos e desliga a emissão de boletos, se estivesse ativada.

Quando você seleciona uma instituição financeira, os campos abaixo aparecem:

• Tipo de conta (obrigatório): Corrente, Poupança, Pagamento ou Investimento.
• Agência (obrigatório, até 10 caracteres) e Dígito da agência (opcional, até 2 caracteres): o número da agência no banco, com o dígito verificador quando o banco o usa.
• Conta (obrigatório, até 20 caracteres) e Dígito da conta (obrigatório, até 2 caracteres): o número da conta no banco, com o dígito verificador.
• Emissão de boletos (Sim/Não): ativa a seção de convênio bancário descrita a seguir. Fica bloqueado, com o aviso Instituição sem integração de cobrança, quando o banco selecionado ainda não tem integração de emissão no sistema — hoje, Banco do Brasil e Sicredi.

Emissão de boletos

Ativando Emissão de boletos como Sim, a janela abre a seção de convênio bancário — os dados que o sistema usa para gerar o boleto diretamente com o banco. Os campos pedidos mudam conforme a instituição selecionada.

• Ambiente (obrigatório): Sandbox para testar a integração sem gerar cobrança real, ou Produção para emitir boletos válidos.
• Chave PIX (bolepix) (opcional, até 100 caracteres): a chave PIX associada ao recebimento, quando o banco oferece boleto com QR Code PIX.

Para o Banco do Brasil:

• Número do convênio (obrigatório, até 20 caracteres) e Carteira (obrigatório): o convênio de cobrança e a carteira contratados com o banco. Variação da carteira (opcional, até 10 caracteres) só se aplica quando o seu convênio a exige.
• Client ID (obrigatório, até 255 caracteres) e Client secret (obrigatório): as credenciais OAuth2 da API do banco, obtidas no portal de desenvolvedores.
• Developer application key (obrigatório): a chave de aplicação do Banco do Brasil, exigida junto das credenciais acima.

Para o Sicredi:

• Cooperativa e Posto (obrigatórios, até 10 caracteres cada): identificam sua cooperativa e o posto de atendimento no Sicredi.
• Código beneficiário (obrigatório, até 20 caracteres, somente dígitos): o código que identifica sua empresa como beneficiária no Sicredi.
• API Key (obrigatório): a chave de API (x-api-key) fornecida pelo Sicredi.
• Código de acesso (obrigatório): o código de acesso OAuth2 da conta no Sicredi.
• Notificações automáticas: um controle para ativar ou desativar o webhook que avisa o sistema quando um boleto é pago. Fica disponível depois que você salva o convênio pela primeira vez — antes disso, não há convênio salvo para vincular o webhook.

Credencial salva não aparece de novo

Os campos de credencial (Client secret, Developer application key, API Key e Código de acesso) ficam em branco ao editar uma conta que já tem convênio salvo — o sistema não reexibe o valor, por segurança. O campo mostra que já há uma credencial atribuída; deixe-o em branco para manter a credencial atual, ou preencha um valor novo para substituí-la.

No fim da seção, Encargos e descontos define os valores padrão aplicados aos boletos emitidos por esta conta — todos opcionais:

• Juros mensais (%) e Multa (%): os encargos por atraso no pagamento.
• Dias para desconto e Desconto (%): quantos dias antes do vencimento o desconto vale, e o percentual concedido a quem paga dentro do prazo.

Os mesmos campos sustentam a forma de pagamento Boleto bancário

Ao cadastrar uma forma de pagamento da categoria Boleto bancário, a conta destino exige um convênio bancário ativo — exatamente o que esta seção configura. Sem emissão de boletos ativada aqui, a forma de pagamento recusa a conta ao salvar.

Excluir

Para remover uma conta, abra o menu de ações na linha e escolha Excluir. O sistema pede confirmação mostrando a descrição, a instituição, a agência e a conta, para você não remover o registro errado.

Cuidado

A exclusão remove a conta do cadastro e das seleções de novos lançamentos, mas os lançamentos e vínculos já existentes que a referenciam são preservados — a conta some da lista, não o histórico dela. Prefira desativar (campo Ativo igual a Não) uma conta que ainda tem movimentações ou está vinculada a formas de pagamento; reserve a exclusão para contas criadas por engano ou nunca usadas.

Algumas contas — em geral, cadastradas automaticamente pelo sistema, como a conta interna de créditos de cliente — são protegidas contra edição e exclusão. O menu de ações continua oferecendo Editar e Excluir nelas; ao confirmar, o sistema recusa a operação com o aviso esta conta não pode ser editada.

Dúvidas frequentes

Por que os campos de agência e conta não aparecem?

Eles só aparecem depois que você seleciona uma instituição financeira. Sem instituição, a conta é considerada não bancária — o caso do caixa da empresa ou de contas virtuais internas — e não pede esses dados.

Por que a opção Emissão de boletos está bloqueada?

Ela fica indisponível quando a instituição financeira selecionada ainda não tem integração de cobrança no sistema. Hoje, apenas Banco do Brasil e Sicredi emitem boletos diretamente pela conta; para outros bancos, gere a cobrança pelos meios usuais do próprio banco.

Salvei o convênio, mas os campos de credencial aparecem vazios ao editar de novo.

É esperado. Por segurança, o sistema nunca reexibe uma credencial (Client secret, Developer application key, API Key, Código de acesso) já salva — o campo some, mas a credencial continua ativa. Deixe-o em branco para não alterá-la, ou digite um valor novo para substituí-la.

Não consigo ativar as notificações automáticas do Sicredi.

Esse controle só libera depois que o convênio bancário é salvo ao menos uma vez — antes disso não há um convênio para vincular o webhook. Salve a conta com os dados do convênio Sicredi preenchidos e volte a editá-la para ativar as notificações.

O sistema recusou a conta ao salvar uma forma de pagamento Boleto bancário.

A forma Boleto bancário exige que a conta destino tenha um convênio bancário ativo — ou seja, Emissão de boletos marcada como Sim e os dados do convênio preenchidos nesta tela. Abra a conta, ative a emissão de boletos, complete o convênio e salve; depois volte à forma de pagamento.

Cliquei em Editar ou Excluir e o sistema recusou com o aviso esta conta não pode ser editada.

Algumas contas nascem protegidas pelo sistema — como a conta interna de créditos de cliente — e o sistema recusa qualquer alteração ou exclusão nelas, mesmo que o menu de ações continue oferecendo as opções. Se uma conta que você mesmo criou estiver assim, confira com o administrador do sistema.

Excluí uma conta por engano; os lançamentos dela sumiram?

Não. A exclusão remove a conta das seleções de novos lançamentos, mas preserva os lançamentos e vínculos que já existiam. Ainda assim, prefira desativar em vez de excluir quando a conta já tem uso — assim ela nem chega a sair da lista de contas existentes, só das seleções de novos cadastros.

Não vejo o cadastro no menu nem o botão de criar.

Esse cadastro e suas ações dependem da permissão de contas bancárias no seu perfil de acesso. Se você precisa cadastrar e não vê o item ou o botão, peça o ajuste do seu perfil ao administrador do sistema.