Banco Inter: a configuração dentro do ERP e o que trava o acesso

Esta fonte é o lado do ERP: o que se preenche na tela de integração do Banco Inter dentro do sistema e o que impede o acesso de funcionar. O lado do banco — criar a integração no Internet Banking do Inter, validar e gerar ou renovar o certificado — está na fonte do lado do banco, nesta mesma pasta. Aqui não repetimos aquilo, apontamos.

ONDE FICA
O Banco Inter tem um aplicativo próprio dentro do sistema. A tela inicial dele oferece três caminhos: Boletos, Extrato e Integrações. É em Integrações que a conta do Inter é cadastrada. O Banco Inter também aparece como um dos cartões da tela de Meios de pagamento do financeiro, que leva para o mesmo aplicativo e marca o banco como ativo quando existe forma de pagamento vinculada a ele.

O QUE O ERP PEDE NO CADASTRO
Nº da conta, com dígito, de 7 a 10 dígitos.
CNPJ da empresa titular da conta.
Cliente Id.
Cliente Secret.
Forma de recebimento: a forma de pagamento do financeiro que vai ser usada para emitir os boletos.
Arquivo do certificado, enviado em .zip.
O Cliente Id e o Cliente Secret são gerados no portal do Inter, dentro da integração criada lá. O ERP não gera, não recupera e não conserta esses dados. Nunca peça nem repita esses valores na conversa; se o cliente colar um deles, oriente a gerar outro no portal do Inter.

O ARQUIVO DO CERTIFICADO
O que se envia é o arquivo .zip que o Inter disponibiliza, não o .crt solto. O sistema lê o par de dentro do zip e grava as duas metades na integração. O nome dos arquivos não decide nada: quem confere se aquilo é mesmo certificado e chave é o OpenSSL. Zip recusado não grava nada — a integração não chega a ser criada nem alterada, e a mensagem diz o motivo.
As recusas do envio, a troca do certificado, a validade e onde as chaves ficam guardadas são de outra fonte desta pasta, a do certificado digital. Aqui fica só o que o cadastro pede.
Não existe hoje, dentro do ERP, tela de gerar chave CSR, botão de gerar certificado nem botão de renovar certificado. Como gerar e como renovar o certificado é assunto do lado do banco: veja a fonte que trata da criação e validação da integração no Inter. Não prometa ao cliente um botão de CSR.

AS DUAS FORMAS DE PAGAMENTO: BOLETO E PIX
A integração guarda duas formas de pagamento separadas: a do boleto e a do Pix. Ao salvar, o ERP marca a forma escolhida para boleto como forma de boleto do Banco Inter, e a forma escolhida para Pix como forma de Pix do Banco Inter. Como a marcação é exclusiva, a mesma forma não serve para boleto e Pix ao mesmo tempo. Se você trocar a forma, a anterior é desvinculada e volta a ficar sem banco. Por isso uma forma de pagamento serve a uma integração só.
A lista oferece apenas formas de recebimento (crédito) que estejam livres ou que já pertençam ao Banco Inter, e descarta as que já estão em outra integração do Inter. Se a forma que você quer não aparece, o roteiro comum está nas fontes compartilhadas de Meios de pagamento — e é lá também que fica o funcionamento geral do Pix. Cadastrar a forma de pagamento antes é o passo que quase todo mundo pula.

MULTA, MORA E DIAS DE JUROS
Multa é uma lista fechada, com três opções: Sem multa, Valor fixo e Percentual. Escolhendo Sem multa, a taxa é apagada ao salvar.
Mora é uma lista fechada, com três opções: Valor ao dia, Taxa mensal e Não há mora. Escolhendo Não há mora, a taxa é apagada ao salvar.
Dias juros é o número de dias após a data de vencimento para iniciar a cobrança de juros — o próprio campo avisa que será D+1. Se houver mora informada e os dias de juros estiverem zerados, o sistema recusa com a mensagem: Dias para juros deve ser maior que zero! Isso vale tanto no cadastro quanto na edição.

MENSAGENS DE INSTRUÇÃO
A integração guarda até três linhas de instrução livres e mais uma linha final, escolhida em lista fechada de dois textos, ambos citando o nome e o link do sistema. Todas saem impressas no boleto. Quantas linhas cabem, em que ordem saem e o que acontece quando passa do limite é assunto da fonte que trata do que sai impresso no boleto.

A LISTA DE INTEGRAÇÕES E A SITUAÇÃO
A lista mostra Conta, CNPJ, Saldo e Situação. O saldo é buscado no banco na hora em que a lista carrega, então erro de credencial pode aparecer já aí. A busca da lista procura pelo nome da forma de pagamento vinculada, não pelo número da conta nem pelo CNPJ.
Situação tem só dois valores: Ativo e Pendente. Pendente quer dizer uma coisa só: o certificado ainda não foi gravado. Não é bloqueio de plano, não é permissão e não é erro de credencial.
Ativo também não garante que está tudo certo: significa apenas que existe certificado gravado. O sistema calcula à parte a data de validade do certificado e marca quando ele está vencido, mas credencial errada só aparece na hora de usar, como erro do banco.

