Como solicitar os dados necessários
Para começar a utilizar o registro instantâneo do Banco Inter, é necessário possuir um certificado digital emitido pelo próprio Banco Inter, e ter uma conta ativa no banco. O Banco Inter descreve o processo completo na documentação https://ajuda.inter.co/conta-digital-pessoa-juridica/como-faco-o-download-do-arquivo-crt onde foi referência para elaborar este.
OBS: Para o Banco Inter via Web Service, o banco Inter realiza a integração apenas para pessoa Jurídica.
O certificado digital deverá ser emitido através da conta digital do cedente acessando https://contadigitalpj.bancointer.com.br/ e seguindo os passos abaixo:
1. Criar Aplicação na conta do banco Inter:
- O primeiro passo para realizar a integração com o WebService, é acessar a sua conta do Banco Inter, utilizando uma conta de pessoa Jurídica:
- Depois de acessar a conta, no menu principal selecione a opção Conta Digital, e em sequência as opções Aplicação -> Nova aplicação.
- Após acessar este campo, você vai precisar definir um nome e descrição para sua aplicação. Importante ressaltar que este campo é livre, e você pode preenche-lo da maneira que considerar melhor, visto que, seu preenchimento tem apenas a finalidade de manter um controle sobre as aplicações que comunicam com o Inter. Portanto, é necessário apenas preencher os campos e depois selecionar o botão "Próximo".
- Em seguida, garanta que as permissões demonstradas na imagem a seguir estão marcadas, e logo após selecione o botão "Criar Aplicação".
- Após finalizar o passo anterior, sua aplicação vai ser criada com sucesso, e para completar a integração será preciso selecionar a opção "Baixar chaves e certificados".
- Depois selecione o botão "Sim", confirmando a geração das credenciais necessárias.
- E com isso, o certificado será gerado, e deve ser salvo em sua máquina, para que possamos continuar com a integração do WebService no PlugBoleto.
2. Cadastrar o Certificado Digital na API PlugBoleto:
- O certificado fornecido pelo banco Inter normalmente vem na extensão .crt com a .key, e a API de boletos aceita somente os formatos PFX, com isso é necessário realizar a conversão do certificado antes de poder realizar o upload dele. Assim, para realizar esse procedimento os passos estão descritos aqui.
- Após realizar a conversão do certificado para o formato aceito em nossa API, basta fazer o upload do certificado, com extensão .PFX. Este pode ser realizado via API ou Portal. Para tal veja esses passos: Cadastrar certificado para Convênio via API ou Cadastrar certificado para Convênio via GUI WEB.
Uma observação é que após fazer o upload do certificado, o PlugBoleto irá realizar a sincronização deste e pode levar até 1h.
3. Ativar o WebService no cadastro do convênio:
- Agora que já temos o certificado digital cadastrado no PlugBoleto, basta ativarmos o WebService no cadastro do convênio, conforme demonstrado nos passos abaixo:
- Na área de "Cadastro de convênio", selecione a opção "Configuração do convênio":
- Depois disso, marque o checkbox para as informações "Reiniciar número de remessa diariamente", "Carteira escritural" e "Registro instantâneo", conforme demonstrado na imagem abaixo. Além disso, em "Versão do WebService" selecione a opção "v2", e por fim, preencha os campos "API - ID" e "Segredo", com o client id e client secret disponibilizados pelo banco Inter.
- Assim, ao finalizar, clique em "salvar" e realize a geração dos primeiros boletos para teste!
Você também pode realizar o cadastro das informações diretamente utilizando a rota da API via JSON, conforme detalhado na documentação a seguir:
https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360006145374-Cadastrando-um-Conv%C3%AAnio
Abaixo, também segue um JSON de exemplo para demonstrar este cadastro:
{ "ConvenioNumero": "5033", "ConvenioDescricao": "Convenio da tecnospeed", "ConvenioCarteira": "112", "ConvenioEspecie": "R$", "ConvenioPadraoCNAB": "24", "ConvenioApiId":"asbf-vfg5-vf5-cdg4", "ConvenioApiSecret": "asbf-vfg5-vf5-cdg4", "ConvenioRegistroInstantaneo": true, "Conveniotipowebservice": "V2", "ConvenioConsultaws": true, "ConvenioReiniciarDiariamente": true, "conta": 14404 }
Obs.: Os dados que aparecem no cadastro do convênio são fictícios, e foram demonstrados na imagem com a finalidade de exemplificar o preenchimento dos campos. Portanto, o id e secret que aparecem na imagem não devem ser copiados, visto que, os mesmos não existem!
Obs. 2: Atualmente a integração da Tecnospeed junto ao Banco Inter ocorre apenas em ambiente de produção. No ato da integração e na última revisão de recursos do WebService bancário, o ambiente de homologação não havia sido disponibilizado.
Obs.3: Banco INTER aceita apenas CARTEIRA ESCRITURAL, portando não deve se enviar o campo "TituloNossoNumero".
Obs.4: Ao registrar boletos para o Banco INTER via WebService, pode ocorrer um atraso de até 10 minutos para que o boleto seja registrado. Este atraso é incomum, mas é importante estar ciente dessa possibilidade.
Comentários
0 comentário
Artigo fechado para comentários.