Entidade BANCOS

BANCOS.BANCOS

Descrição

Cadastro de instituições financeiras e bancos que aceitam depósitos e concedem empréstimos. O banco tem por funções depositar capital em formas de poupança, emprestar dinheiro, financiar automóveis e casas, trocar moedas internacionais, realizar pagamentos etc.

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK FK Id:
Chave de identificação interna

Referência para PESSOAS
CODIGOUPPER(10)AK Código (Febraban):
Código de compensação do banco conforme FEBRABAN.

Exemplos:
  • 001
  • 104
  • 237
  • 341
SIGLAUPPER(10)Sigla:
Sigla utilizada para identificar o banco.

Exemplos:
  • BB
  • CEF
  • Itaú
  • HSBC
TAMANHO_NOSSO_NUMEROINTEGERTamanho do nosso número:
Cada banco possui uma identificação única para os documentos (títulos) processados.
Esta identificação é denominada pelos bancos como "Nosso número", cujo tamanho (quantidade de caracteres) é informado neste campo.
LAYOUT_CNABOPCAO(3)Rqd Layout CNAB:
Os bancos usam o padrão Febraban CNAB 400 ou 240 para receber (remessa) e enviar (retorno) informações para as empresas clientes usando arquivos texto.
O objetivo destes arquivos é intercambiar informações digitalmente entre o sistema de informática do banco e o do cliente.
Dentre as informações intercambiadas podemos citar:
  • cobrança (boletos bancários),
  • pagamentos,
  • extrato (para conciliação),
  • débito em conta,
  • vendor e
  • custódia de cheques.
Cada um destes produtos tem seu fluxo de informação e portanto um layout diferenciado.

Valores permitidos:
  • 240 - CNAB 240 - Lay-out padrão CNAB 240 (240 caracteres por linha no arquivo).
  • 400 - CNAB 400 - Lay-out padrão CNAB 400 (400 caracteres por linha no arquivo).
PASTA_ARQUIVOS_RECEBIDOSTEXTPasta de arquivos recebidos:
Pasta com a localização dos arquivos recebidos pelo banco via CNAB.
O arquivo texto (retorno) será deletado (excluído do sistema operacional) após a sua leitura e importação para o sistema.
DIGITO_BANCOTEXTDígito do banco:
Dígito a ser inserido nos títulos gerados para o banco.
LAYOUT_CHEQUE_IDID(18)FK Layout cheque:
Layout para geração do arquivo para impressão do cheque

Referência para LAYOUT_ARQUIVOS_EXPORTACOES
LAYOUT_DEBITO_CONTA_IDID(18)FK Layout débito em conta:
Layout para geração de arquivo para débito em conta

Referência para LAYOUT_ARQUIVOS_EXPORTACOES
CODIGO_BANCO_JBOLETOINTEGERCódigo do banco no jBoleto:
Código do banco no jBoleto (biblioteca de rotinas Java para geração de boletos bancários).
TAMANHO_DV_CONTAINTEGERRqd Tamanho do DV da conta:
Número de caracteres que são utilizados como dígito verificador no número da conta corrente.

Valor padrão = 1
TAMANHO_DV_AGENCIAINTEGERRqd Tamanho do DV da agência:
Número de caracteres que são utilizados como dígito verificador no número da agência.

Valor padrão = 1
USA_TIPO_CONTAFLAG(1)Rqd Usa tipo de conta:
Indica se o banco exige informar o tipo de conta para identificar uma determinada conta corrente.

Valor padrão = N
TIPOS_CONTASTEXT_LONGTipos de contas:
Definição dos tipos de contas utilizados pelo banco.
Este atributo somente é relevante quando o banco usa tipo de conta na identificação do mesmo.
A forma de preenchimento se utiliza do formado de propriedades, onda cada linha é um tipo de conta que deve ser informada com:
código=significado.
Exemplo:
01=Conta corrente
02=Conta poupança
CALCULO_DV_CONTATEXT(100)Cálculo do DV da conta:
Definição da regra utilizada para calcular/validar o dígito verificador de uma conta-corrente deste banco.
Caso não informado, o sistema não fará a validação do mesmo.

A informação deste campo é montada com uma convenção especial no formato:
metodo(parametros); propriedade=valor; propriedade=valor; ...
O método é o algoritmo de cálculo, podendo ser:
  • mod
  • mod10
  • mod11
  • mod11x
  • mod11p
  • mod11t7

Os parâmetros indicam os números que participam do cálculo do DV, seguidos do número de dígitos que deve ser utilizado para cada parâmetro (incluindo zeros a esquerda), separados por vírgulas:
  • Cn - Número da conta
  • An - Número da agência
  • Tn - Número do tipo de conta

A ordem com que os parâmetros são incluídos é importante.

