Boleto Híbrido - Petroshow

Owned by Aline Ceccon Eli
Last updated: Apr 25, 2024
4 min read

1-  Objetivo 

Este manual tem como objetivo orientar o usuário do sistema Petroshow a realizar as devidas configurações para que seja realizada a impressão e visualização do QRCode no boleto.

Essa função só ficará disponível se no sistema Petroshow estiver configurado conforme for orientado neste manual.

As configurações explicadas aqui não é responsável pela comunicação das informações de PIX com o Banco, ou seja, o boleto ainda precisa ser enviado via remessa de cobrança para o Banco, qual irá identificar o registro e recebimento do pagamento e então devolver o recebimento pelo arquivo de retorno, esse por sua vez deverá ser lido e realizado a baixa da duplicata. Segue a mesma lógica dos boletos atuais. Não ocorre a quitação instantânea dos títulos nem o registro automático no banco.

2 - Pré-requisitos 

Cliente usuário do Petroshow precisa ter conta no Banco do Brasil, pois a principio a integração para essa funcionalidade só está disponível para o Banco do Brasil.

Cliente usuário do Petroshow precisa entrar em contato com a agencia responsável pela conta e solicitar as informações de credenciais:

  • Application Key;

  • ClientSecret;

  • ClientID.

Site Developers.bb para cadastro de credenciais: https://app.developers.bb.com.br/core/gcs/statics/login/login.novo.bb?tipo=st_cpf&urlRetorno=https%3A%2F%2Fapp.developers.bb.com.br%2F%23%2Flogin#/st-cpf

3- Acessos e Atalhos 

A Primeira configuração necessária a realizar fica disponível em: PSFinanceiro denominada “Credenciais Integração (PIX/Boleto)

A Segunda Configuração necessária a realizar fica disponível em: PSFinanceiro » Cadastros Específicos » Remessa Bancária » Cabeçalho da Remessa Bancária.

A Terceira Configuração necessária a realizar fica disponível em: PSFinanceiro » Cadastros Específicos » Remessa Bancária » Detalhe da Remessa Bancária;

4 - Descrição da Rotina/Processo

Após ter as informações de Application Key, ClientSecret e ClientID o usuario precisa acessar a rotina PSFinanceiro denominada “Credenciais Integração (PIX/Boleto) e informar as credenciais já solicitadas junto ao banco do Brasil.

image-20240205-114655.png
image-20240205-114825.png

No Campo Ambiente, atentar-se a que tipo de ambiente o usuário irá utilizar, sendo Homologação somente para testes e produção para de fato produção.

Obs. Deixo um atento aqui, para que na primeira vez que for utilizar essa opção de boleto Hibrido, realizar alguns testes antes, da mesma forma que se faz na homologação de novos boletos com novos bancos, deve ser feito esse período de homologação aqui para o boleto hibrido.

Após Realizar a parametrização na nova rotina é preciso configurar algumas questões no cabeçalho de cobrança e detalhe de cobrança do portador.

Configuração Cabeçalho de cobrança

Para isso acessar a rotina PSFinanceiro » Cadastros Específicos » Remessa Bancária » Cabeçalho da Remessa Bancária aba Adicionais, informar a configuração API criada anteriormente:

Configuração do Detalhe de Cobrança:

Após parametrizar o cabeçalho da remessa bancária, é preciso que seja configurado no detalhe de remessa: PSFinanceiro » Cadastros Específicos » Remessa Bancária » Detalhe da Remessa Bancária, se o portador vinculado a ela, vai gerar ou não boleto hibrido, para isso na aba “Boleto Híbrido” deverá definir como sim as duas configurações:

A configuração “Enviar Remessa Por API” foi desenvolvida para a segunda parte que seria a integração, ou seja, a configuração existe, mas a integração com a API ainda não é realizada, o boleto deverá seguir na remessa de cobrança.

Com essas configurações feitas corretamente ao gerar um novo boleto a receber no portador então configurado, no canto inferior direito sairá o QrCode

Para Testes em Homologação precisa se atentar a Algumas situações:

  • Digito do convenio liberado pelo Banco do Brasil é somente o 3 e 4

  • Lista Especifica de clientes para testes de Homologação de Criação dos Boletos:

 

  • Na Configuração de Cabeçalho de cobrança o modelo do Boleto precisa ser do Tipo Padrão

image-20240425-113656.png

  • E no cadastro de Detalhe de Cobrança precisa realizar as seguintes configurações especificas para o processo:

  •  

Obs. Para testes internos no Ambiente Viasoft, consultar a tarefa origem, onde explica alguns detalhes que precisa seguir para que o QRCode seja gerado corretamente.

Tarefas Relacionadas

https://nimitz.atlassian.net/browse/PS-5406

https://nimitz.atlassian.net/browse/PS-5717

5 - Versão do sistema para documentação

2.0.2401.1000