Registro Boleto Online Banco do Brasil

• Permite registro de boleto online: Define se o convênio permite utilizar o registro de boleto online.
• Ambiente: Define o ambiente que será feito o registro do boleto no banco.
• Modelo de Registro Online: Modelo "v2".
• URL do serviço de registro de cobrança: Deve ser informada a URL do serviço de registro do boleto disponibilizada pelo banco. https://api.bb.com.br/cobrancas/v2
• URL de homologação do serviço de registro de cobrança: Deve ser informada a URL de homologação do serviço de registro do boleto disponibilizada pelo banco. https://api.hm.bb.com.br/cobrancas/v2
• URL do sistema autorizador: Deve ser informado a URL do sistema autorizador que retornará o token de acesso ao serviço de registro de cobrança. https://oauth.bb.com.br/oauth/token
• URL de homologação do sistema autorizador: Deve ser informado a URL de homologação do sistema autorizador que retornará o token de acesso ao serviço de homologação de registro de cobrança. https://oauth.hm.bb.com.br/oauth/token
• Client Id: Código de acesso ao sistema autorizador fornecido pelo banco.
• Client Secret: Senha de acesso ao sistema autorizador fornecido pelo banco.
• App-Key: Chave secreta (produção) de validação do cliente disponibilizada pelo banco
• App-Key de Homologação: Chave secreta (homologação) de validação de disponibilizada pelo banco

Pode ser utilizado o Cadastro de Layout do Registro Online, para enviar dados de forma flexível para o registro online dos boletos para o banco. Para isso deve ser feito o Cadastro de associação de fórmulas e campos do registro online no cadastro do convênio utilizado para o registro online.

O cadastro do layout do registro online do Banco do Brasil deve ser feita de acordo com o manual de cobrança online do banco, da seguinte maneira:

• Exemplos:
  
  
  • API v1
    

    codigoTipoDesconto
    dataDescontoTitulo
    percentualDescontoTitulo
    valorDescontoTitulo
    valorAbatimentoTitulo
    quantidadeDiaProtesto
    codigoTipoJuroMora
    percentualJuroMoraTitulo
    valorJuroMoraTitulo
    codigoTipoMulta
    dataMultaTitulo
    percentualMultaTitulo
    valorMultaTitulo
    textoDescricaoTipoTitulo
    indicadorPermissaoRecebimentoParcial
    textoMensagemBloquetoOcorrencia
    
    

  • API v2

dataEmissao

dataVencimento

dados.Desconto.tipo (opcional)
dados.Desconto.dataExpiracao (opcional)
dados.Desconto.porcentagem (opcional)
dados.Desconto.valor (opcional)

dados.segundoDesconto.dataExpiracao
dados.segundoDesconto.porcentagem
dados.segundoDesconto.valor

dados.terceiroDesconto.dataExpiracao
dados.terceiroDesconto.porcentagem
dados.terceiroDesconto.valor

dados.jurosMora.tipo

dados.jurosMora.porcentagem

dados.jurosMora.valor

dados.multa.tipo

dados.multa.data

dados.multa.porcentagem

dados.multa.valor

Observações 

• O primeiro desconto (grupo "desconto") já é enviado nativamente no JSON gerado pelo sistema, buscando o valor de desconto do Boleto. Somente se desejar customizar o valor do primeiro desconto (utilizando fórmula, por exemplo) que será necessário inserir os campos do primeiro desconto no layout do registro online e associa-los no cadastro do Convênio.
• Para os campos de valores ou percentual deve seguir o formato de acordo com o manual disponibilizado pelo banco. Ao definir um valor fixo ou formula deve ser retornado um string com o separador decimal '.' (ponto). 
  Exemplo: 
  2.49 (com duas casas decimais )
  30.03.2018 (data no formato DD.MM.YYYY)
• O campo Data da Multa será calculado a partir da Data de Vencimento do boleto acrescido do parâmetro Dias de Atraso configurado na etapa Valor Líquido do Lançamento Financeiro.