Banco Inter: visão geral, o lado do banco e onde fica cada assunto
A integração com o Banco Inter liga a conta PJ do Inter ao ERP. Ela faz três coisas: RECEBER, emitindo boleto e cobrança Pix direto do sistema, com a baixa voltando sozinha quando o cliente paga; PAGAR, quitando boleto de fornecedor e DARF pela conta; e CONSULTAR, trazendo extrato e saldo sem abrir o aplicativo do banco.
Esta fonte é a visão geral e o índice da integração. Ela guarda de verdade uma coisa só: o LADO DO BANCO, ou seja, o que você faz dentro do Internet Banking do Inter. Tudo que acontece dentro do ERP tem fonte própria, e é para elas que esta aponta.
ONDE FICA CADA ASSUNTO
A tela de cadastro da integração dentro do ERP, o que cada campo pede, multa e mora, a situação Ativo ou Pendente, plano, permissão de usuário e as mensagens de credencial inválida e de escopos faltando: fonte da configuração dentro do ERP, nesta mesma pasta.
O certificado do lado do ERP — o .zip, o que faz o envio ser recusado, trocar o certificado e a validade que o sistema mostra: fonte do certificado digital, nesta mesma pasta.
Emitir o boleto, os dados do cliente que o sistema exige, vencimento recusado, registro automático, sincronizar e baixar boleto no banco: fonte da emissão do boleto, nesta mesma pasta.
O que sai impresso no boleto, as linhas de mensagem, multa e mora no papel e o que ainda dá para mudar depois de emitido: fonte do que sai impresso no boleto, nesta mesma pasta.
Mais de uma conta do Inter na mesma empresa, qual conta sai em cada cobrança e por que uma tela mostra a conta que a outra não mostra: fonte de mais de uma conta, nesta mesma pasta.
O que cada situação do boleto significa depois de gerado e o período que a listagem traz por padrão: subpasta Boletos.
Cobrança Pix no dia a dia, origem da cobrança, Pix no PDV, envio ao cliente, validade do QR Code e comprovante: fonte da cobrança Pix, nesta mesma pasta.
A chave Pix, o erro de chave incompatível e os três status da cobrança Pix: subpasta Pix.
Por que o recebimento baixa sozinho e por que às vezes não baixa: fonte da baixa automática, nesta mesma pasta.
Pagar boleto de fornecedor e DARF, a fila de aprovação e os status do pagamento: fonte de pagamentos, nesta mesma pasta.
Extrato e saldo: subpasta Extrato e pagamentos.
Forma de pagamento, conta bancária, cadastro de cliente, recebimento e movimentação financeira são conceitos do ERP e se respondem pelas fontes do ERP. O roteiro comum de qualquer integração de cobrança e o funcionamento geral do Pix estão nas fontes compartilhadas da pasta Meios de pagamento. Nada disso é reexplicado aqui.
A ORDEM PARA LIGAR
1. Ter conta PJ no Banco Inter. Conta de pessoa física não serve.
2. Ter no financeiro do ERP a forma de pagamento que vai ser usada para o boleto. Ela é escolhida dentro do cadastro da integração, então precisa existir antes. Sem forma de pagamento vinculada a integração nem aparece na lista do ERP. É o passo que quase todo mundo pula e a causa mais comum de "integrei e não funcionou". O roteiro está na pasta Meios de pagamento.
3. No Internet Banking do Inter, criar a integração e aguardar a validação do banco.
4. Baixar a chave e o certificado dessa integração.
5. No ERP, cadastrar a integração informando as credenciais e o arquivo do certificado.
6. Quem for usar cobrança Pix informa também a chave Pix e uma segunda forma de pagamento, separada da do boleto.
CRIAR A INTEGRAÇÃO NO INTER, COMO É HOJE
O caminho atual no Internet Banking é o menu INTEGRAR e a opção NOVA INTEGRAÇÃO. Material antigo fala em Conta Digital e Aplicações; o nome mudou. Os nomes de menu do Inter podem mudar de novo: descreva o caminho e oriente pela tela do banco, sem insistir em um rótulo exato.
Na criação você define o nome e a descrição, para conseguir identificar depois; as contas correntes em que a integração pode operar; e as permissões, conforme o que você vai usar, como cobrança, Pix, extrato e pagamento. Na primeira vez o Inter pede que você leia e aceite os termos de cada uma. Escolher menos permissões do que o ERP precisa é o que produz depois a mensagem de escopos faltando, que está detalhada na fonte da configuração dentro do ERP.
Depois de criar, o Inter abre um formulário sobre os seus clientes, a sua empresa e o seu negócio. Enviado o formulário, o pedido entra em análise e a integração fica com status EM VALIDAÇÃO. Dois pontos geram chamado nessa fase: durante a análise não dá para criar outra integração, e a espera é do banco. O ERP não acelera, não consulta e não interfere nessa análise.
O acompanhamento fica em Integrar e Minhas Integrações, e o Inter avisa por e-mail quando termina. Aprovada, a integração aparece lá e, no menu de ações dela, existe a opção de baixar chave e certificado. É nesse momento que o Inter mostra o Client ID e o Client Secret, e ele mostra uma vez só. Guarde em lugar seguro. Depois de alguns minutos o status vira ATIVO, e só aí a integração funciona.
Client ID, Client Secret, chave e certificado não se pedem nem se repetem no atendimento. Se o cliente perdeu o Client Secret, ele não é recuperável e o suporte não tem como resgatá-lo: o caminho é gerar outro no portal do Inter.
DUAS SITUAÇÕES DIFERENTES COM NOMES PARECIDOS
A situação que aparece no portal do Inter, como Em validação, Ativo ou Cancelada, é a situação da integração no banco.
A situação que aparece na lista de integrações do ERP tem só dois valores, Ativo e Pendente, e diz apenas se o certificado já foi gravado. Uma coisa não prova a outra. O que cada valor significa do lado do ERP está na fonte da configuração dentro do ERP.
O CERTIFICADO VENCE EM UM ANO, E ESSE É O ERRO MAIS COMUM
O certificado do Inter vale um ano. Quando expira, tudo para de uma vez: boleto não emite, extrato não carrega, consulta falha. Não houve mudança no sistema, o prazo acabou. Por isso, diante de "parou tudo do nada", a primeira pergunta é a validade do certificado.
Sobre a renovação: a opção RENOVAR aparece no Inter quando a integração está expirada ou quando faltam 90 dias ou menos para vencer; renovando, o Client ID e o Client Secret continuam os mesmos e muda só o certificado, que você baixa na hora e substitui no ERP; integração cancelada não pode ser renovada, e aí é preciso criar outra do zero e passar de novo pela análise.
Vale renovar antes de vencer, porque a renovação é troca de arquivo e criar do zero é esperar análise. Gerar e renovar o certificado é sempre no portal do Inter: dentro do ERP não existe botão de gerar nem de renovar certificado.
Tudo o que é do lado do ERP nesse assunto — como o .zip entra, o que faz o envio ser recusado, como trocar o arquivo e onde o sistema mostra a validade — está na fonte do certificado digital, nesta mesma pasta. Esta aqui só cuida do lado do banco.
O INTER NÃO USA ARQUIVO
O Inter é integração por API. Ele não usa CNAB, nem 240, nem 400, nem 250; não tem arquivo de remessa nem de retorno, e não pede carteira nem convênio. Se a pergunta menciona qualquer uma dessas coisas, o assunto é boleto do financeiro com outro banco, e não o Inter. Separe os dois antes de responder.
MAIS DE UMA CONTA
A empresa pode ter mais de uma conta Inter integrada, e a integração é gravada por loja. Cada conta é uma integração separada e precisa da sua própria forma de pagamento. O usuário precisa estar na loja certa para ver a integração daquela conta. Como o sistema decide em qual conta sai cada cobrança, e por que uma tela lista a conta que a outra não lista, está na fonte de mais de uma conta, nesta mesma pasta.
O QUE COSTUMA DAR ERRADO
Parou tudo de uma vez: certificado vencido, até prova em contrário.
Integrei e não funciona: quase sempre falta a forma de pagamento apontando para a integração, ou ela foi trocada depois.
A validação demora: é análise do banco, não é falha do sistema, e não há prazo a prometer.
Perdi o Client Secret: não é recuperável, gere outro no Inter.
Tarifa por boleto, limite e prazo de liquidação são do banco. Confirme com o Inter. O ERP não define, não cobra e não consulta isso, e o suporte não fala de condição comercial do banco.