Banco Inter: emitir o boleto e por que o sistema recusa

Esta fonte responde "não consigo gerar o boleto" na integração com o Banco Inter. O que cada situação do boleto significa depois de gerado, e o período que a listagem traz, estão em outra fonte da pasta do Banco Inter. Aqui o assunto é só a emissão e a recusa.

COMO O SISTEMA DECIDE QUE O BOLETO É DO INTER
O caminho normal é pelo recebimento no financeiro do ERP: você abre o recebimento em contas a receber e manda imprimir o boleto. Quem decide para onde aquele boleto vai é a forma de pagamento do recebimento.

Se a forma de pagamento não estiver ligada a nenhuma integração bancária, o ERP imprime o boleto interno dele, com o aviso de que o boleto ainda não foi registrado e que é preciso enviar o arquivo de remessa ao banco. Isso não é erro da integração: é sinal de que o recebimento foi criado com a forma de pagamento errada.

Se a forma for do Banco Inter, o pedido vai para a integração. A mensagem "Forma de pagamento não vinculada ao Banco Inter" aparece num caso específico: a forma está marcada como do Inter, mas não é a forma de recebimento configurada na integração. Acontece quando a integração foi refeita ou a forma foi trocada lá dentro.

Recebimento, forma de pagamento, conta bancária e cadastro de cliente são conceitos do ERP, não da integração. Como cadastrar cada um está nas fontes do ERP e no roteiro comum da pasta Meios de pagamento. Esta fonte não reexplica isso.

Vale saber: dentro do aplicativo do Inter, as telas de clientes e de recebimentos são as telas do próprio ERP, não telas separadas do aplicativo. O que você cadastra ali vale no ERP inteiro.

Existe também uma emissão avulsa dentro do aplicativo do Banco Inter, que cria o recebimento no financeiro por você (já com a forma de pagamento da integração) e só depois pede o boleto ao banco; se o banco recusar, esse recebimento recém-criado é apagado, então não fica lançamento sobrando. Ela tem regras próprias, listadas mais abaixo. Não afirme ao cliente onde fica esse botão nem como é a tela: confirme com ele o que aparece na conta dele. Se ele não encontrar, o caminho seguro é criar o recebimento no financeiro e mandar imprimir o boleto.

O CADASTRO DO CLIENTE É A CAUSA NÚMERO UM DE RECUSA
No caminho do recebimento, antes de falar com o banco o sistema confere o cadastro do cliente. A lista é fechada, são estes nove dados: nome, CPF/CNPJ, e-mail, logradouro, número, bairro, cidade, CEP e estado.

Faltando qualquer um deles a emissão para, e a mensagem diz exatamente qual: "O cliente não possui CPF/CNPJ", "O cliente não possui E-mail", "O cliente não possui Endereço", "O cliente não possui Número de Endereço", "O cliente não possui Bairro no Endereço", "O cliente não possui Cidade no Endereço", "O cliente não possui CEP no Endereço", "O cliente não possui Estado no Endereço". Se o recebimento não tiver cliente nenhum vinculado, a resposta é "Não existe um cliente ou uma pessoa vinculada a este recebimento".

O telefone não é obrigatório. Mas se estiver preenchido, os dois primeiros dígitos (o DDD) não podem ter zero, senão vem "O telefone do cliente não é válido para o padrão BancoInter, o correto é (xx)xxxx-xxxx". O sistema usa o telefone do cadastro do cliente e, se ele estiver vazio, usa o celular.

Esses dados saem do cadastro do cliente e do endereço dele. Corrija o cliente e mande emitir de novo: não é preciso refazer o recebimento.

Na emissão avulsa pelo aplicativo do Inter essa conferência não acontece antes: quem recusa por dado faltando é o próprio banco, e a mensagem vem do banco.

DATA E VALOR MUDAM CONFORME O CAMINHO
Pelo recebimento no financeiro, o que manda é o vencimento. Vencimento anterior a hoje é recusado com "A data de vencimento é menor do que o dia de hoje" — boleto vencido não se registra no banco. Vencimento a mais de 400 dias corridos de hoje também é recusado, com "A data de vencimento é maior que do 400 dias corridos". Nesse caminho não existe validação de valor mínimo no sistema.

Na emissão avulsa dentro do aplicativo do Inter as regras são outras e valem só ali: o valor precisa ser de 2,50 para cima, a data de vencimento precisa ser uma data válida e a mensagem tem no máximo 78 caracteres.

Não misture as duas listas. Os 400 dias são do caminho do financeiro. O valor mínimo e os 78 caracteres são da emissão avulsa.

O QUE ACONTECE QUANDO O BOLETO SAI
O boleto é registrado no banco na hora. Não existe arquivo de remessa nessa integração. Assim que o banco devolve o nosso número, o sistema grava esse número no recebimento.

Se o banco demorar demais para devolver o nosso número, a tela mostra erro mesmo com o boleto já criado lá. Mande imprimir de novo: o sistema procura o boleto pelo número do recebimento e reaproveita, em vez de criar outro.

O PDF vem do próprio Banco Inter. O desenho, o código de barras e a linha digitável são do banco, não do ERP.

Na tela do boleto o sistema mostra a data limite de pagamento como o vencimento mais 59 dias.

Se você mandar imprimir e o banco responder que não encontrou aquele boleto, o sistema apaga o vínculo antigo e tenta registrar de novo sozinho, na mesma hora.

