Mudanças entre as edições de "Boletos Bancários: Integração WebService Homologação"
(→‎Rotina Homologação)
 
(7 revisões intermediárias por 2 usuários não estão sendo mostradas)
Linha 1: Linha 1:
 
==='''Conceito'''===
 
==='''Conceito'''===
  
−
A homologação de boletos bancários via 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.
+
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'''===
 
==='''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 de forma isolada para cada instituição financeira.
+
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'''====
+
==='''Banco do Brasil'''===  
 +
Para obter as credenciais para integração, siga os passos abaixo:
  
−
Para serem obtidas as credenciais para integração, deve ser feito o login no [https://app.developers.bb.com.br site de desenvolvedor]. Necessário realizar a criação de uma aplicação, na qual, deve ser incluída a API de Cobranças e de PIX disponibilizada pelo Banco do Brasil. Com a aplicação criada, é possível checar as credenciais geradas para integração.
+
*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.
  
−
'''Cobrança Bancária'''  
+
'''Credenciais para Cobrança Bancária'''  
  
 
*'''Número Convênio:''' 3128557.
 
*'''Número Convênio:''' 3128557.
Linha 25: Linha 28:
 
*'''ClientSecret:''' OBTIDO NO SITE DA INTEGRAÇÃO.
 
*'''ClientSecret:''' OBTIDO NO SITE DA INTEGRAÇÃO.
 
*'''KeyUser:''' 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
 
Referência: https://apoio.developers.bb.com.br/referency/post/5f4fb7f5b71fb5001268ca44
  
−
==='''Rotina Homologação'''===
+
===='''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.
  
−
Necessário realizar a configuração previamente da cobrança bancária para que possua as credenciais necessárias para execução da integração. Para o processo de homologação basta realizar a criação de Contas à Receber com a com a forma de cobrança em que está configurada a cobrança bancária do WebService, assim, posteriormente, será possível realizar a geração do(s) boleto(s) bancário(s) no sistema. Quando realizada esta geração do boleto bancário, este registro, estará com a configuração '''Tipo Integração''' igual a '''WebService''', Assim, o sistema identifica o comportamento que será executado durante os processos. É importante realizar a homologação dos processos:
+
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
 
*Registro
 
*Cancelamento
 
*Cancelamento
Linha 37: Linha 42:
 
===='''Simular Pagamento BoletoPIX'''====
 
===='''Simular Pagamento BoletoPIX'''====
  
−
Para realizar a simulação da liquidação dos titulos de boletos bancários integrados com WebService, utiliza-se o projeto de exemplo '''ACBrPIXCD'''. Necessário Utilizar a página de configurações na opção de PIX para preencher as informações em relação ao PSP Atual e ambiente de homologação, além das informações do recebedor. Em configurações na opção de PSPs será necessário selecionar a instituição financeira que está sendo feita a homologação, para assim, preencher as credenciais de integração. Posteriormente na página de Testes é possível utilizar o campo de PIX Copia e Cola para informar o código pix do boleto que foi gerado anteriormente no PHERP, para assim, efetuar a liquidação utilizando a opção '''Pagar'''.
+
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.

Edição atual tal como às 10h10min de 20 de fevereiro de 2025

Conceito

A homologação de 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 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.
Disponível em "http://wiki.phsys.com.br/index.php?title=Boletos_Bancários:_Integração_WebService_Homologação&oldid=5144"