Efí (GerenciaNet): link público da cobrança e a baixa automática que falha em silêncio

Atualizado em 22/10/2026

Efí é o nome atual da GerenciaNet. É a mesma integração: no ERP ela ainda aparece com o nome GerenciaNet. Quando o cliente falar Efí ou GerenciaNet, está falando da mesma coisa.

Esta fonte trata do que acontece DEPOIS que a cobrança é gerada: o que fica gravado no lançamento, o link público que o cliente final abre, o que cada mensagem quer dizer e a baixa automática do pagamento — inclusive o motivo real de ela falhar sem avisar ninguém. O momento de gerar a cobrança (situação de remessa, observação do erro, a espera de 15 segundos) tem fonte própria nesta pasta, e o cadastro da integração e o vínculo da forma de pagamento também. Forma de pagamento, conta bancária, lançamento financeiro e cliente são conceitos do ERP e se respondem pelas fontes do ERP.

ANTES DE QUALQUER COISA, A FORMA DE PAGAMENTO
A integração só funciona se existir uma forma de pagamento apontando para a Efí. É o passo que quase todo mundo pula e a causa mais comum de "integrei e não funcionou". Uma forma que já está vinculada a outra integração não aparece na lista de escolha do cadastro. Esse roteiro está nas fontes da pasta Meios de pagamento, e o detalhe do vínculo está na fonte do cadastro da Efí. Um cadastro da Efí aponta para uma única forma de pagamento e guarda a chave Pix nesse mesmo registro — não existe um segundo cadastro só para o Pix.

O QUE O SISTEMA GUARDA DEPOIS DE GERAR A COBRANÇA
No próprio lançamento ficam quatro informações da Efí: situação, o identificador da cobrança na Efí, linha digitável e link do boleto. É de onde sai o link que você reabre depois.

Além disso, o ERP guarda um registro de transação da Efí com esse mesmo identificador, o link da transação, a quantidade de parcelas e o meio de pagamento. Os meios previstos nesse registro são três, e a lista é fechada: cartão de crédito, boleto e link de pagamento.

O lançamento também guarda a situação da remessa, que é o que o ERP mostra sobre a emissão. Como ela é gravada e o que significa cada valor está na fonte de gerar a cobrança.

O LINK PÚBLICO E O QUE CADA MENSAGEM SIGNIFICA
O link público do Pix e o do boleto são montados a partir do próprio lançamento. São links abertos, sem login, feitos para o cliente final. O sistema valida o lançamento, descobre por qual integração ele deve ser emitido e, sendo Efí, gera a cobrança pela Efí.

As mensagens que aparecem quando não dá certo e o que cada uma quer dizer:

"Este lançamento não está vinculado a uma forma de pagamento válida!" - o lançamento está sem forma de pagamento, ou a forma existe mas não tem nem o Pix nem o cartão habilitados (no link do boleto, nem o boleto nem o cartão).

"O seu plano atual não lhe permite ..." - é limite de recurso do plano contratado.

"Você não tem permissão para acessar esta área!" - falta a permissão de imprimir o Pix (ou de imprimir o boleto) para aquele usuário. Só aparece para usuário do ERP logado na empresa dona. Essa permissão é checada de verdade e barra mesmo, mas ela não aparece como caixinha na tela de permissões: não mande o cliente procurar por ela, escale.

"Este lançamento já foi pago!" - o lançamento já está baixado. Cobrança de lançamento baixado não é gerada de novo.

"Forma de pagamento "X" não vinculada a integração!" - a forma de pagamento existe, mas está sem banco/integração definido.

Detalhe que explica muito chamado: as três primeiras dessas mensagens só aparecem inteiras para quem está logado na empresa dona do lançamento. Para qualquer outra pessoa - o cliente final, por exemplo - elas viram uma única mensagem genérica, "Este lançamento não está disponível!", que é também o que aparece quando o lançamento nem é encontrado. Por isso o cliente final relata uma coisa e o usuário do ERP vê outra, para o mesmo problema. Peça sempre para o usuário do ERP abrir o mesmo link logado: é assim que você descobre a causa.

