Instituição Financeira
Criado por Igor Ribeiro em 08 de setembro de 2026
Atualizado por Igor Ribeiro em 08 de setembro de 2026
Instituição Financeira
Cadastro central de bancos e instituições financeiras reconhecidas pelo sistema, com formatação de agência, conta e tarja de cheque.
Visão Geral da Instituição Financeira
A rotina “Instituição Financeira” faz parte do módulo Financeiro do ERP, dentro do grupo de Cadastros. Ela mantém o cadastro dos bancos e demais instituições financeiras reconhecidos pelo sistema, junto com as máscaras usadas para exibir o número da agência, o número da conta e a tarja de cheque de cada instituição.
Esse cadastro funciona como uma referência central: sempre que outra rotina do sistema precisa associar um banco a um registro, ela consulta as instituições financeiras cadastradas aqui. Um exemplo comum é o cadastro de uma carteira (banco/caixa) da empresa ou o cadastro de uma forma de cobrança bancária, que exigem a indicação de qual instituição financeira está envolvida.
Manter esse cadastro completo e correto ajuda a garantir que os números de agência, conta e a tarja de cheque apareçam formatados corretamente nas telas do sistema que exibem esses dados bancários.
Vídeo Tutorial da Instituição Financeira
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso da Instituição Financeira
Permissão Necessária
O usuário precisa ter a permissão “ListViewDeInstituicaoFinanceira” associada ao seu perfil de acesso no sistema. Sem essa permissão, a rotina não fica disponível.
Dependências
Não há dependência de outra rotina ou de outro cadastro prévio. É possível cadastrar uma instituição financeira do zero, sem precisar cadastrar antes nenhuma outra informação em outra tela.
⚠️ Atenção: Não foi identificada nenhuma permissão específica separada para incluir, editar, excluir, exportar ou importar instituições financeiras. Tudo indica que essas ações ficam liberadas apenas com a permissão geral de acesso à rotina, mas isso deve ser confirmado com o time responsável antes de ser tratado como regra definitiva.
Processo de Criação: Passo a Passo da Instituição Financeira
Acessar a rotina
O usuário acessa a rotina “Instituição Financeira”, disponível no menu Financeiro > Cadastros, e aciona a opção para incluir um novo cadastro.
Preencher código e nome
O usuário informa o código da instituição financeira (com até 3 caracteres) e o nome da instituição (com até 50 caracteres). Esses dois campos são de preenchimento obrigatório: sem eles, o cadastro não pode ser salvo.
Preencher máscaras (opcional)
O usuário pode, se desejar, informar a máscara de exibição da agência, da conta e da tarja de cheque. Essas máscaras servem para definir como esses números vão aparecer formatados em outras telas do sistema. O preenchimento dessas máscaras não é obrigatório.
Salvar
Ao confirmar o cadastro, o sistema grava a instituição financeira com os dados informados, tornando-a disponível para ser selecionada em outras rotinas do sistema, como o cadastro de carteiras (banco/caixa).
Descrição de Cada Campo da Tela da Instituição Financeira
Código
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: é o identificador único da instituição financeira dentro do sistema, com até 3 caracteres. É esse código que diferencia uma instituição financeira das demais no cadastro.
Comportamento: funciona como a chave do cadastro; é o valor que outras rotinas do sistema usam internamente para localizar e associar essa instituição financeira a um registro.
Impacto: aparece vinculado ao cadastro de carteiras (banco/caixa) e ao cadastro de formas de cobrança bancária, sempre que essas rotinas referenciam a instituição financeira.
Nome
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: é o nome da instituição financeira, com até 50 caracteres, usado para identificar o banco de forma legível para o usuário.
Comportamento: é o campo usado nos filtros de busca da listagem da rotina, permitindo localizar a instituição financeira tanto pelo código quanto pelo nome.
Impacto: é o nome exibido nas telas de seleção de banco/instituição financeira em outras rotinas do sistema, como no cadastro de carteiras.
Máscara de Agência
Tipo: texto
Obrigatoriedade: opcional
Descrição: define o padrão de formatação usado para exibir o número da agência dessa instituição financeira, com até 10 caracteres.
Comportamento: não foi possível confirmar o formato exato aceito neste campo, como por exemplo o uso de zeros à esquerda ou de caracteres coringa para representar a formatação.
Impacto: influencia como o número da agência é exibido nas telas do sistema que mostram dados bancários vinculados a essa instituição financeira.
Máscara de Conta
Tipo: texto
Obrigatoriedade: opcional
Descrição: define o padrão de formatação usado para exibir o número da conta dessa instituição financeira, com até 20 caracteres.
Comportamento: não foi possível confirmar o formato exato aceito neste campo.
Impacto: influencia como o número da conta é exibido nas telas do sistema que mostram dados bancários vinculados a essa instituição financeira.
Máscara de Tarja de Cheque
Tipo: texto
Obrigatoriedade: opcional
Descrição: define o padrão de formatação da tarja (linha magnética) dos cheques emitidos por essa instituição financeira, com até 50 caracteres.
Comportamento: não foi possível confirmar o formato exato aceito neste campo.
Impacto: usado pelas rotinas do sistema que lidam com cheques dessa instituição financeira.
Utilização e Consulta de Registros da Instituição Financeira
O usuário localiza instituições financeiras já cadastradas na grade principal da rotina, informando parte do código ou parte do nome no campo de busca. A grade de resultados é paginada e permite ordenar os registros exibidos, facilitando a localização de uma instituição financeira específica dentro de uma lista com muitos cadastros.
Processo de Edição da Instituição Financeira
Depois que uma instituição financeira é cadastrada, o usuário pode alterar o Nome e as máscaras de Agência, Conta e Tarja de Cheque a qualquer momento.
Não há histórico de alterações visível ao usuário para os cadastros de instituição financeira, segundo a análise realizada.
⚠️ Informações Não Confirmadas:
- Não foi possível confirmar se o campo Código fica bloqueado para edição na tela depois do cadastro inicial.
- Se o código informado durante uma tentativa de edição não corresponder a nenhuma instituição financeira existente, o sistema não exibe uma mensagem de negócio amigável explicando o problema para o usuário; o comportamento observado sugere uma falha técnica em vez de um aviso claro (essa situação está detalhada na Regra 3 da Seção 9 deste documento).
Estrutura Técnica e Comportamento do Sistema da Instituição Financeira
Importação FEBRABAN
A rotina oferece um recurso de importação de instituições financeiras a partir de um catálogo FEBRABAN mantido dentro do próprio sistema. Esse catálogo não é uma consulta em tempo real ao Banco Central, e sim uma base de instituições já conhecida pelo sistema.
Referenciamento Externo
Este cadastro é referenciado por outras rotinas do sistema que precisam associar um banco a um registro, como é o caso do cadastro de carteiras (banco/caixa). Isso significa que, ao excluir ou alterar significativamente uma instituição financeira, é importante lembrar que outras partes do sistema podem depender dela.
Comportamento da Importação
Ao usar o recurso de importação, instituições financeiras que ainda não existem no cadastro são criadas automaticamente. Já as instituições que já estão cadastradas só têm o nome atualizado se o usuário escolher explicitamente essa opção durante a importação (esse comportamento está detalhado na Regra 2 da Seção 9 deste documento).
Regras de Negócio e Restrições da Instituição Financeira
Código e Nome são obrigatórios, com limite de tamanho
O sistema exige o preenchimento do campo Código (com até 3 caracteres) e do campo Nome (com até 50 caracteres) para permitir o salvamento de uma instituição financeira. Os campos de Máscara de Agência (até 10 caracteres), Máscara de Conta (até 20 caracteres) e Máscara de Tarja de Cheque (até 50 caracteres) são opcionais, mas também respeitam um limite de tamanho. Se qualquer um desses limites for ultrapassado, o sistema recusa o salvamento do cadastro.
A importação do catálogo FEBRABAN não sobrescreve cadastros existentes por padrão
Ao importar o catálogo FEBRABAN de instituições financeiras, uma instituição cujo código já exista no cadastro só tem o nome atualizado se o usuário selecionar explicitamente essa opção durante o processo de importação. Caso contrário, a instituição já cadastrada permanece exatamente como estava, sem alteração. Além disso, o sistema não informa ao usuário, ao final da importação, quais instituições foram ignoradas nesse processo.
Editar ou excluir um código inexistente não gera uma mensagem de negócio clara
Diferente de outras rotinas do sistema, tentar editar ou excluir uma instituição financeira usando um código que não existe no cadastro não dispara uma mensagem de erro amigável explicando o problema ao usuário. O comportamento observado sugere que o sistema apresenta uma falha técnica genérica nesse cenário, em vez de um aviso de negócio claro.
Da mesma forma, ao excluir uma instituição financeira, o sistema não verifica antecipadamente se ela está sendo usada por outros cadastros, como carteiras vinculadas a ela. Se existir essa dependência, a exclusão pode falhar por uma restrição técnica do banco de dados, sem que o sistema explique ao usuário o motivo real do bloqueio. Nesses casos, recomenda-se verificar se a instituição financeira está associada a outros cadastros antes de tentar excluí-la.
