Ir para conteúdo
  • Cadastre-se

dev botao

Recommended Posts

  • Moderadores

Olá

Estamos disponibilizando na última versão do componente ACBrBoleto a funcionalidades de integração via WebService (Registro On-Line de Boletos), esta funcionalidade já estava disponível nos fontes da pasta Branches (para testes) e passamos para a pasta Trunk2 para que seja possível a homologação por mais usuários do Projeto ACBr.

Lembrando que não são todos os bancos que disponibilizam este tipo de serviço via WebService, sendo que os bancos listados abaixo já foram implementados no projetos até o momento, sendo necessário a homologação e testes por empresas que realmente possuam cadastro com o Banco para este tipo de serviço... Pois sem um pré-cadastro para esse serviço não é possível realizar todos os testes em homologação.

A estrutura do WebService no componente ACBrBoleto foi implementada nos moldes dos componente ACBrDFe, sendo assim, mesmo NÃO existindo um padrão entre os Bancos, será possível implementar todos utilizando essa estrutura como base. Se alguém desejar contribuir com outros Bancos, poderá analisar os fontes e seguir o mesmo modelo, toda contribuição é bem-vinda!!!

Cada Banco exige dados específicos para integração, sendo assim disponibilizamos junto ao Exemplo demonstração (DemoACBrBoleto) o arquivo “configWebService.txt” com as orientações de configuração para integração On-Line.

 

BANCOS SUPORTADOS POR WEBSERVICE / API:

 

ATENÇÃO: Sistemas que utilizam classes de ENUMERADOS dependentes do Projeto ACBrBoleto precisam declarar em seus USES a classe “ACBrBoletoConversao”, pois todas foram migradas para esta Unit. Então se tiver erros de classe do ACBrBoleto não declaradas no seu projeto, basta declarar esta nova Unit…

 

Veja onde ficam as novas configurações para Integração Online:

CedenteWS:

image.png

 

Configurações:

image.png

 

Após configurar os dados de acordo com a recomendação de cada Banco, basta adicionar os Títulos e utilizar o botão: “Registrar Boleto On-Line”. No exemplo, também demonstra como capturar a lista com os retornos de cada Registro de Boleto.

image.png

 

 

 

Uso com ACBrMonitorPlus

Para quem utiliza o ACBrMonitor as configurações para integração WebService / API podem ser realizadas na seguinte tela:

image.png

O métodos para envio é:

https://acbr.sourceforge.io/ACBrMonitor/BOLETOEnviarBoleto.html

 

 

 

Uso com ACBrLibBoleto

Para quem utiliza a lib ACBrLibBoleto.dll as configurações para integração WebService / API podem ser verificadas na documentação, seção [WebService]:

https://acbr.sourceforge.io/ACBrLib/ConfiguracoesdaBiblioteca18.html

O métodos para envio é:

https://acbr.sourceforge.io/ACBrLib/Boleto_EnviarBoleto.html

 

 

 

Qualquer dúvida ou contribuições que venham a surgir no processo de homologação favor criar um novo tópico na seção referente a Boleto.

https://www.projetoacbr.com.br/forum/forum/8-acbrboleto/?do=add

  • Curtir 34
  • Obrigado 7
Consultor SAC ACBr

José Junior
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.

Link para o comentário
Compartilhar em outros sites

  • Moderadores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 


Banco do Brasil - API

Orientações para Boleto Híbrido:

//Dados para Homologaçao devem sem adquiridos no portal do banco do brasil developers / credencial
 ACBrBoleto.Cedente.CedenteWS.ClientID      := client_id
 ACBrBoleto.Cedente.CedenteWS.ClientSecret  := client_secret
 ACBrBoleto.Cedente.CedenteWS.Scope         := cobrancas.boletos-info%20cobrancas.boletos-requisicao
 ACBrBoleto.Cedente.CedenteWS.KeyUser       := developer_application_key
 ACBrBoleto.Cedente.CedenteWS.IndicadorPix  := True; //utilizado para boleto hibrido, necessário o cliente possuir chave PIX no banco do brasil
 ACBrBoleto.WebServices.Ambiente            := taHomologacao
 
 ACBrBoleto.WebServices.TimeOut             := 30000
 ACBrBoleto.WebServices.Operacao            := tpConsulta; [tpConsulta,tpAltera,tpBaixa,tpInclui,tpConsultaDetalhe, tpPIXCriar, tpPIXCancelar, tpPIXConsultar] // utilizado para o tipo de operação

