Open Banking Itaú - Retorno em branco ao tentar registrar um título

De CIGAM WIKI

FAQ_CIGAM > FAQ_Finanças > Gestão Financeira > Open Banking Itaú - Retorno em branco ao tentar registrar um título

Importante: As dicas e orientações contidas neste documento referem-se a casos atendidos em Ordens de Serviço do Suporte. Portanto, são sugestões para possíveis soluções relacionadas às situações apresentadas.
Podem existir casos que não sejam completamente resolvidos ao seguir as dicas desta WIKI. No entanto, a premissa para o atendimento é que, inicialmente, sejam avaliadas estas orientações.

Retorno em branco ao tentar registrar um título

Quando a parametrização de credenciais de Open Banking do Itaú via Assistente de Configuração do Open Banking do CIGAM informar que a comunicação foi realizada corretamente (sinaleira na cor verde), porém, ao tentar registrar um título ocorre Erro e não há informação nenhuma na guia "Retorno" no Histórico Open Banking, verificar se o Scope das credenciais fornecidades está correto possuindo as devidas autorizações para realizar registros de títulos. Também verificar se a instalação e as permissões do certificado estão de acordo, pois também podem ocasionar o mesmo erro

O Scope de uma credencial (client_id e client_secret) refere-se ao seu Escopo de trabalho, ou seja, o que a credencial tem permissão de realizar. Por exemplo, uma credencial com scope apenas para Consultar/Retornar os títulos, não conseguirá Registrar títulos, pois não faz parte do seu escopo. Isso não significa que a credencial é inválida, apenas que não possui autorização para realizar alguns métodos da API bancária, por isso que a validação no Assistente de Configuração do Open Banking do CIGAM sinaliza como válida, porém, o problema ocorre apenas ao tentar realizar uma operação não permitida para a credencial.

Parametrização via Assistente sinaliza como Sucesso
FAQ Conclusao Assistente.png


Retorno em branco no Histórico Open Banking
FAQ Retorno Em Branco.png


Para verificar se o Scope da credencial está incorreto, foi disponibilizado a partir da versão CIGAM 221107.b o botão "Validar" nas Parametrizações Open Banking. Ao acionar este botão, será realizada uma tentativa de conexão com a API bancária, onde para os bancos onde as suas credenciais possuem um scope atrelado, será exibida a informação do escopo para aquela credencial.


Botão "Validar" nas Parametrizações Open Banking
FAQ Botao Validar.png


Exemplo de credencial Itaú com Scope correto para API de Cash
FAQ Validar API Cash.png


Exemplo de credencial Itaú com Scope correto para API de Bolecode
FAQ Validar API Bolecode.png


Exemplo de credencial Itaú com Scope incorreto, sem permissão para executar nenhuma operação (Registro, Baixa, Alteração, Consulta/Retorno, Bolecode)
FAQ Validar API Erro Scope.png


Ocorrendo a constatação que o Scope das credenciais fornecidas pelo banco estão incorretas, o banco Itaú deverá ser acionado. Para que, preferencialmente se possível, ajuste o Scope das credenciais já geradas, incluindo os escopos necessários. Ou então, caso geradas novas credenciais pelo banco Itaú com client_id diferente, deverá ser gerado um novo certificado, pois o Common Name (CN) do certificado para Open Banking do Itaú sempre deverá ser o próprio client_id fornecido pelo banco. Também deve ser observado o propósito de uso da credencial, se for com o objetivo de registrar boleto sem QRCode, a credencial deve conter os respectivos scopes da API de Cash. E para Bolecode, os respectivos Scopes para tal, conforme imagens acima.

Importante: Essa situação não é ocasionada por qualquer questão envolvendo criação do certificado ou versão do CIGAM. Trata-se de processo interno do banco Itaú no momento da geração das credenciais, portanto, somente o banco Itaú poderá realizar o ajuste dos Scopes das credenciais existentes ou criação de novas com os Scopes de acordo.