Configurações necessárias para o registro de boletos por API do Itaú.
Para a utilização da API do Itaú é necessário a ativação do serviço em sua conta. Esse processo deve ser solicitado diretamente ao seu gerente de conta.
Para estabelecer uma conexão segura com os API Gateways do Itaú é necessário enviar um client certificate. Este certificado é usado para estabelecer o mTLS (OAuth 2.0 Mutual Transport Layer Security).
Mais detalhes do processo de geração do certificado devem ser obtidos no portal do Itaú : https://devportal.itau.com.br/. O acesso ao mesmo deve ser também solicitado ao seu gerente de conta.
O certificado gerado no processo anterior deve ser então convertido, utilizando o Wizard de conversão de certificado - CFGX060 no módulo Configurador - SIGACFG. Com os arquivos convertidos, estes devem ser salvos dentro da pasta cert/ngf (abaixo da pasta protheus_data).
Caso o ambiente esteja utilizando a primeira versão da API (V1) liberada no NGF, que não utiliza certificado, você pode editar o seu layout e assim atualizar para a nova versão, depois de realizados os pontos acima. Novas configurações de contas serão realizadas apenas para a nova versão liberada (V2), com certificado. |
É necessário o cadastro correto do dígito verificador da conta no campo Dv Conta (A6_DVCTA). Caso o cadastro esteja incorreto na tabela de bancos (SA6), o ajuste deve ser realizado em sua subconta no Cadastro Parâmetros de bancos (tabela SEE) nos campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) e DV Cta.Ofic. (EE_DVCTOFI). Exemplo de conta que precisa ser adequada : Conta 12345-6 No cadastro do banco, campo Nro Conta (A6_NUMCOM) = 123456 e DV Conta (A6_DVCTA) = vazio, o ajuste em sua sub conta deve ser Cta. Oficial (EE_CTAOFI) = 12345 e DV Cta.Ofic. (EE_DVCTOFI) = 6 |
Para funcionamento da comunicação bancária por API do Itaú o usuário deve configurar os parâmetros de banco |
Ao iniciar a configuração de layout para uma nova conta do Itaú serão apresentados os passos:
Selecione a conta que deseja realizar a configuração
Nesse passo serão inseridas as informações obtidas junto ao banco no processo de habilitar o serviço em sua conta.
Informe nesse passo o ID do cliente e Chave secreta do cliente fornecidos pelo banco.
Informe o nome do Arquivo chave do certificado e Arquivo de certificado convertidos pelo Wizard de conversão de certificado - CFGX060.
Nesse passo, serão configuradas todas as informações que serão encaminhadas para o banco na transmissão do boleto.