Já "Este lançamento já foi pago!" e "Forma de pagamento "X" não vinculada a integração!" aparecem do mesmo jeito para todo mundo, logado ou não. Se o cliente final mandar um print com uma dessas duas, você já tem a causa sem precisar repetir o teste.

Ao abrir o BOLETO por link público, quando quem abre não é a empresa dona do lançamento, o sistema marca o boleto como visualizado (só na primeira vez) e, se o boleto tiver sido enviado por e-mail por algum usuário, cria para esse usuário a notificação "<nome do sacado> visualizou o boleto de número #<código>". É assim que o cliente sabe que o boleto foi aberto. Esse aviso é do fluxo do boleto; o fluxo do Pix não passa por ele. Como o registro só acontece quando quem abre não é da empresa dona, o próprio usuário do ERP abrindo o link não marca nada.

A BAIXA AUTOMÁTICA: COMO O PAGAMENTO VOLTA PARA O ERP
A Efí avisa o ERP por um aviso automático de pagamento, que identifica o lançamento. Sem esse aviso da Efí, o ERP não faz absolutamente nada.

O que o sistema faz, na ordem: localiza o lançamento pelo identificador que veio no aviso (em um dos formatos possíveis, só aceita lançamento ainda não baixado); lê o Client ID e o Client Secret gravados na FORMA DE PAGAMENTO daquele lançamento; consulta a Efí com essas credenciais e o dado recebido; e só se a Efí responder que a cobrança está paga é que ele dá a baixa.

Quando dá a baixa, ele grava sempre assim: lançamento baixado, baixado por "GerenciaNet", valor pago igual ao VALOR TOTAL do lançamento, data de baixa e data de fluxo com a data de hoje. E cria a notificação "O boleto de nº <código> foi confirmado pelo GerenciaNet", apenas para o usuário dono do lançamento - o texto fala em boleto mesmo quando a cobrança era Pix ou cartão.

Duas consequências que resolvem chamado. Primeira: a baixa vem sempre pelo valor total do lançamento, nunca por um valor parcial; se o cliente pagou valor diferente, a baixa automática ainda assim grava o total. Segunda: o campo "baixado por" mostrando GerenciaNet é a assinatura da baixa automática; se está lá, foi a integração que baixou, não uma pessoa.

O QUE COSTUMA DAR ERRADO, E A CAUSA REAL
O pagamento foi feito na Efí e o lançamento continua em aberto no ERP. Essa é a queixa clássica, e vem descrita como "parou do nada", porque nada muda na tela e nenhum aviso aparece. A causa real é que essa rotina de aviso não trata os erros: qualquer falha ao consultar a Efí - credencial errada, credencial trocada no portal, certificado, indisponibilidade de comunicação - é engolida em silêncio. Não gera mensagem, não gera log, não gera notificação. Do lado do cliente parece que a integração parou sozinha.

O que fazer nesse caso: confira no portal da Efí se aquela cobrança consta como paga. Constando paga, dê a baixa manual no lançamento, para o financeiro não ficar torto. Em paralelo, mande revisar as credenciais no portal da Efí, porque credencial regenerada ou revogada lá derruba a baixa automática sem nenhum sinal aqui. Nunca peça e nunca repita Client ID, Client Secret, certificado, token ou senha na conversa; se o cliente colar alguma dessas informações no chat, oriente a gerar outra no portal da Efí, porque a que ele colou deve ser considerada exposta.

Outro ponto: as credenciais que a baixa automática usa são as gravadas na forma de pagamento do lançamento, e não as do cadastro da integração. Se a forma de pagamento estiver com esses campos vazios ou desatualizados, a consulta falha - e falha calada, pelo mesmo motivo acima.

O QUE ESTA FONTE NÃO RESPONDE
O desdobramento do meio de pagamento no checkout da loja virtual e o uso da Efí no agendamento estão na fonte da Efí fora do financeiro. Prazo de compensação, retentativa da notificação, expiração de QR Code, estorno e mensagens de erro devolvidas pela própria Efí não estão descritos aqui e não devem ser afirmados. Tarifa, taxa e condição comercial são assunto da Efí ou do comercial.