Gerar a cobrança pela Efí: o que o ERP grava, onde o erro fica registrado e a espera de 15 segundos

Efí é o nome novo da GerenciaNet; o ERP ainda escreve GerenciaNet nas mensagens e nos campos.

Aqui tratamos do MOMENTO de gerar a cobrança: o que sai do ERP para a Efí, o que fica gravado no lançamento, onde o erro fica registrado e a espera de 15 segundos. O que acontece depois — o link público que o cliente final abre, o significado de cada mensagem e o passo a passo da baixa automática — está no conteúdo sobre o link público e a baixa automática. O cadastro da integração e o vínculo com a forma de pagamento estão no conteúdo do cadastro.

DO CLIQUE ATÉ A EFÍ
Boleto só vai para a Efí se o banco da forma de pagamento do lançamento for uma integração; se não for, sai o PDF de boleto comum do ERP. Pix sempre tenta a integração: se o banco da forma não for uma integração — inclusive quando está em branco — a resposta é Forma de pagamento "nome" não vinculada a integração!

O QUE FICA GRAVADO NO LANÇAMENTO
Deu certo: a situação de remessa passa a Enviado, com a data do dia. Deu erro: passa a Cancelado, com a data do dia. Se o lançamento já estava naquela mesma situação, a data não é reescrita. Por isso um lançamento com remessa Cancelado pode ser apenas uma emissão que a Efí recusou, e não um cancelamento feito por alguém.

A mensagem de erro devolvida vira a observação do evento de geração da cobrança daquele lançamento. É ali que está o motivo, não na credencial. Só a última fica: cada tentativa sobrescreve a anterior do mesmo evento. Se a resposta vier sem mensagem, não fica observação nenhuma.

A ESPERA DE 15 SEGUNDOS (SÓ BOLETO)
Cada emissão de boleto por integração deixa uma marca de horário. Mandar emitir de novo o mesmo boleto em menos de 15 segundos faz o ERP aguardar 15 segundos antes de seguir. Parece travado, não está. A marca só é apagada quando a emissão dá certo: depois de um erro ela continua lá, e a tentativa seguinte também espera. O Pix não passa por essa espera.

AS RECUSAS ANTES DE CHEGAR NA EFÍ
São quatro, e valem tanto para a emissão dentro do ERP quanto para o link público: lançamento sem forma de pagamento válida; plano sem o recurso; falta de permissão de imprimir; lançamento já baixado. O texto exato de cada uma, o que muda para quem abre o link sem estar logado na empresa dona e a ordem de conferência estão no conteúdo sobre o link público.

REMESSA
Salvar uma forma de pagamento com o marcador boleto ligado e com banco GerenciaNet zera o campo de cobrança registrada. Duas consequências: essa forma não entra na lista de formas da tela de exportação de remessa, e o aviso de boleto não registrado não aparece por esse caminho, porque ele só existe na emissão do PDF de boleto comum. A Efí não usa arquivo de remessa nem de retorno (CNAB): a comunicação é por chamada direta.

A BAIXA, EM RESUMO
A baixa automática usa as credenciais gravadas na FORMA DE PAGAMENTO do lançamento, não as do cadastro da integração, e só acontece quando a Efí responde que a cobrança está paga. Quando acontece, grava lançamento baixado, baixado por GerenciaNet, valor pago igual ao VALOR TOTAL, data de baixa e data de fluxo do dia, 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. O resto do fluxo está no conteúdo sobre o link público e a baixa automática.

O QUE COSTUMA DAR ERRADO
Deu erro e ninguém sabe por quê: o motivo está na observação do evento de geração da cobrança do lançamento, e só a da última tentativa.

A emissão parece travada: é a espera de 15 segundos do boleto, e ela se repete enquanto a emissão continuar dando erro.

Situação de remessa Cancelado sem ninguém ter cancelado: foi uma emissão recusada.

Pagou e não baixou: as credenciais que a baixa usa são as da forma de pagamento do lançamento. Certas no cadastro da integração e vazias ou velhas na forma derrubam a baixa, e essa falha não gera mensagem nem log.