Histórico da Página

...

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:

...

• 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

...

• • "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:

Image Added

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

Image Added