AO EDITAR, CONTA E CNPJ FICAM BLOQUEADOS
Na edição, o Nº da conta e o CNPJ vêm bloqueados de propósito. Cliente Id e Cliente Secret continuam editáveis nas integrações do formato atual — as cadastradas hoje são todas desse formato; em integrações antigas esses dois campos nem aparecem. A forma de recebimento, a multa, a mora, os dias de juros e as mensagens seguem editáveis.
Quem errou o número da conta não resolve editando: o caminho é cadastrar outra integração com a conta certa. Ao excluir a integração antiga, a forma de pagamento do boleto dela é desvinculada e volta a ficar disponível (a forma do Pix não é liberada pela exclusão; se precisar reaproveitá-la, troque-a antes de excluir).

A INTEGRAÇÃO É POR LOJA
A integração é gravada com a empresa e com a loja em que o usuário estava quando cadastrou, e as telas do Banco Inter buscam a integração da loja logada. Quem tem mais de uma loja ou mais de uma conta precisa estar na loja certa para ver a integração daquela conta.
Com mais de uma loja cadastrada, a lista de formas de pagamento também respeita a loja: só entram as formas que tenham conta bancária e cuja conta bancária pertença à loja em que você está.
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: tem fonte própria nesta pasta. Aqui não repetimos aquilo.

PLANO E PERMISSÃO
O Banco Inter é um recurso de plano, checado por empresa e loja. Sem ele, a mensagem é: O seu plano atual não lhe permite integrar com a Banco Inter. Por favor, contrate outro plano!
Além do plano, cada ação tem permissão própria no grupo de usuários: emitir boleto, sincronizar boletos, ver saldo e editar a integração são permissões diferentes. Quem não enxerga um botão pode simplesmente estar sem aquela permissão, e não diante de um defeito. Vale checar o grupo de usuários antes de abrir chamado.

MENSAGENS DO BANCO QUE O ERP TRADUZ
Os erros vindos do Inter chegam com o prefixo Banco Inter: e duas delas o sistema traduz.
Credenciais inválidas. Verifique o Cliente Id e Cliente Secret da integração! O banco respondeu que o token é inválido. Causa real: Cliente Id ou Cliente Secret errados, trocados ou de outra integração.
Faltando escopos necessários. Crie uma nova chave de API no seu Internet Banking com os escopos necessários! Causa real: a integração criada no portal do Inter não tem todas as permissões que o ERP usa. O ERP pede escopos de cobrança de boleto (leitura e escrita), extrato, pagamento de boleto (leitura e escrita), pagamento de DARF, Pix e cobrança imediata, e webhook. O caminho é ajustar ou gerar de novo a chave no portal do Inter, com todos os escopos, e atualizar Cliente Id e Cliente Secret na integração.
Qualquer outra mensagem é repassada como o banco mandou. Quando o banco não devolve mensagem nenhuma, aparece: Banco Inter: Ocorreu um erro. Entre em contato com o suporte!

AS TELAS DE DENTRO DO APP QUE SÃO DO PRÓPRIO ERP
Isso confunde no atendimento: várias telas acessíveis dentro do aplicativo do Banco Inter não são do Banco Inter. Clientes, Usuários, Grupos de usuários, Permissões, Lojas, Planos, Notificações, Logs de usuário, Ajuda e Movimentações financeiras são as telas do próprio ERP, apenas exibidas ali dentro. As buscas de formas de pagamento, contas bancárias, centros de custo e categorias usadas nos formulários também são as do ERP.
Ou seja: cliente, forma de pagamento, conta bancária, categoria e movimentação financeira se respondem pelas fontes do ERP, e não por esta. Aqui só o que é do Banco Inter.

O QUE COSTUMA DAR ERRADO
A integração sumiu da lista, ou aparece Integração não encontrada. Verifique se existe forma de pagamento vinculada! Esta é a campeã de chamado. A consulta da integração exige o vínculo com a forma de pagamento do boleto. Se essa forma foi apagada, ou se ela foi trocada para outro banco, a integração deixa de ser encontrada e as telas do Inter param. Com mais de uma loja cadastrada há um segundo motivo: a forma de pagamento vinculada precisa ter conta bancária, e essa conta precisa pertencer à loja logada. O certificado, as credenciais e a conta continuam lá. O caminho é acertar a forma de pagamento vinculada.
Quando não há na loja nenhuma integração com forma vinculada, as telas do Banco Inter respondem Nenhuma integração BancoInter vinculada! e devolvem o usuário para a tela inicial. Essa mensagem, a parecida sobre a conta digital e o motivo de uma tela listar a conta que a outra não lista estão na fonte de mais de uma conta.
Cadastrei e continua Pendente. A integração foi criada sem nenhum arquivo anexado — zip recusado nem chega a salvar. Edite a integração e envie o .zip do Inter.
Integrei e não funciona, dá erro de credencial. Cliente Id e Cliente Secret são de outra integração ou foram copiados com espaço sobrando. Gere de novo no portal do Inter e regrave.
Parou do nada. Duas causas comuns: certificado vencido (renovação é do lado do banco) ou credencial revogada no portal do Inter.
Ocorreu algum erro ao salvar! Além de erro de preenchimento, essa mensagem genérica aparece quando, ao gravar com forma de recebimento escolhida, o sistema não encontra nenhuma forma de pagamento sem banco na empresa. Crie ou libere uma forma de pagamento e tente de novo.
Não vejo a integração, mas o colega vê. Confira a loja selecionada. A integração é da loja.
Não aparece o botão de emitir boleto, sincronizar ou ver saldo. Verifique a permissão do grupo de usuários antes de tratar como defeito.
Nem entro no Banco Inter. Comece pelo plano: o recurso precisa estar liberado para a empresa e a loja.