GF - Como Fazer - Open Banking

Introdução

O Open Banking CIGAM é o projeto que visa implementar as APIs bancárias (interfaces online de comunicação) no ERP CIGAM. O maior benefício obtido com estas integrações é a eliminação do uso de arquivos CNAB (*.txt) e a migração para uma conexão direta com o banco. Assim o usuário passa a fazer tudo dentro do CIGAM sem precisar entrar no gerenciador financeiro do banco.

Lista de APIs

Atualmente, cada banco possui um escopo próprio de soluções via API. Nas tabelas abaixo são descritos os serviços disponíveis por instituição bancária e a versão CIGAM em que eles foram liberados.

>>INCLUIR IMAGENS<<

Um tópico universal dentre todos eles é o de que para utilizar um serviço, são necessárias credenciais e, em alguns casos, até certificados digitais. No tópico 3 serão apresentadas dicas de como proceder com a obtenção de credenciais em cada instituição.

Migrando um cliente do CNAB para a API Open Banking

A migração de um cliente que hoje está utilizando CNAB para os seus movimentos ocorre de forma transparente, o que está mudando é a forma de registro e não o registro em si. Pense no CNAB como um envio via carta, e o Open Banking como um e-mail, a mensagem chegará de ambas as formas, porém na primeira você precisa levar a mensagem escrita à mão até o correio, já a segunda você digita e envia de casa.

Essa troca de formato possibilita que quando um cliente tiver o seu CIGAM configurado no open banking ele poderá imediatamente realizar o retorno via API e irá obter as informações dos títulos registrados na instituição independentemente da forma de registro. Inclusive, o método de registro via CNAB continua valendo simultaneamente ao uso da API. Desta forma, embora alguns bancos disponibilizem ambientes de homologação, não recomendamos a criação de movimentos de teste nestes ambientes uma vez que existem restrições de CPF/CNPJ exclusivos para teste, situação que o cliente não possuirá.

Configurando APIs Open Banking para clientes novos em período de implementação

Para clientes novos, que não tem como registrar títulos oficiais no CIGAM, recomendamos avaliar a sessão “testes em homologação” dentro de cada sessão do item 5 deste manual para obter informações de como utilizar o ambiente de homologação de cada banco.

Obtenção das Credenciais

Invariavelmente, para obter as suas credenciais, você deverá acessar primeiro o seu Gerente Cash ou gerente de conta PJ na instituição em que está buscando as credenciais. Em muitos casos, ele irá abrir um chamado técnico junto à área responsável para iniciar o seu processo de credenciamento seja através de um portal ou e-mail.

NOTA AOS SETORES DE ATENDIMENTO E IMPLEMENTAÇÃO CIGAM
Independentemente do banco que você estiver configurando, antes de iniciar o processo implementação do Open Banking no CIGAM, é imprescindível ter os dados de credenciais, certificados digitais, scopes etc. em mãos, a primeira página do assistente open banking irá indicar as informações necessárias para cada banco. Recomendamos que o trabalho de implementação/atendimento só seja iniciado após a confirmação da existência de tais dados, uma vez que não está dentro das nossas possibilidades obter tais informações.
Abaixo serão descritos os processos de acordo com cada banco.

Banco do Brasil

As credenciais do Banco do Brasil são geradas através do Portal Developers. Abaixo segue o vídeo de auxílio disponibilizado pelo banco, para maiores informações, entre em contato com o seu gerente de cash (gerente de conta Banco do Brasil)

IMPORTANTE: o usuário criado neste portal deve, obrigatoriamente ser o responsável pela conta corrente PJ. Caso ele seja criado no CPF de outra pessoa, o processo seguirá normalmente, porém as credenciais de acesso não serão aceitas, ocasionando erros do tipo “Forbidden” (apontar aqui o erro de credencial inválida). Para parametrizar o Banco do Brasil serão necessárias as informações de Client_id e Client_secret, ambos obtidos no portal developers para os dois ambientes (homologação e produção), também será apresentado o valor chamado developer_application_key, este valor deve ser desprezado, uma vez que o ERP CIGAM possui o seu próprio.

Para parametrizar o Banco do Brasil serão necessárias as informações de Client_id e Client_secret, ambos obtidos no portal developers para os dois ambientes (homologação e produção), também será apresentado o valor chamado developer_application_key, este valor deve ser desprezado, uma vez que o ERP CIGAM possui o seu próprio.

É importante atentar ao ambiente de cada credencial através do botão de ambiente:

Uma vez em posse das credenciais, basta seguir o fluxo dentro do ERP CIGAM, ele é descrito no próximo tópico.

>>CLIQUE AQUI<< - parametrizacao ambiente