Histórico da Página
REGISTRO ONLINE DE BOLETO
Características do Requisito
Linha de Produto: | RM |
Segmento: | Construção & Projetos |
Módulo: | TOTVS Gestão Financeira |
Requisito/Story/Issue: | http://jiraproducao.totvs.com.br/browse/FINANCEIRO01-3271 |
Descrição
Esta implementação tem como objetivo preparar o TOTVS Gestão Financeira para utilizar o serviço de registro online de cobrança registrada do Banco do Brasil (WebService).
Procedimento para Configuração
No TOTVS Gestão Financeira, menu através do menu Movimentações Bancárias | Controle Bancário | Convênio, devem devem ser feitas as configurações do convênio para o registro de boleto online:
- 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 "v1" ou "v2".
- URL do serviço de registro do boletode cobrança: Deve ser informada a url URL do serviço de registro do boleto disponibilizada pelo banco. https://cobranca.bb.com.br:7101/registrarBoleto
- URL de homologação do serviço de registro de cobrança: Deve ser informada a url URL de homologação do serviço de registro do boleto disponibilizada pelo banco. https://cobranca.homologa.bb.com.br:7101/registrarBoleto
- URL do sistema autorizador: Deve ser informado a url 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 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 (campo disponível somente no modelo "v2"): Chave disponibilizada pelo Banco
- App-Key de Homologação (campo disponível somente no modelo "v2"): Chave de homologação disponibilizada pelo Banco
Segue os dados a serem utilizados que podem ser utilizados para teste no ambiente de homologação:
- Client Id: eyJpZCI6IjgwNDNiNTMtZjQ5Mi00YyIsImNvZGlnb1B1YmxpY2Fkb3IiOjEwOSwiY29kaWdvU29mdHdhcmUiOjEsInNlcXVlbmNpYWxJbnN0YWxhY2FvIjoxfQ
- Client Secret: eyJpZCI6IjBjZDFlMGQtN2UyNC00MGQyLWI0YSIsImNvZGlnb1B1YmxpY2Fkb3IiOjEwOSwiY29kaWdvU29mdHdhcmUiOjEsInNlcXVlbmNpYWxJbnN0YWxhY2FvIjoxLCJzZXF1ZW5jaWFsQ3JlZGVuY2lhbCI6MX0eyJpZCI6IjBjZDFlMGQtN2UyNC00MGQyLWI0YSIsImNvZGlnb1B1YmxpY2Fkb3IiOjEwOSwiY29kaWdvU29mdHdhcmUiOjEsInNlcXVlbmNpYWxJbnN0YWxhY2FvIjoxLCJzZXF1ZW5jaWFsQ3JlZGVuY2lhbCI6MX0
- Numero do convênio: 2625444
- Carteira: 17
- Variação da carteira: 19
- CPF do pagador: 00000000191
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:
codigoTipoDesconto
dataDescontoTitulo
percentualDescontoTitulo
valorDescontoTitulo
valorAbatimentoTitulo
quantidadeDiaProtesto
codigoTipoJuroMora
percentualJuroMoraTitulo
valorJuroMoraTitulo
codigoTipoMulta
dataMultaTitulo
percentualMultaTitulo
valorMultaTitulo
textoDescricaoTipoTitulo
indicadorPermissaoRecebimentoParcial
textoMensagemBloquetoOcorrencia
Importante:
- 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.