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 gerar 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 administrador no Itaú for Developers: só quem tem perfil Administrador ou Owner da empresa no portal consegue criar a aplicação, as credenciais e o certificado. O perfil Developer não tem essa permissão. Se você não tiver esse acesso, peça ao representante legal da empresa ou ao seu gerente no Itaú;
Aprovação do representante legal: a emissão do certificado precisa ser aprovada pelo representante legal da empresa (Owner) no Bankline.
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 Credenciais e certificados;
Clique em Criar credencial;
Escolha o ambiente Produção, preencha o Nome da credencial (até 50 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 Continuar.
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 gerar e baixar o certificado digital
O certificado digital confirma para o Itaú que o acesso vem da sua empresa. Ele é gerado a partir da credencial criada no tópico anterior e é composto por dois arquivos: o certificado (.crt) e a chave (.key).
No card da credencial, clique em Gerar 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;
Preencha os campos Identificação da empresa (até 50 caracteres, apenas letras sem acento e números) e Cidade;
Clique em Gerar certificado;
Clique em Baixar certificado e salve os arquivos no seu computador. Os dois que você vai usar no Mainô são o certificado (.crt) e a chave privada (.key). Se os arquivos vierem compactados (.zip), descompacte-os antes de anexar no Mainô.
Atenção: o portal só deixa você sair da tela depois que o download for concluído. Se o arquivo não baixar, clique em Clique aqui para tentar novamente.
Validade do certificado: o certificado vale por 365 dias. Quando ele estiver perto de vencer, o portal do Itaú e o Mainô avisam você. Para renovar:
No portal do Itaú, clique em Gerar novo certificado no card da credencial. Não é preciso criar uma nova credencial;
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.
Enquanto o certificado antigo não vence, os dois funcionam ao mesmo tempo, então a busca do extrato não é interrompida. Se o certificado vencer, a busca automática para até que um novo seja gerado.
5. 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 apenas informá-los no cadastro da conta bancária do Itaú.
Acesse o menu Usuário > Cadastros > Contas bancárias;
Na conta do Itaú, clique na seta ao lado de Visualizar e selecione Alterar;
Na seção Integração bancária, na linha Extrato bancário, clique em Conectar ao banco;
Preencha os campos Client ID e Client secret;
Em Certificados digitais (.crt e .key), anexe os dois arquivos do certificado;
Clique em Conectar. O sistema valida os dados com o Itaú e, se estiver tudo certo, a conta aparece como conectada.
Importante: a conexão traz os lançamentos a partir do dia em que foi feita e pausa a importação manual de extratos dessa conta. Se ainda houver extratos anteriores para importar, importe-os antes de conectar.
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.