Tópico Nº: 195 : - Título: Habilitando e Configurando o GFIL Para Integração com APIs de Bancos (Boletos e PIX)

Existem diversas APIs de terceiros que são integradas no GFIL.
Aqui neste tópico abordaremos as relacionadas a:
- Recebimentos de PIX dinâmicos
e
- Emissão de boletos

Cada banco ou empresa que disponibiliza o consumo de APIs tem suas próprias exigências e regras para que o usuário inicie a sua utilização.
Abaixo listaremos as exigências, configurações e procedimentos necessários no GFIL.
Atenção: os endereços e menus dos sites de terceiros, informados abaixo, poderão ser alterados por eles a qualquer momento sem que sejamos comunicados e, nesse caso, este manual poderá não estar atualizado em relação a esses endereços. Por isso sempre mantenha contato com o suporte de seu banco. Eles sempre terão essas informações atualizadas.
Também procure ter contato com uma revenda GFIL, a qual poderá fazer os procedimentos necessários junto ao banco, se for o caso.
É importante salientar também que o seu cadastro no sistema do banco não será detalhado aqui. O objetivo deste tópico é apenas orientá-los nos procedimento no GFIL. Para orientações sobre como configurar/habilitar sua conta lá no banco, você deve contactar o suporte deles, ou ainda solicite o auxílio de uma revenda GFIL.

Muito bem, vamos lá:

1) K8 (Banco Arbi)

1. As orientações completas para a integração K8 (Banco Arbi) estão no tópico 191 deste manual de ajuda.

2) Banco Inter

1. No módulo de cadastro de contas bancárias do GFIL: incluir uma conta bancária e informar o código do banco 077. Informe todos os demais dados que devem ser os dados reais de sua conta no banco. A chave PIX, neste caso, deve ser obrigatoriamente informada;

2. No site do banco Inter -> https://bancointer.com.br/: abrir sua conta;

3. No seu internet banking, acione o menu "Conta Digital -> Aplicações". Nessa tela você deverá gerar a aplicação com permissão para geração de PIX. Depois baixe os arquivos de certificados e também copie sua client ID e secret ID que serão disponibilizadas na plataforma. Em caso de dúvidas, consulte seu suporte do banco ou chame uma revenda GFIL;

4. Para vincular os arquivos ao GFIL, analise as informações de "Incluindo Chaves .crt e .key no GFIL", no final deste tópico;

5. O próximo passo será informar o client ID e secret ID no GFIL, nos respectivos campos do cadastro da conta bancária;

3) Cooperativa Sicoob

1. Você vai precisar de um certificado digital, modelo A1;

2. No módulo de cadastro contas bancárias do GFIL: incluir uma conta bancária e informar o código do banco 756. Informe todos os demais dados que devem ser os dados reais de sua conta no banco. A chave PIX, neste caso e o campo "Client ID", devem ser obrigatoriamente informados;

3. No portal do Sicoob -> https://developers.sicoob.com.br/ é preciso efetuar um cadastro do aplicativo. Veja com seu gerente como proceder.
   Após o cadastro do aplicativo será disponiblizado o seu "Cliente ID", o qual você precisará informar no GFIL;

4. Você também precisará providenciar os arquivos de chaves públicas.
   Para fazer esse vínculo dos arquivos ao GFIL, analise as informações de "Incluindo Chaves .crt e .key no GFIL", no final deste tópico;

Obs.: o gerente de sua conta poderá lhe perguntar se a aplicação GFIL é cadastrada como parceira Sicoob. Informe que não é. Existe essa opção no sistema Sicoob, mas é tão complexo o processo de cadastramento que optamos por não fazê-lo. Mas isso não impede de você utilizar a API Sicoob integrada no GFIL, tanto para emissão de boletos, como PIX dinâmico. Basta seguir os passos acima descritos;

4) Cooperativa Sicredi

1. Entre em contato com seu gerente do banco para liberar a utilização de API na sua conta;

3. Você também precisará providenciar os arquivos de chaves públicas.
   Para fazer esse vínculo dos arquivos ao GFIL, analise as informações de "Incluindo Chaves .crt e .key no GFIL", no final deste tópico;

4. O seu internet banking também disponibilizará quatro informações: client id, client secret, token e código de acesso. Copie esses dados para os respectivos campos no cadastro da conta bancária no GFIL.
   
   Observações:
   a) Para a parte operacional de obtenção de arquivos e credenciais no seu banco, bem como as configurações e solicitações que lá se fizerem necessárias, você deverá contactar o seu banco. As revendas GFIL também têm esse conhecimento para executar todos os procedimentos necessários à habilitação de sua empresa para recebimento de PIX dinâmicos e/ou emissão de boletos on line;
   b) No caso da Sicredi, há um dado que no sistema da API, é denominado de "código do beneficiário". Normalmente esse dado é o mesmo do número da conta. Contudo, algumas cooperativas Sicredi, têm um campo específico para esse dado. Como essa informação precisa ser incluída na API, quando esse dado (código do beneficiário) da sua cooperativa for diferente do número da conta, você deve informá-lo no campo "Código do cedente" no cadastro da conta bancária.
   Atenção: só informe o código do cedente se ele for diferente do número da conta. Se for igual, deixe o campo em branco.

Arquivos de chaves privada
Alguns bancos exigem arquivo de certificação para a autenticação na API. São 2 arquivos: nomeArquivo.key e nomeArquivo.crt ou nomeArquivo.cer ou nomeArquivo.pem.

Se for esse o caso de seu banco, ou seja, se para consumir a API você precisar vincular as chaves com o GFIL, proceda conforme detalhado abaixo em "Incluindo Chaves .crt e .key no GFIL". Obs.: Normalmente esses arquivos são disponibilizados pelo próprio banco. Mas também há casos em que é possível gerar esses arquivos pelo seu certificado digital. Consulte o suporte do seu banco para mais informações sobre esses arquivos e veja como gerar esses arquivos no GFIL, no final deste tópico.
Já se os arquivos devem ser arquivos gerados no seu banco, aí você precisará contactar o suporte do banco.

Incluindo Chaves .crt e .key no GFIL
De posse dos arquivos chaves, você deve registrá-los no GFIL. Para isso acione o menu "Diversos -> Importar Arquivos Chaves (.crt e .key) (Conta Selecionada)" do módulo de cadastro de contas bancárias.
Obs.: esse procedimento deve ser feito individualmente, ou seja, para cada conta bancária cuja API exija a autenticação por certificado.

Obs. II: se for possível gerar os arquivos a partir do seu certificado digital, então você pode fazer isso no próprio GFIL. Acione o menu "Utilidades -> Exportar Chaves (.crt e .key) do Certificado Digital", da tela principal do GFIL.
Obs.: essa exportação só é possível com certificado do tipo A1.

Veja também

• Geração de boletos e outros produtos K8 (Banco Arbi);
• Geração de boletos banco Inter;
• Geração de boletos bancos tradicionais;
• Configuração dos parâmetros gerais.