GF - Como Fazer - Open Banking

De CIGAM WIKI
Revisão de 14h55min de 12 de agosto de 2022 por Tais.felles (discussão | contribs) (Migrando um cliente do CNAB para a API 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<<

APIs Cobranca.png


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á.

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. 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 no endereço https://developers.bb.com.br/home


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:

950x700xpx


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

SICOOB

V2

Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.

V1

Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.

texto

texto

texto

texto

texto

texto

texto

texto

texto