...................................................................... 
 Título - ex campos:
     ACBrBoleto.Cedente.CodigoCedente        := '4863177';
     ACBrBoleto.Cedente.Convenio                := '1014051';
     ACBrBoleto.Cedente.Modalidade           := '35'; 
     Carteira                                := '17'; 
     EspecieDoc                                 := 'DM'; 
//Campos devem ser preenchidos conforme dados do Banco


------------------------------------------------------------------------------------
Banco do Brasil por WebService

 

 //Dados para Homologaçao
 ACBrBoleto1.Cedente.CedenteWS.ClientID:= 'eyJpZCI6IjgwNDNiNTMtZjQ5Mi00YyIsImNvZGlnb1B1YmxpY2Fkb3IiOjEwOSwiY29kaWdvU29mdHdhcmUiOjEsInNlcXVlbmNpYWxJbnN0YWxhY2FvIjoxfQ';
 ACBrBoleto1.Cedente.CedenteWS.ClientSecret:= 'eyJpZCI6IjBjZDFlMGQtN2UyNC00MGQyLWI0YSIsImNvZGlnb1B1YmxpY2Fkb3IiOjEwOSwiY29kaWdvU29mdHdhcmUiOjEsInNlcXVlbmNpYWxJbnN0YWxhY2FvIjoxLCJzZXF1ZW5jaWFsQ3JlZGVuY2lhbCI6MX0';
 ACBrBoleto1.Cedente.CedenteWS.Scope:= 'cobranca.registro-boletos'; 
 ACBrBoleto1.Cedente.CedenteWS.KeyUser:='J1234567';   //

//Campos devem ser preenchidos conforme dados do Banco
 Título ex campos:
     ACBrBoleto1.Cedente.CodigoCedente     := '4863177';
     ACBrBoleto1.Cedente.Convenio          := '1014051';
     ACBrBoleto1.Cedente.Modalidade        := '19'; 
     Carteira            := '17'; 
     EspecieDoc         := '99'; 
 
------------------------------------------------------------------------------------ 

//Configuracoes/WebService

TimeOut: 30000
UseCertificateHTTP: False
versao:= 1.2


 

  • Curtir 4
Consultor SAC ACBr

José Junior
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.

Link para o comentário
Compartilhar em outros sites

  • Moderadores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 


Caixa Econômica

 

//Dados para Homologaçao
  ACBrBoleto1.Cedente.CedenteWS.ClientID:=  SGCBS02P 

//Campos devem ser preenchidos conforme dados do Banco
 Título ex campos:
      QtdePagamentoParcial:= 1;
      TipoPagamento:= tpNao_Aceita_Valor_Divergente;
      PercentualMinPagamento:= 0;
      PercentualMaxPagamento:= 0;
      ValorMinPagamento:=0;
      ValorMaxPagamento:=0;
      Carteira  := 'RG'; 
      EspecieDoc:= '99'; 

------------------------------------------------
 ACBrBoleto.WebServices.TimeOut             := 30000
 ACBrBoleto.WebServices.UseCertificateHTTP  := False
 ACBrBoleto.WebServices.Operacao            := tpConsulta; [tpConsulta,tpAltera,tpBaixa,tpInclui] // utilizado para o tipo de operação

 

 

 

  • Curtir 4
Consultor SAC ACBr

José Junior
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.

Link para o comentário
Compartilhar em outros sites

  • Moderadores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 

Itaú
Versão 1 (antiga)

//Campos para homologacao de acordo com dados fornecidos pelo banco

    ACBrBoleto1.Cedente.CedenteWS.ClientID:= ....
    ACBrBoleto1.Cedente.CedenteWS.ClientSecret:= .....
    ACBrBoleto1.Cedente.CedenteWS.Scope:= 'readonly';
    ACBrBoleto1.Cedente.CedenteWS.KeyUser:= ....;
	ACBrBoleto1.Configuracoes.WebService.VersaoDF  := ; (não informar)

//Campos devem ser preenchidos conforme dados do Banco

    ACBrBoleto1.Cedente.CodigoCedente:= ......
    ACBrBoleto1.Cedente.Modalidade:= '19';   

-------------------------------------------
 
 ACBrBoleto.WebServices.TimeOut             := 30000
 ACBrBoleto.WebServices.UseCertificateHTTP  := False
 ACBrBoleto.WebServices.Operacao            := tpInclui // utilizado para o tipo de operação