As demais propriedades são parâmetros adicionais que definem o comportamento do algoritmo:
  • multiplicadores: Relação de fatores separados por "-" e que devem ser utilizados como multiplicadores (da esquerda para a direita).
  • divisor: Número a ser utilizado como divisor (p.ex.: 10, 11, etc.).
  • modulo: Letra a ser utilizada para representar DV que ficar igual ao divisor.

Exemplos:
  • Banco do Brasil: mod11x(C)
  • Santander: mod11x(A4,T2,C6)
  • Bradesco: mod11p(C)
  • Itaú: mod11(A4,C5)
  • Real: mod11x(A4,C7)
CALCULO_DV_AGENCIATEXT(20)Cálculo do DV da agência:
Definição da regra utilizada para calcular/validar o dígito verificador de uma agência deste banco.
Caso não informado, o sistema não fará a validação do mesmo.
A informação deste campo é montada com a mesma convenção que é utilizada para o cálculo do DV da conta.
INFORMACOES_BANCO_PAGADORTEXT_LONGInformações do banco para pagador:
Informações do banco para serem impressas no recibo do pagador. No caso do Banrisul ou CEF já são impressos os textos determinados por padrão
NOME_ARQUIVO_REMESSA_CNABSOURCE_CODENome do arquivo remessa CNAB:
Forma da geração do nome do arquivo para remessa ao banco.
  • Quando não informado será utilizado o padrão "Nome do banco + lote"

Pode ser utilizado velocity para criação do código, são aceitos os seguintes objetos: banco, envio, lop, conta
HISTORICO_DESCONTO_IDID(18)FK Histórico de descontos:
Histórico utilizado para o movimento de descontos registrados no retorno bancário. Caso não informado será utilizado o histórico padrão DESCONTO.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_JUROS_MORA_IDID(18)FK Histórico de juros/mora:
Histórico utilizado para o registro do juros/mora no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_MULTA_IDID(18)FK Histórico multa:
Histórico utilizado para o registro da multa registrada no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_PAGAMENTO_IDID(18)FK Histórico pagamento:
Histórico utilizado para o registro do pagamento registrado no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_DEDUCOES_IDID(18)FK Histórico deduções:
Histórico utilizado para o registro de deduções registrado no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_OUTROS_DEBITOS_IDID(18)FK Histórico de outros débitos:
Histórico utilizado para o registro do outros débitos registrado no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_OUTROS_CREDITOS_IDID(18)FK Histórico de outros créditos:
Histórico utilizado para o registro do outros créditos registrado no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_TARIFAS_IDID(18)FK Histórico de tarifas:
Histórico utilizado para o registro de tarifas registrado no retorno bancário, quando não informado é utilizado o padrão.

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_TARIFA_BANCARIA_IDID(18)FK Histórico tarifa bancária:
Histórico utilizado para o registro de tarifas bancárias registrado no retorno bancário, quando não informado é utilizado o padrão.
Este histórico é utilizado somente quando o modelo de tarifa no lop estiver configurada como "Título (no pagamento)"

Referência para HISTORICOS_CONTAS_RECEBER
HISTORICO_ABATIMENTO_IDID(18)FK Histórico de abatimentos:
Histórico utilizado para o movimento de abatimentos registrados no retorno bancário. Caso não informado será utilizado o histórico padrão DESCONTO.

Referência para HISTORICOS_CONTAS_RECEBER
CODIGO_ISPBTEXT(10)Código ISPB:
ISPB (Identificador de Sistema de Pagamento Brasileiro) tem como objetivo identificar os bancos pelo sistema de transferência de reserva do Banco Central do Brasil.
O ISPB pode ser consultado em https://www.bcb.gov.br/pom/spb/estatistica/port/ASTR003.pdf .

Regras

Salvar documento FEBRABAN

(Depois de inserir, Depois de alterar)
Quando informado, o código febraban deve ser armazenado junto aos documentos da respectiva pessoa.

Validar o método de cálculo do DV

(Antes de inserir, Antes de alterar)
Verifica se o valor informado nos métodos de cálculo dos DVs (dígitos verificadores ou dígitos de controle) da conta e da agência atendem à convenção estabelecida.
Ver documentação do atributo BANCOS.BANCOS.CALCULO_DV_CONTA para maiores detalhes.

Calcular dígito de conta(agencia, tipo_conta, numero_conta_corrente)

Calcula o dígito verificador de uma conta corrente conforme as regras definidas pelo banco.

find Febraban(codigo)

Localizar o banco utilizando o seu código Febraban.

get Data atual

Retorna a data atual do sistema sem as barras.

get Data atual 6 digitos

Retorna a data atual no formato DDMMAA.

get Documento cliente

get Febraban

Retornar o número do documento da febraban

get Hora atual

Retornar a hora atual com 6 caracteres numéricos no formato HHMMSS. P.ex.: 120630 = 12 horas, 6 minutos e 30 segundo.

get Nome do banco

Retornar o nome do banco informado no cadastro de pessoas.