Banco do Brasil - Configuração Boletos - FINA710

01. VISÃO GERAL

Configurações necessárias para o registro de boletos por API do Banco do Brasil.

Para testes em ambiente de homologação deve ser utilizados os dados fictícios para testes conforme documentação no Portal Developers BB.

02. CREDENCIAIS

Para a configuração do layout será necessário obter junto ao Banco do Brasil as informações abaixo:

Application Key - Chave da aplicação: Chave de acesso do aplicativo

Client ID - ID do Cliente: Código de identificação do cliente

Client Secret - Chave Secreta do Cliente: Chave secreta de validação do cliente.

Desconsidere a chave BASIC caso seja recebida.

03. CADASTRO DE BANCO - MATA070

• Para habilitar a configuração de um layout para o Banco do Brasil deve ser informado no campo A6_BCOOFI  ( Banco oficial )  o código 001.

04. PARÂMETROS DE BANCO - FINA130

• Número de convênio deve ser informado no campo Cod. Empresa(EE_CODEMP).
  • Campo será validado na inclusão do Borderô.
• Código da carteira deve ser informado no campo Cód. Carteira (EE_CODCART).
• Número da variação da carteira deve ser informado no campo Var. Carteira (EE_VARCART).
  • Campo será validado na inclusão do Borderô.
• Nosso número deve ser parametrizado nos campos Faixa Inicio (EE_FAXINI) , Faixa Fim (EE_FAXFIM) e Faixa atual (EE_FAXATU).
  
  • O campo (EE_FAXATU) será validado quanto ao seu tamanho, onde deverá conter no máximo 10 caracteres na inclusão do Borderô e também na transmissão do boleto. Havendo divergência será logado no NGF o motivo do erro.
• Número Dias Limite Recebimento deve ser informado no campo Dias Recebim (EE_DIASREC)
  • Quando este campo possui um valor > 0, internamente o Indicador Aceite Titulo Vencido passa a ser enviado com 'S' 
• Quantidade Dias Protesto deve ser informado no campo Dias Prot (EE_DIASPRT)
• Mensagem para instrução de cobrança deve ser informada no campo Mensagem 1 (EE_FORMEN1), vale ressaltar que o banco aceita no máximo 165 caracteres. Recomendamos o uso de letras minúsculas, pois na impressão do boleto existe um espaço pré-definido para exibição da mensagem. 
• Recebimento on-line deverá ser informado para pelo menos um convênio quando o retorno(FINA715 ou Webhook) estiver configurado (EE_RETAUT). Caso não esteja habilitado, o retorno não irá ser processado para esse convênio.

05. CONFIGURAÇÃO DE LAYOUT

Para utilizar o registro online de boletos para o Banco do Brasil, deve-se observar a seguinte regra:

• Número do documento: Neste campo deverá ser informado qual será o número do documento que será transmitido ao banco e posteriormente impresso no boleto.

      Onde poderá ser:

1. 1. Número do Título (E1_NUM)
   2. ID CNAB (E1_IDCNAB)
   3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Número do documento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

• Aceite: Este campo indica o reconhecimento formal da divida (assinatura no documento) pelo pagador, deverá ser informado os valores:
  • Sim - Quando existe a necessidade do pagador reconhecer/aceitar a cobrança.
  • Não - Quando não existe a necessidade de reconhecimento da cobrança.

• Beneficiário Filial: Neste campo deverá ser informado qual filial que será utilizada para a transmissão e impressão do boleto. 

Os dados cadastrados nessa filial serão utilizados na transmissão e na impressão:

• Abatimento: Neste campo poderá ou não ser informado um valor de abatimento para o boleto.  

       Onde poderá ser:

1. 1. Vazio - Caso o valor original já esteja calculado com a dedução dos valores de abatimento ou não exista abatimento para o boleto.
   2. Valor Abatimento (SomaAbat()) - Calculo padrão do sistema conforme a expressão: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
   3. Expressão definida pelo usuário.
      • O resultado da expressão será atribuído ao campo “Abatimento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

É possível informar o valor original já deduzindo o valor do abatimento. Basta clicar na engrenagem no campo "Valor Original" e informar uma expressão válida:

Exemplo:

• • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

• Boleto Híbrido (Boleto + PIX)
  • Sim - O boleto será registrado com o PIX, na impressão irá aparecer o QR Code PIX para recebimento do valor.
  • Não - O Boleto será registrado sem o PIX, na impressão não irá aparecer o QR Code PIX.

06. WEBHOOK - BAIXA TÍTULOS (RETORNO)

Webhook é um serviço onde o banco envia informações de baixas de boletos para o ERP Protheus.

A comunicação entre o Protheus e o Banco do Brasil acontece via autenticação de certificados mTLS.

Para mais detalhes acesse a documentação que está disponível no Portal Developers BB.

É necessário um serviço REST habilitado no Protheus com SSL e disponibilizado para o Banco do Brasil ( verificar junto ao Banco do Brasil onde informar essa URL para envio de informações ao Protheus).

Informar a URL do serviço REST disponibilizada ao Banco do Brasil nas configurações de contas no campo Endereço (URL) de call-back do webhook:

https://seuendereco:suaporta/api/fin/v1/bb/bol/receivables/

seuendereco:suaporta → Informar endereço e porta do serviço REST configurado no arquivo appserver.ini.

/api/fin/v1/bb/bol/receivables/ → API disponível no serviço REST padrão do Protheus preparada para receber o payload de cobrança(boletos) do Banco do Brasil.

07. CONFIGURAÇÃO DE BOLETO

Permite que o usuário configure como será a impressão do boleto.

• Imprime abatimento
  • Como mensagem - O valor do abatimento será impresso nas mensagens do boleto
    • Nesse caso o campo "Valor Cobrado" não é preenchido e o valor do boleto fica destacado no campo "Valor do Documento"
  • Campo desconto/abatimento - O valor do abatimento no titulo será impresso no (-) Desconto/Abatimento do boleto
    • Nesse caso o campo "Valor Cobrado" será impresso com o resultado da soma dos campos positivos diminuindo os campos negativos