O que você vai aprender neste artigo?
O que você precisa para conectar o extrato do Itaú;
Como criar a aplicação no portal Itaú for Developers;
Como gerar o Client ID e o Client Secret;
Como pedir a aprovação do certificado;
Como emitir e baixar o certificado digital;
Como conectar a conta bancária no Mainô.
Ao conectar a sua conta do Itaú ao Mainô, o extrato bancário chega automaticamente na Conciliação Bancária, sem precisar baixar e importar arquivos. Para liberar essa conexão, o Itaú exige quatro informações de segurança: o Client ID, o Client Secret, o certificado digital (arquivo .crt) e a chave do certificado (arquivo .key). Elas são geradas pela sua empresa no portal do Itaú, e não no Mainô. Neste artigo, você vai ver como gerar cada uma delas e onde informá-las no sistema.
1. O que você precisa para conectar o extrato do Itaú
Antes de começar, confira se a sua empresa atende aos requisitos abaixo. Sem eles, o portal do Itaú não libera a geração das credenciais.
Produto Extrato contratado no Itaú: a sua empresa precisa ter o produto de Extrato (Account Statement) contratado. Se ainda não tiver, fale com o seu gerente de relacionamento no Itaú;
Acesso de Admin no Itaú for Developers: é quem tem perfil Admin no portal que cria a aplicação e a credencial, pede a aprovação e emite o certificado. Se você não tiver esse acesso, peça ao representante legal da empresa ou ao seu gerente no Itaú;
Aprovação de um Owner no Bankline: a emissão do certificado precisa ser aprovada por uma pessoa com perfil Owner da empresa (o representante legal ou uma pessoa delegada por ele), no Internet Banking.
Atenção: o Client ID, o Client Secret e os arquivos do certificado funcionam como senhas de acesso à sua conta. Guarde tudo em local seguro e não envie por e-mail, WhatsApp ou chat.
2. Como criar a aplicação no portal Itaú for Developers
No portal do Itaú, as credenciais ficam dentro de uma "aplicação", que reúne os CNPJs da sua empresa e os produtos contratados.
Acesse o portal Itaú for Developers (devportal.itau.com.br) e faça login. Se você tiver acesso a mais de uma empresa, confira se a empresa certa está ativa pelo botão Trocar vínculo ativo;
No menu lateral, clique em Aplicações e credenciais;
Clique em Criar aplicação;
Informe um nome (entre 4 e 80 caracteres) e uma descrição (até 200 caracteres). Por exemplo: "Integração Mainô – Extrato";
Selecione os CNPJs da empresa que serão vinculados à aplicação. O CNPJ da matriz já vem incluído e não pode ser removido;
Selecione o produto de extrato, clique em Próximo e conclua a criação.
Dica: se o botão Criar aplicação estiver desativado, o produto ainda não foi vinculado à sua empresa. Fale com o seu gerente no Itaú ou clique em Preciso de ajuda no próprio portal.
Atenção: depois de criada a aplicação, os produtos escolhidos não podem ser alterados. Confira a seleção antes de concluir. Se a sua empresa já tiver uma aplicação sem o produto de extrato, crie uma nova.
3. Como gerar o Client ID e o Client Secret
O Client ID e o Client Secret são o "usuário" e a "senha" que o Mainô usa para acessar o seu extrato no Itaú. Eles são gerados dentro da aplicação que você acabou de criar.
Na página da aplicação, clique em Criar credenciais e certificados (ou, no bloco Credenciais recentes, em Gerir credenciais);
Clique em Criar credencial;
Escolha o ambiente Produção, preencha o Nome da credencial (entre 4 e 80 caracteres) e clique em Criar credencial;
Na tela "Credencial criada!", copie o Client ID e o Client Secret e guarde-os em local seguro antes de clicar em Concluir.
Atenção: o Client Secret aparece uma única vez e não fica salvo no portal. Se você perder esse código, será preciso revogar a credencial e criar uma nova. Guarde-o bem: ele volta a ser pedido para gerar o certificado e sempre que você renovar a conexão no Mainô.
4. Como pedir a aprovação do certificado
Antes de emitir o certificado, o Itaú exige a aprovação de um Owner da empresa. O pedido é feito no portal, e a aprovação, no Internet Banking.
No card da credencial, no aviso Falta um passo para emitir o certificado, clique em Pedir aprovação;
Na janela Emitir certificado, preencha Identificação da empresa (até 50 caracteres, apenas letras sem acento e números, por exemplo ABC LTDA), Cidade, País e Estado e clique em Solicitar emissão;
Na janela Aprovação de certificado, clique em Enviar solicitação. O card passa a mostrar Aguardando aprovação por um Owner via Internet Banking;
O Owner aprova o pedido no Bankline (Internet Banking PJ ou BBA), em Ir para Conta Corrente > Configurações e Acessos > Configurar Produtos e Serviços > Integrações e Acessos a APIs.
Atenção: o pedido fica disponível para aprovação por até 7 dias. Depois de aprovado, o certificado precisa ser emitido em até 72 horas. Se algum desses prazos passar, é preciso pedir a aprovação de novo.
5. Como emitir e baixar o certificado digital
O certificado digital confirma para o Itaú que o acesso vem da sua empresa. Ele é composto por dois arquivos: o certificado (.crt) e a chave (.key).
Com a aprovação concluída, o card mostra Aprovação concluída. Clique em Emitir certificado;
No campo Client Secret, informe o Client Secret da credencial e clique em Gerar token temporário. O campo Token temporário é preenchido automaticamente;
Clique em Emitir certificado e aguarde;
Na tela Certificado criado!, clique em Baixar certificado. O navegador vai salvar dois arquivos: o certificado (.crt) e a chave privada (.key). Se ele pedir autorização para baixar vários arquivos, clique em Permitir.
Atenção: o certificado não fica guardado no portal do Itaú. Se a janela for fechada antes do download, será preciso emitir um novo.
Validade do certificado: o certificado vale por 365 dias e pode ser renovado a partir de 30 dias antes do vencimento. Nesse período, a conexão aparece como A expirar no Mainô, na edição da conta bancária e no cartão da conta na Conciliação Bancária. Para renovar:
No portal do Itaú, emita um novo certificado do mesmo jeito que o primeiro, com um novo pedido de aprovação (tópicos 4 e 5). Não é preciso criar uma nova credencial: use o mesmo Client ID e Client Secret;
No Mainô, na linha Extrato bancário da conta, clique em Reconectar e informe de novo o Client ID, o Client Secret e os dois arquivos do novo certificado.
Se o certificado vencer, a busca automática do extrato para até que um novo seja emitido e informado no Mainô.
6. Como conectar a conta bancária no Mainô
Com o Client ID, o Client Secret e os dois arquivos do certificado em mãos, falta informá-los no cadastro da conta bancária do Itaú, na seção Integração bancária, linha Extrato bancário. O passo a passo está no artigo Como conectar a conta do Itaú para receber o extrato automaticamente na Conciliação Bancária?
Esperamos que este artigo tenha lhe ajudado a conectar a sua conta do Itaú!
Se tiver dúvidas, fale com a Mai pelo chat no sistema ou pelo número de WhatsApp (21) 2224-5777.