PHSYS - Wiki

==='''Conceito'''===

A homologação de [[Boletos_Bancários:_Integração_WebService|boletos bancários WebService]] é um processo essencial para que a empresa possa emitir boletos de cobrança de forma autônoma e segura, utilizando integrações diretas com os sistemas dos bancos. Esse procedimento assegura que os boletos gerados estejam em conformidade com os padrões exigidos pelas instituições financeiras.

==='''Credenciais Homologação'''===

As credenciais de homologação são essenciais para testar e validar a integração com o sistema de boletos bancários sem realizar transações reais. É importante observar que, para cada banco, existem credenciais específicas que devem ser utilizadas durante os testes. Essas credenciais garantem a comunicação correta com o sistema do banco, permitindo a verificação do funcionamento da integração.

==='''Banco do Brasil'''=== 
Para obter as credenciais para integração, siga os passos abaixo:

*1. Acesse o site de desenvolvedores do Banco do Brasil: https://app.developers.bb.com.br.
*2. Realize o login e crie uma aplicação, incluindo a API de '''Cobranças''' e de '''PIX''' disponibilizada pelo Banco do Brasil.
*3. Com a aplicação criada, você poderá acessar as credenciais geradas para integração.

'''Credenciais para Cobrança Bancária''' 

*'''Número Convênio:''' 3128557.
*'''Código Cedente:''' 3128540.
*'''Carteira:''' 17.
*'''Agência:''' 452.
*'''Agência DV:''' 3.
*'''Conta Código:''' 123873.
*'''Conta DV:''' X.
*'''Espécie:''' 17.
*'''Modalidade:''' 35.
*'''ClientID:''' OBTIDO NO SITE DA INTEGRAÇÃO.
*'''ClientSecret:''' OBTIDO NO SITE DA INTEGRAÇÃO.
*'''KeyUser:''' OBTIDO NO SITE DA INTEGRAÇÃO.
*'''Scope:''' cobrancas.boletos-info cobrancas.boletos-requisicao '''[Preenchido de Forma Fixa Atualmente]'''.

Referência: https://apoio.developers.bb.com.br/referency/post/5f4fb7f5b71fb5001268ca44

==='''Rotina Homologação'''===
Para iniciar a homologação, é necessário configurar previamente a cobrança bancária, garantindo que as credenciais estejam corretas para a execução da integração. O processo de homologação envolve a criação de [[Cadastro_de_Contas_a_Receber|Contas a Receber]], com a forma de cobrança configurada via WebService. Após isso, será possível gerar boletos bancários no sistema.

Quando a geração do boleto bancário for realizada, o registro terá a configuração '''Tipo Integração''' definida como '''WebService''', o que permite ao sistema identificar o tipo de comportamento a ser executado durante os processos. É importante realizar a homologação nos seguintes processos:
*Registro
*Cancelamento
*Consulta

===='''Simular Pagamento BoletoPIX'''====

Para simular a liquidação dos títulos de boletos bancários integrados com WebService, utilize o projeto Delphi de exemplo '''ACBrPIXCD'''.

Siga os passos abaixo para realizar a simulação de pagamento:

*1. Abra o projeto, execute e acesse a página de configurações e vá até a opção PIX.
*2. Preencha as informações relacionadas ao '''PSP Atual''' e ao ambiente de homologação, além das informações do recebedor.
*3. Na seção '''PSPs''', selecione a instituição financeira utilizada na homologação e preencha as credenciais de integração.
*4. Na página de testes, use o campo '''PIX Copia e Cola''' para inserir o código PIX do boleto gerado previamente no PHERP.
*5. Clique na opção '''Pagar''' para efetuar a liquidação do boleto.