Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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

Informações
titleRede interna

Para a comunicação doProtheuscom o banco é necessário configurar a segurança de rede, caso necessário, para aceitar a saída da faixa de IP referente ao DNS: 

https://oauth.bb.com.br

https://oauth.hm.bb.com.br

https://api.bb.com.br

https://api.hm.bb.com.br

https://api-ip.bb.com.br

https://api.hm.bb.com.br


02. CREDENCIAIS

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

...

  • 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 parametrizadonos 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

...

Aviso
titleImportante

Caso o valor original já esteja calculado com a dedução dos valores de abatimento, o campo "Abatimento" não deve ser preenchido para que não ocorra uma duplicidade no valor de abatimento.

Caso o campo "Abatimento" seja preenchido o campo "Valor Original" deverá conter o valor cheio (Sem a dedução do abatimento). Caso exista abatimento será exibida uma mensagem no corpo do boleto informando o valor do abatimento já calculado.

Aviso
titleImportante

Sempre que uma expressão for aplicada em um campo de VALOR, é essencial incluir uma proteção de arredondamento para garantir que o valor seja sempre retornado com duas casas decimais.

Exemplo: round(SE1->E1_SALDO * 0.10, 2)


  • 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)


Aviso
titleImportante


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).

...

/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.Obs: Ao informar o campo da url do Webhook, o Job FINA715 não será executado para essa conta, ficando a cargo apenas do Webhook a realização das baixas de boletos


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 (mais) diminuindo os campos negativos (menos)

Image Added


Aviso
titleImportante
  • Não é possível utilizar as opções "Como mensagem" e "Campo desconto/abatimento" em conjunto. 
  • Após a transmissão do boleto as alterações realizadas no campo Imprime abatimento não serão aplicadas aos boletos já transmitidos. As alterações serão aplicadas somente aos boletos transmitidos após a alteração.