O REGISTRO AUTOMÁTICO E POR QUE ELE NÃO PEGA TUDO
Existe uma rotina que registra boletos sozinha, mas ela é bem restrita. Ela só olha para o recebimento que atenda a tudo isto ao mesmo tempo: usa uma forma de pagamento do Banco Inter, ainda não está baixado, ainda não foi registrado, tem vencimento de hoje em diante, foi criado nos últimos 38 minutos e já teve o boleto enviado por e-mail.

Esses dois últimos itens são o que pega quase todo mundo. Recebimento criado há mais de meia hora já não entra, e sem o envio do boleto por e-mail a rotina não toca nele.

Por isso recebimento antigo nunca registra sozinho, mesmo com tudo certo no cadastro. Para esses, o caminho é o Sincronizar, ou abrir o recebimento e mandar imprimir o boleto.

PARA QUE SERVE O SINCRONIZAR
O Sincronizar é o que registra em lote o que ficou para trás. Ele exige o período: sem data de início e fim ele responde "É necessário informar o período de sincronização!". O período é comparado com o vencimento dos recebimentos, não com a data em que foram criados.

Ele pega só recebimentos em aberto, que ainda não foram registrados no banco, com forma de pagamento do Inter, e apenas da loja em que você está. Trabalha em blocos de dez recebimentos por execução: com muita coisa atrasada é normal precisar rodar mais de uma vez.

Cada recebimento que falhar volta com a própria mensagem, e o resultado final é a soma dessas mensagens. Erro no Sincronizar é quase sempre cadastro do cliente: releia a lista dos nove dados antes de suspeitar da integração ou das chaves.

CANCELAR OU BAIXAR O BOLETO NO BANCO
Cancelar o boleto no banco é a ação de baixa, feita a partir da listagem de boletos do aplicativo do Inter. O motivo é obrigatório.

Nas integrações novas a lista de motivos é fechada, são estes quatro: Baixa por acertos; Baixado, pago direto ao cliente; Baixado por substituição; Baixado a pedido do cliente. As integrações antigas do Inter, feitas na versão anterior da conexão, mostram uma lista maior de motivos. Se aparecerem mais opções na sua tela, é esse o caso.

Boleto que já está cancelado aceita a baixa outra vez sem erro: o sistema vê que já está cancelado e responde que a baixa foi feita.

Reforçando o que a fonte de situações já diz: alterar o valor ou o vencimento do recebimento no ERP não muda o boleto que já está registrado no banco. Para valor ou vencimento novo, baixe o boleto atual e gere outro.

POR QUE NÃO CONSIGO AGRUPAR AS PARCELAS
O ERP bloqueia o agrupamento de recebimento que já tem boleto do Banco Inter. A mensagem é do tipo "O recebimento de número tal possui integração com o Banco Inter, por isso não é possível agrupar".

Quase ninguém liga uma coisa à outra, mas é isso mesmo: o boleto já está registrado no banco e o agrupamento mudaria o lançamento que ele representa. Só é possível agrupar recebimentos que ainda não tenham boleto gerado no Inter.

CLIQUEI DUAS VEZES, VAI GERAR DOIS BOLETOS?
Em geral não. Existe uma trava de quinze segundos por recebimento: o segundo pedido fica esperando esse tempo antes de seguir.

O que realmente evita a duplicidade vem depois: quando o recebimento já está marcado como enviado ao banco, antes de criar qualquer coisa o sistema procura no Inter um boleto com o mesmo número de recebimento e o mesmo vencimento. Achando, ele reaproveita o boleto que já existe e apenas regrava o nosso número. É por isso que reimprimir não gera boleto novo.

O QUE COSTUMA DAR ERRADO
"Erro ao gerar boleto" com o texto do banco junto: leia a frase inteira da tela. O sistema repassa o motivo devolvido pelo banco junto da mensagem "Não foi possível gerar o boleto no Banco Inter".

Tela de erro sem mensagem nenhuma: confira se o recebimento ainda está em aberto e se a forma de pagamento dele é a do Inter. Recebimento já baixado não gera boleto.

"Forma de pagamento não vinculada ao Banco Inter": a forma do recebimento está marcada como do Inter, mas não é a forma configurada na integração. Confira a integração e a forma do recebimento. Se a forma que você quer não aparece disponível para vincular, ela já está ligada a outra integração, e o caminho é criar outra forma — isso está no roteiro comum de meios de pagamento.

Boleto interno do ERP com aviso de arquivo de remessa: o recebimento não está com forma de pagamento do Inter. Troque a forma no recebimento.

"O cliente não possui...": cadastro do cliente incompleto. Complete o dado citado e emita de novo.

"A data de vencimento é menor do que o dia de hoje": não existe emissão de boleto vencido. Atualize o vencimento do recebimento antes.

Boleto não registrou sozinho: quase sempre o recebimento é antigo ou nunca teve boleto enviado por e-mail. Use o Sincronizar informando o período.

Erro de credenciais: as mensagens "Credenciais inválidas. Verifique o Cliente Id e Cliente Secret da integração" e "Faltando escopos necessários. Crie uma nova chave de API no seu Internet Banking com os escopos necessários" vêm do banco, e são de configuração da conexão, não do boleto. Nunca peça, receba ou repita chave, token, certificado ou senha no atendimento. Se o cliente colar alguma no chat, oriente a gerar uma nova no Internet Banking do Inter.