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.
Informações | ||
---|---|---|
| ||
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: |
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
|
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 diminuindo os campos negativos
- Como mensagem - O valor do abatimento será impresso nas mensagens do boleto
Aviso | ||
---|---|---|
| ||
|