Versão 2

Necessário cadastro no Portal: https://devportal.itau.com.br

Observação: mesmo com as credenciais geradas pelo portal, não sei se foi algum bloqueio por instabilidade 
mas as minhas credenciais só funcionaram após eu contatar o suporte relatando que estava com acesso negado.

//Campos para homologacao de acordo com dados fornecidos pelo banco

    ACBrBoleto1.Cedente.CedenteWS.ClientID:= criado no portal
    ACBrBoleto1.Cedente.CedenteWS.ClientSecret:= criado no portal
    ACBrBoleto1.Cedente.CedenteWS.Scope:= 'boletoscash-boletos-consulta_titulo';
    ACBrBoleto1.Cedente.CedenteWS.KeyUser:= ; (não informar)
    ACBrBoleto1.Configuracoes.WebService.VersaoDF  := 'V2'; (V2 significa que vai utilizar a versão corrente da API)

//Campos devem ser preenchidos conforme dados do Banco

    ACBrBoleto1.Cedente.CodigoCedente:= ......
    ACBrBoleto1.Cedente.Modalidade:= ....;   

-------------------------------------------
 
 ACBrBoleto.WebServices.TimeOut             := 30000
 ACBrBoleto.WebServices.Operacao            := tpInclui // utilizado para o tipo de operação

 

  • Curtir 6
Consultor SAC ACBr

José Junior
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.

Link para o comentário
Compartilhar em outros sites

  • Moderadores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 

Solicitar para o gerente da conta liberar o produto COBRANÇA ONLINE
Entrar na conta, no meu COBRANÇA e ir na opção CÓDIGO DE ACESSO->GERAR. Será gerado um token.

Sicredi - API Versão ECOMM

//Configuração do componente ( Não há modo de homologação.. é tudo em produção )
    ACBrBoleto1.Cedente.CedenteWS.ClientID:= ( token gerado conforme explicado acima )
    
    //Somente essa opção é necessária, pois a cada requisição o ACBR envia esse token pro banco e
    //recebe outro token para a operação solicitada.
    
    //-- Demais configurações como de costume nos outros bancos
    //-- Recomendado utilizar arquivo pfx com openSSL
  
    ACBrBoleto.WebServices.TimeOut             := 30000
    ACBrBoleto.WebServices.UseCertificateHTTP  := False

Sicredi - API Versão V2

   // O que vai definir que será utilizada a API V2 é a propriedade abaixo:
   ACBrBoleto.Configuracoes.WebService.VersaoDF := 'V2';
   ACBrBoleto.Cedente.CedenteWS.ClientID := Código Beneficiário + Código Cooperativa;
   ACBrBoleto.Cedente.CedenteWS.ClientSecret := solicitar no Internet Banking;
   ACBrBoleto.Cedente.CedenteWS.KeyUser := x-api-key;
   ACBrBoleto.Cedente.CedenteWS.Scope := 'cobranca';
   ACBrBoleto.Cedente.Agencia := cooperativa;
   ACBrBoleto.Cedente.AgenciaDigito := posto;
   ACBrBoleto.Cedente.CodigoCedente := código beneficiário
     
   //-- Demais configurações como de costume nos outros bancos
   //-- Recomendado utilizar arquivo pfx com openSSL
  
   ACBRBoleto.Configuracoes.WebService.SSLType                      := LT_TLSv1_2;
   ACBRBoleto.Configuracoes.WebService.TimeOut                      := 20000;

Informações adicionais para quem vai utilizar a V2
O Usuário @Desenv. AT Info Sistemas reportou que:

OBS: Para validações no ambiente Sandbox, utilizar os seguintes valores para os campos “username” , “password”, “cooperativa”, “posto” e “codigoBeneficiario”:
(Vide manual pagina 12)

ACBrBoleto.Cedente.CedenteWS.ClientID := 123456789
ACBrBoleto.Cedente.CedenteWS.ClientSecret := teste123

(Vide manual pagina 35)
cooperativa : 6789
posto: 03
codigoBeneficiario: 12345

Link do post sobre SandBox reportado acima, clique aqui.
 

  • Curtir 5
  • Obrigado 1
Consultor SAC ACBr

José Junior
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.

Link para o comentário
Compartilhar em outros sites

  • Moderadores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 

 

PenseBank

https://www.mentesquepensam.com.br/

https://pensebank.com.br/

