1- Objetivo
Este manual tem como objetivo orientar o usuário do sistema Petroshow a realizar as devidas configurações para poder utilizar a nova funcionalidade de boleto Hibrido. Essa Funcionalidade disponha na impressão e visualização do boleto, a opção do QRCode para pagamento via PIX.
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.
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.
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
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
PS-5406 - Getting issue details... STATUS
PS-5717 - Getting issue details... STATUS
5 - Versão do sistema para documentação
2.0.2401.1000