CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Conta de Cobrança
    1. Outras Ações / Ações relacionadas
  4. Tela Conta de Cobrança
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

01. VISÃO GERAL

Esta atividade visa demonstrar como Registrar boleto via API para Banco do Brasil e também a Configuração do Prazo Limite para Recebimento na Cobrança Eletrônica.

Configuração do campo para exibição, no Arquivo de Remessa, da quantidade de dias para recebimento do valor cobrado após o vencimento do título.

Essa informação será configurada no mesmo campo em que é inserido o critério de pagamento de multa, tendo essas informações separadas por vírgula.

Ao configurar o campo Informações Específicas 7 o prazo para recebimento será demonstrado no campo 06.5 do Layout de Cobrança Eletrônica do Banco do Brasil, padrão FEBRABAN de 400 posições, versão 2017 do Registro Detalhe Tipo 5 – Multa/Prazo Limite de Recebimento – Opcional – Remessa.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Supervisor > Parâmetros > Cobrança > Conta Cobrança - FICTACOBRANC

Pré-Requisitos 

Possuir acesso ao Sistema Financeiro e suas aplicações.

Ter realizado o cadastro no Portal BB e vinculado API Cobrança.

Utilizar o Banco do Brasil para cobrança.

Realizar Cobrança Eletrônica.

Service pack a partir da 22.07.005


Passo a Passo

Acesse o módulo Supervisor Financeiro, clique no menu Parâmetros, em seguida clique na opção Cobrança, aplicação Conta Cobrança.

Imagem 1 - Menu de acesso

    Configuração do Prazo Limite para Recebimento na Cobrança Eletrônica.

    Insira no campo Banco a opção Banco do Brasil. Complete os demais campos.

    Marque as Opções:

    • Gera Cobrança Eletrônica: habilita a aba CNAB.
    • Cobrança Registrada: opção    para gerar o arquivo de remessa de cobrança eletrônica ao banco.
    • Gera Instrução de Alteração (opcional):  alterações no título serão refletidas no boleto.

    Complemente as demais informações conforme Configuração de Cobrança Eletrônica.

    Imagem 2 – Prazo para Recebimento


    Acesse a aba CNAB e no campo Informação Específica 7, insira o número de dias, com até três (3) casas decimais do limite para recebimento do valor do título.

    O campo Informação Específica 7 trata do registro 5 para o Banco do Brasil relativo à Multa, dessa forma, o usuário informará, antes da vírgula, o critério de pagamento de multa e após a vírgula a quantidade de dias para recebimento após o vencimento.

    Imagem 3 – Prazo para Recebimento


    Seguindo a estrutura abaixo:

    Para obter informações mais detalhadas sobre o preenchimento de cada campo de Informação Específica, clique no botão de Interrogação (interrogação).

    Imagem 4 – Prazo para Recebimento


    O layout exibe o campo 06.5, como mostrado na Imagem 4.

    Imagem 5 – Prazo para Recebimento

    Registrar boleto via API para Banco do Brasil

    Insira no campo Banco a opção 1- Banco do Brasil. Marque a opção Gera Cobrança por API, Emite Boleto e preencha os outros campos seguindo a configuração de conta cobrança. Complete os demais campos bom base no Grupo alvo

    Autenticação com a API do Banco do Brasil requer as seguintes cifras:

    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    Verifique se o seu sistema operacional está preparado para essas cifras e, caso não esteja, providencie os ajustes necessários.

    Link de referência

    A opção Gera Cobrança por API é habilitada apenas para o Banco do Brasil.

    Funcionalidade de registro via API esta disponível apenas quando o cliente é responsável pela emissão do boleto. Para isso a opção Emite Boleto deve estar marcada.

    Ao marcar a opção, a aba API também será habilitada, permitindo o cadastro de informações para comunicação com o Banco do Brasil.

    Imagem 6 - Parâmetro Gera Cobrança por API Habilitado.

    Aba Boleto.

    Campos a serem informados:

    • Padrão de Preenchimento
    • Boleto Modelo

    Complete as demais informações conforme a necessidade.

    Imagem 7 -Boleto

    Aba API

    • Ambiente: Indica qual ambiente do Banco do Brasil a aplicação irá se comunicar.
      • Produção: Produção é o ambiente real da aplicação, onde se utiliza o sistema no dia a dia.  Link de como enviar aplicação para produção.

      • Homologação: Homologação é o ambiente utilizado para realizar testes na aplicação sem impactar os dados reais.
    • Application key: Acesse o portal developers do Banco do Brasil. Selecione a aplicação criada e navegue até as credenciais. Localize o item developer_application_key e copie seu valor, em seguida cole no campo Application Key.
    • Token de autenticação: Acesse o portal developers do Banco do Brasil. Selecione a aplicação criada e navegue até as credenciais. Localize e clique no botão Copiar Basic  copiar o token, em seguida, cole no campo Token Autenticação.

    Imagem 8 - Aba API com campos para comunicação com Banco do Brasil.


    No portal developers do Banco do Brasil, no menu lateral, clique na opção Credências.

    Imagem 9 - Barra navegação BB.

    Localize e clique no botão Copiar Basic.

    Imagem 10 - Botão Copiar.

    Na aplicação Conta de Cobrança, aba API, cole no campo Token Autenticação o valor copiado. 

    Localize e copie o valor do item developer_application_key e cole no campo Application Key.

    Imagem 11 - Token Autenticação.

    Aba Conta de Cobrança

    • Nro. do Contrato: Numero do convênio. Informação disponibilizada pelo Banco do Brasil.

    Imagem 12 - Nro do Contrato


    Aba Boleto.

    Campos a serem informados:

    • Emitido pelo(a) Empresa
    • Padrão de Preenchimento
    • Boleto Modelo

    Complete as demais informações conforme a necessidade.

    Imagem 13 -Boleto



    Aba CNAB.

    • Informação específica 2: Variação da carteira. Informação disponibilizada pelo banco do brasil.

    Clique no botão Incluir - <F3>.

    Imagem 14 - Informação Específica 2

    03. TELA CONTA DE COBRANÇA

    Outras Ações / Ações relacionadas

    AçãoDescrição

    Geração do Arquivo de Cobrança CNAB

    Geração do arquivo para envio ao banco com informações de Cobrança.

    Conta Cobrança

    Parâmetros a aplicação Conta Cobrança

    04. TELA CONTA DE COBRANÇA

    Principais Campos e Parâmetros

    Não há

    05. TABELAS UTILIZADAS

    • Não há