//Dados para Homologaçao devem ser adquiridos abrindo uma conta no site https://pensebank.com.br/
 ACBrBoleto.Cedente.CedenteWS.ClientID      := client_id
 ACBrBoleto.Cedente.CedenteWS.KeyUser       := utilizar o CNPJ da Software House
 ACBrBoleto.Cedente.CedenteWS.IndicadorPix  := True; //utilizado para boleto hibrido
 ACBrBoleto.Cedente.CedenteWS.IndicadorSMS  := False; //utilizado para envio por SMS
 ACBrBoleto.Cedente.CedenteWS.IndicadorEmail := False; //utilizado para envio de email
 ACBrBoleto.WebServices.Ambiente            := taHomologacao
  
 ACBrBoleto.WebServices.TimeOut             := 30000
  ACBrBoleto.WebServices.Operacao            := tpConsulta; [tpConsulta,tpAltera,tpBaixa,tpInclui,tpConsultaDetalhe, tpPIXCriar, tpPIXCancelar, tpPIXConsultar] // utilizado para o tipo de operação

 

  • Curtir 3
Consultor SAC ACBr

José Junior
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.

Link para o comentário
Compartilhar em outros sites

  • 7 meses depois ...
  • Consultores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 

 

Inter
 

Citar

   //Campos para homologacao de acordo com dados fornecidos pelo banco
   -- Demais configurações como de costume nos outros bancos

    ACBRBoleto1.Configuracoes.WebService.ArquivoCRT   := Caminho e arq CRT ('C:\INTER\InterAPI_Certificado.crt';)
    ACBRBoleto1.Configuracoes.WebService.ArquivoKEY   := Caminho e arq Key ('C:\INTER\InterAPI_Chave.key';)

    ACBRBoleto1.Configuracoes.WebService.SSLType                      := LT_TLSv1_2;
    ACBRBoleto1.Configuracoes.WebService.TimeOut                      := 10000;
   Como obter ClientID e ClientSecret, clique aqui
    ACBrBoleto1.Cedente.CedenteWS.ClientID:= ....
    ACBrBoleto1.Cedente.CedenteWS.ClientSecret:= .....
    ACBrBoleto1.Cedente.CedenteWS.Scope:= boleto-cobranca.write; (conforme manual/documentação)

 

 

  • Curtir 5
Consultor SAC ACBr

Daniel de Morais (Infocotidiano)
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.  Discord

Link para o comentário
Compartilhar em outros sites

  • 2 semanas depois ...
  • Consultores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 

Bancoob (Sicoob)

 

//Campos para homologacao de acordo com dados fornecidos pelo banco
-- Demais configurações como de costume nos outros bancos

AcBrBoleto.Cedente.CedenteWS.ClientID       := Client_Id gerado no portal developpers sicoob;
AcBrBoleto.Cedente.CedenteWS.ClientSecret  := Client_Id gerado no portal developpers sicoob;
AcBrBoleto.Cedente.CedenteWS.KeyUser 	   := Access token (Bearer) portal developpers sicoob;
AcBrBoleto.Cedente.CedenteWS.IndicadorPix  := True; //para boleto híbrido
        
AcBrBoleto.Configuracoes.WebService.Ambiente           := taProducao; //Só tem produção
AcBrBoleto.Configuracoes.WebService.SSLCryptLib        := cryOpenSSL;
AcBrBoleto.Configuracoes.WebService.SSLHTTPLib         := httpOpenSSL;
AcBrBoleto.Configuracoes.WebService.SSLType            := LT_TLSv1_2;
AcBrBoleto.Configuracoes.WebService.TimeOut            := 30000;
AcBrBoleto.Configuracoes.WebService.UseCertificateHTTP := True;

AcBrBoleto.Configuracoes.WebService.ArquivoCRT         := 'c:\ChavePublica.pem'; 
AcBrBoleto.Configuracoes.WebService.ArquivoKEY         := 'c:\ChavePrivada.key'; 

Para extrair do certificado CRT e KEY, segue o link do post: https://www.projetoacbr.com.br/forum/topic/73380-exportar-certificado-pem-crt-e-key/



