Integração Bolepix Itaú

Configuração:

Para iniciar a configuração junto ao Itaú, é necessário possuir as informações de Client ID e um Token Temporário, fornecidos pelo banco. Com esses dados, siga os passos abaixo:

1. Preparação do OpenSSL

Observação: É obrigatório utilizar a versão 3.5.2 do OpenSSL, para que o comando execute corretamente.

2. Geração da Requisição de Certificado

  • Após abrir o OpenSSL, execute o seguinte comando: 
    openssl req -new -sha512 -subj "/CN=(CLIENT_ID)/OU=EXCIA/L=INDAIAL/ST=SC/C=BR" -out certificado.csr -nodes -newkey rsa:2048 -keyout certificado_001.key
  • Substitua (CLIENT_ID) pelo valor recebido por e-mail do Itaú.

3. Arquivos Gerados

Na pasta raiz do usuário no Windows serão criados dois arquivos:

  • ARQUIVO_REQUEST_CERTIFICADO.csr
  • ARQUIVO_CHAVE_PRIVADA.key

4. Download da Collection Postman

Baixe a coleção necessária para a integração pelo link:
Collection Postman Itaú

5. Importação no Postman

  • Abra o Postman.
  • Importe a coleção baixada.

6. Configuração da Requisição

  • Dentro da pasta Ativação Certificado Dinâmico, localize o método POST – Envio de arquivo .csr.
  • Verifique se a URL está correta: 
    https://sts.itau.com.br/seguranca/v1/certificado/solicitacao
  • Na aba Authorization, configure:
    • Auth Type: Bearer Token
    • Token: informar o token temporário recebido do banco.

7. Envio do Arquivo .csr

  • Abra o arquivo ARQUIVO_REQUEST_CERTIFICADO.csr no modo texto.
  • Copie todo o conteúdo e cole no Body da requisição no Postman.
  • Clique em SEND para enviar ao Itaú.

8. Retorno do Banco

Após o envio, serão retornadas duas informações:

  • Secret
  • Conteúdo de um novo certificado
  • Atenção:
  • Salve o conteúdo retornado como Certificado_pathEmpresa.crt.
  • Na pasta raiz do Excia, crie uma nova pasta chamada Certificado crie nesta pasta uma pasta chamada 341.
  • Salve dentro dela:
    • O arquivo Certificado_pathEmpresa.crt
    • O arquivo de chave privada, renomeado para Certificado_pathEmpresa.key

Observação: Este procedimento deve ser repetido sempre que o certificado digital for renovado, pois a renovação também precisa ser atualizada junto ao Banco Itaú.

Configuração no ERP

Após o envio e armazenamento dos certificados, configure as credenciais no EXCIA ERP, conforme os passos abaixo:

  1. Acesse a tela  0435 – Carteiras de Cobrança
  2. Localize a carteira vinculada à conta utilizada na contratação do Bolepix.
  3. Preencha os campos obrigatórios com as informações fornecidas pelo Itaú:
    • Chave Aplicação: informar o Client ID recebido por e-mail.
    • Chave Autorização: informar o Secret retornado pelo Postman.