O que você vai aprender neste artigo?
O que você precisa antes de começar;
Como pedir as credenciais ao Itaú;
Como gerar o certificado digital;
Como conectar a emissão de boleto no Mainô;
Como renovar o certificado.
Para emitir boletos com Pix direto pelo Itaú, o Mainô precisa de quatro informações de segurança da sua empresa: o Client ID, o Client Secret, o certificado digital (arquivo .crt) e a chave do certificado (arquivo .key). Diferente do extrato, essas credenciais não são geradas pela sua empresa no portal do Itaú: elas são pedidas ao Itaú, chegam por e-mail e o certificado é gerado com um programa do próprio banco. Neste artigo, você vai ver esse caminho do começo ao fim.
1. O que você precisa antes de começar
Cobrança com Pix contratada no Itaú: a sua empresa precisa ter o serviço de boleto com Pix (Bolecode) e o Pix habilitados na conta. Se ainda não tiver, fale com o seu gerente no Itaú;
Chave Pix cadastrada na conta: a mesma chave vai ser informada no cadastro da conta bancária no Mainô;
Computador preparado para gerar o certificado: o certificado é gerado no computador, com o programa pronto do Itaú ou pelo passo a passo manual. O que é preciso instalar está em Pré-requisitos para se conectar ao ambiente Itaú.
Atenção: as credenciais do extrato não servem para emitir boletos. Mesmo que a sua empresa já tenha conectado o extrato, é preciso pedir credenciais próprias para a cobrança.
Atenção: o Client ID, o Client Secret, o certificado e a chave funcionam como senhas de acesso à sua conta. Guarde tudo em local seguro e não envie por e-mail, WhatsApp ou chat.
2. Como pedir as credenciais ao Itaú
Fale com o seu gerente no Itaú e peça uma credencial de produção da API de cobrança, com os serviços de boleto com Pix (Bolecode), Cash Management e Pix reunidos na mesma credencial. Explique que ela vai ser usada pelo sistema de gestão da sua empresa;
O Itaú vai pedir a chave pública da sua empresa. Ela é gerada no computador junto com uma chave privada, como mostra o guia Certificado dinâmico do Itaú. Envie ao Itaú só a chave pública;
Aguarde o e-mail do Itaú. Ele chega do remetente itau@itau.com.br, com o assunto "Credenciais Itaú", e traz o Client ID, um token temporário e uma chave de sessão, todos cifrados. Um modelo desse e-mail aparece no passo 5 do guia Certificado dinâmico: demais produtos;
Guarde o e-mail: os dados dele são usados para gerar o certificado, no tópico 3.
Atenção: o token temporário vale 7 dias corridos. Faça a etapa do certificado dentro desse prazo. Se o token vencer, peça um novo ao Itaú e aguarde cerca de 1 dia útil.
Atenção: a chave privada nunca deve ser enviada a ninguém, nem ao Itaú. Ela fica guardada com a sua empresa.
3. Como gerar o certificado digital
Esta etapa é feita no computador, seguindo um dos guias oficiais do Itaú:
Certificado dinâmico: traz um programa pronto, recomendado pelo Itaú para quem vai gerar o certificado pela primeira vez;
Certificado dinâmico: demais produtos: mostra o mesmo processo passo a passo, de forma manual.
Em resumo, o processo é:
Decifrar o Client ID e o token temporário do e-mail, usando a chave privada da empresa;
Gerar o pedido de certificado, informando o Client ID e os dados da empresa. Nessa etapa também é criada a chave do certificado (arquivo .key);
Enviar o pedido ao Itaú. A resposta traz o Client Secret e o certificado emitido pelo banco;
Salvar o certificado como arquivo .crt.
Ao final, a sua empresa terá as quatro informações que o Mainô pede: o Client ID, o Client Secret, o certificado (.crt) e a chave (.key).
Atenção: o Client Secret aparece uma única vez, na resposta do Itaú. Se ele for perdido, será preciso refazer o processo.
4. Como conectar a emissão de boleto no Mainô
Com as quatro informações em mãos, informe-as na conta do Itaú em Usuário > Cadastros > Contas bancárias, na seção Integração bancária, linha Emissão de boleto, botão Conectar ao banco. O passo a passo completo, com a Chave Pix e os demais ajustes da conta, está no artigo Como conectar a conta do Itaú para emitir boletos com Pix e ter a baixa automática?
5. Como renovar o certificado
O certificado do Itaú vale por 365 dias. A partir de 30 dias antes do vencimento, a linha Emissão de boleto da conta mostra A expirar. Se o certificado vencer, o Mainô deixa de emitir os novos boletos.
Renove o certificado com o Itaú. A renovação pode ser feita entre 30 dias e 1 dia antes do vencimento, como mostra o guia do certificado dinâmico;
No Mainô, na linha Emissão de boleto da conta, clique em Reconectar e informe de novo o Client ID, o Client Secret e os dois arquivos do novo certificado.
Importante: se o certificado vencer antes da renovação, será preciso pedir um novo token temporário ao Itaú e refazer os tópicos 2 e 3.
Esperamos que este artigo tenha lhe ajudado a obter as credenciais do Itaú para emitir boletos!
Se tiver dúvidas, fale com a Mai pelo chat no sistema ou pelo número de WhatsApp (21) 2224-5777.