ACBrBoleto1.Cedente.CedenteWS.Scope :=  'cobranca_boletos_consultar '+
  'cobranca_boletos_incluir '+
  'cobranca_boletos_pagador '+
  'cobranca_boletos_segunda_via '+
  'cobranca_boletos_descontos '+
  'cobranca_boletos_abatimentos '+
  'cobranca_boletos_valor_nominal '+
  'cobranca_boletos_seu_numero '+
  'cobranca_boletos_especie_documento '+
  'cobranca_boletos_baixa '+
  'cobranca_boletos_rateio_credito '+
  'cobranca_pagadores '+
  'cobranca_boletos_negativacoes_incluir '+
  'cobranca_boletos_negativacoes_alterar '+
  'cobranca_boletos_negativacoes_baixar '+
  'cobranca_boletos_protestos_incluir '+
  'cobranca_boletos_protestos_alterar '+
  'cobranca_boletos_protestos_desistir '+
  'cobranca_boletos_solicitacao_movimentacao_incluir '+
  'cobranca_boletos_solicitacao_movimentacao_consultar '+
  'cobranca_boletos_solicitacao_movimentacao_download '+
  'cobranca_boletos_prorrogacoes_data_vencimento '+
  'cobranca_boletos_prorrogacoes_data_limite_pagamento '+
  'cobranca_boletos_encargos_multas '+
  'cobranca_boletos_encargos_juros_mora '+
  'cobranca_boletos_pix '+
  'cobranca_boletos_faixa_nn_disponiveis';

 

  • Curtir 7
Consultor SAC ACBr

Daniel de Morais (Infocotidiano)
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.  Discord

Link para o comentário
Compartilhar em outros sites

  • Consultores

EXEMPLO DE CONFIGURAÇÃO DO COMPONENTE ACBR BOLETO 

Santander
Site para solicitar credenciais(Homologação/Produção) Santader: https://developer.santander.com.br/
Você não precisa alterar nada nos seus fontes, apenas solicitar credenciais para o ambiente de homologação com o seu especialista Cash. 
Para utilizar o endpoint de homologação: trust-open-h.api.

Citar

ACBrBoleto.Cedente.CedenteWS.ClientID   := client_id informado pelo banco via link acima
ACBrBoleto.Cedente.CedenteWS.ClientSecret  := client_secret informado pelo banco via link acima
ACBrBoleto.Cedente.CedenteWS.KeyUser  := Informar o WorkSpace favor utilizar manual do link acima e procurar por workspaces (criado uma única vez)
ACBrBoleto.WebServices.Ambiente   := Homologação e Produção em funcionamento
ACBRBoleto.Configuracoes.WebService.ArquivoCRT   := Caminho e nome do arquivo CRT ou PEM ('C:\Certificado.crt';) //Extrair do certificado do cliente
ACBRBoleto.Configuracoes.WebService.ArquivoKEY   := Caminho e arquivo Key ('C:\Chave.key';) //Extrair do certificado do cliente

ACBrBoleto.Configuracoes.WebService.VersaoDF := 'V1';

 ACBRBoleto.Configuracoes.WebService.SSLType  := LT_TLSv1_2;
 ACBRBoleto.Configuracoes.WebService.TimeOut   := 20000;

 

Atenção para o EndPoint de Testes do Santander API, leia o tópico abaixo:

 

  • Curtir 3
Consultor SAC ACBr

Daniel de Morais (Infocotidiano)
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.  Discord

Link para o comentário
Compartilhar em outros sites

  • 6 meses depois ...
  • Consultores

Banco Safra
Solicitar credenciais de autenticação no servidor oAuth 2.0 junto a Central de Suporte Pessoa Jurídica conforme manual.
 

    FACBrBoleto.Cedente.CedenteWS.ClientID:= deve ser enviado o client id recebido do Banco Safra
    FACBrBoleto.Cedente.CedenteWS.ClientSecret:= deve ser enviado o usuário recebido do Banco Safra.
    FACBrBoleto.Cedente.CedenteWS.Scope:= Deixar em Branco
    FACBrBoleto.Cedente.CedenteWS.KeyUser:= deve ser enviada a senha recebida do Banco Safra.
  • Curtir 1
Consultor SAC ACBr

Daniel de Morais (Infocotidiano)
Ajude o Projeto ACBr crescer - Assine o SAC

Projeto ACBr     Telefone:(15) 2105-0750 WhatsApp(15)99790-2976.  Discord

Link para o comentário
Compartilhar em outros sites

×
×
  • Criar Novo...

Informação Importante

Colocamos cookies em seu dispositivo para ajudar a tornar este site melhor. Você pode ajustar suas configurações de cookies, caso contrário, assumiremos que você está bem para continuar.