Erros ao gerar cobrança – Soluções

Essa é uma parte que gostaríamos que não existisse no nosso Ajuda. Mas infelizmente isso é impossível!

Com uma variedade tão grande de bancos, integrações e formas de pagamento, inevitavelmente, vez ou outra você esbarrará em um erro ao gerar um boleto ou um Pix.

A nossa intenção é que isso seja fácil de resolver. Esse material visa ajudar você de forma rápida e fácil a identificar o erro, como é possível resolvê-lo e entender o motivo para acontecer!

Caso você esbarre em um erro aí e ele não esteja aqui, nos avise! Estamos em constante evolução!

Erro: "cobv.devedor.logradouro não respeita o schema"

Esse erro acontece quando o cadastro do cliente está com o endereço incompleto, geralmente faltando o bairro, ao gerar uma cobrança Pix. Complete o cadastro do cliente informando o CEP, que preenche automaticamente o endereço (incluindo o bairro), e gere a cobrança novamente.

Erro: "Erro ao gerar cobrança - Data venc. menor que emissão"

Significa que a data de vencimento informada é anterior ao dia de hoje. Não é possível gerar boleto ou Pix com data retroativa. Ajuste a data de vencimento para hoje ou uma data futura e tente gerar novamente.

Erro: "Net::ReadTimeout with #TCPSocket:(closed)"

Esse erro indica uma instabilidade temporária na conexão com o servidor do banco. Aguarde alguns minutos e tente emitir o boleto novamente. Se o erro persistir, entre em contato com o suporte.

Erro: "As vendas [...] possuem cobranças rejeitadas" ao gerar boletos em lote

Esse erro acontece ao selecionar várias vendas de uma vez para gerar ou imprimir o PDF dos boletos, quando uma das cobranças selecionadas foi rejeitada pelo banco emissor.

Para confirmar o motivo da rejeição, clique na sua foto de usuário → clique em Logs das Integrações → localize o log gerado na data em que a cobrança foi criada e verifique a mensagem de erro retornada pelo banco.

Se a mensagem indicar uma instabilidade temporária na API do banco, aguarde alguns minutos e tente gerar o link novamente.

Não é possível gerar um boleto para cliente sem CPF ou CNPJ no cadastro

Se você tentar gerar o boleto automaticamente dentro da venda, o Fácil123 não salva a venda enquanto o cadastro do cliente não tiver CPF ou CNPJ. Se a venda já estiver salva e você tentar gerar o boleto depois, o sistema solicita o cadastro do CPF ou CNPJ antes de continuar.

Complete o cadastro do cliente com o CPF ou CNPJ e gere o boleto novamente.

Erro: "O campo payer.name permite somente valores alfa numéricos e &"

Esse erro acontece quando o nome cadastrado do cliente tem algum caractere especial que o banco não aceita, como ponto, vírgula ou hífen (só letras, números e "&" são permitidos). Edite o cadastro do cliente removendo o caractere especial do nome e gere a cobrança novamente.

Erro: "Boleto não encontrado" ou "Boleto híbrido não encontrado" na sincronização com o banco

Esse erro aparece nos Logs das Integrações quando o banco avisa o pagamento de um boleto que não existe no Fácil123. Ele também pode chegar como um e-mail de alerta de erro na sincronização das cobranças. Não há venda, parcela ou cobrança com aquele nosso número, por isso a baixa automática não acontece: não há o que baixar aqui. O nome do erro muda conforme o banco. No Itaú, por exemplo, o erro aparece como "Boleto híbrido não encontrado". No Banco do Brasil e no Sicredi, como "Boleto não encontrado".

Isso acontece quando o boleto foi cancelado no Fácil123 mas o banco continua tentando conciliá-lo, ou quando o boleto nunca foi gerado pelo Fácil123, por exemplo emitido diretamente pelo aplicativo ou internet banking do banco usando o mesmo convênio/carteira da conta. Para saber qual foi o caso, confira se o boleto está registrado em Financeiro → Cobrança: se não estiver, ele não foi emitido pelo Fácil123. Para evitar o erro, não emita boletos fora do Fácil123 para a mesma conta.

Confira no extrato do banco se o pagamento entrou na conta e dê baixa manualmente no lançamento correspondente que ficou em aberto no Fácil123. O log traz o nosso número, o valor e a data do pagamento, que ajudam a localizar o lançamento.

Erros específicos de cada banco

PJBank

Erro: "SQLSTATE[08004]/[HY000] [1040] Too many connections"

Esse erro também pode aparecer com a variação "SQLSTATE[HY000] [1040] Too many connections". Fique atento às palavras-chave: SQLSTATE / Too many connections.

Indica uma instabilidade na comunicação entre o Fácil123 e o PJBank. Aguarde um período de tempo e tente novamente. Caso o erro persista até o final do período, solicite análise do time de atendimento.

Erro: "PJBank retornou recurso não encontrado. Por favor, tente mais tarde."

Esse erro é do próprio PJBank, uma instabilidade temporária na comunicação com o banco ao gerar o boleto. Aguarde alguns minutos e tente gerar a cobrança novamente. Se o erro persistir, entre em contato com o suporte para verificarmos o caso.

Boleto não registrado ao alterar a data de vencimento

Esse erro acontece quando a data de vencimento de um boleto é alterada diretamente, sem que o boleto anterior tenha sido cancelado primeiro. Ao fazer isso, o sistema apenas sobrepõe a informação de data sobre um registro que o banco ainda reconhece como o antigo, gerando um conflito que impede o pagamento.

Para confirmar se foi isso que aconteceu, acesse Financeiro → Cobrança e verifique o histórico do boleto. Se houver apenas um boleto gerado, sem nenhum cancelamento anterior, o erro foi esse.

Como corrigir

1. No menu superior clique em Financeiro → clique em Lançamentos.
2. Localize a transação com erro → clique no ícone de boleto → clique nos três pontinhos.
3. Clique em cancelar → clique em Sim, faça isso!
4. Clique nos três pontos → clique em Editar.
5. Ajuste a data de vencimento para a data de hoje ou uma data futura → clique em Salvar.
6. Clique no ícone do boleto → selecione o banco para gerar uma nova cobrança (quando o ícone ficar verde, o boleto foi gerado e registrado com sucesso).
7. Clique no ícone do boleto novamente → clique nos três pontinhos → envie o novo boleto para o seu cliente.

Importante: não é possível registrar um boleto com data retroativa. A nova data de vencimento precisa ser a data de hoje ou uma data futura.

Boleto pago em duplicado

Quando um boleto PJBank é pago em duplicado, o banco identifica a duplicidade automaticamente e realiza o estorno do segundo pagamento. No extrato, o campo Crédito ficará em branco para essa cobrança (isso indica que o valor foi recebido mas não creditado por conta do estorno automático).

Como identificar o cliente que pagou em duplicado

1. Clique na sua foto de usuário → clique em Logs das Integrações.
2. Localize o log com erro gerado na data do pagamento duplicado. Ele terá uma mensagem indicando duplicidade.
3. Abra o log → use Ctrl+F para localizar o Nosso Número do boleto e confirmar que se trata do boleto correto.
4. Anote o ID do registro exibido no log de erro.
5. No menu superior, clique em Financeiro → clique em Cobrança.
6. Selecione o mês correspondente → clique em Carregar mais até listar todos os registros.
7. Use Ctrl+F e pesquise pelo ID anotado no passo 4.
8. O registro encontrado identifica o cliente que realizou o pagamento duplicado.

Boleto consta no extrato de repasse mas não baixou no Fácil123

Quando um boleto aparece no extrato de repasse do PJBank mas a baixa automática não ocorreu no Fácil123, uma das causas possíveis é que um usuário realizou a baixa ou alteração da transação manualmente antes de a API processar o pagamento. Nesse caso, o sistema não consegue aplicar a baixa automática porque a transação já foi modificada.

Identificando se a causa foi uma baixa ou alteração manual

1. No menu superior, clique em Financeiro → clique em Lançamentos.
2. Clique em Todas as transações → selecione Recebidos.
3. Clique em Todas as contas → selecione PJBank.
4. Clique no período filtrado → selecione Personalizado → preencha o mesmo período do extrato de repasse do PJBank.
5. Filtre pelo nome do titular do boleto para localizar a transação correspondente.
6. Localize a transação → clique nos três pontinhos → clique em Histórico de alterações.
7. Verifique se há um registro de baixa ou alteração manual anterior à data em que a API processaria o pagamento (o histórico exibe quando a ação foi feita e qual usuário a realizou).

Se houver esse registro, a baixa manual foi a causa da falha na conciliação automática. Nesse caso, ajuste o valor da transação para que o líquido seja o mesmo do valor de repasse do PJBank.

Erro: "Campo agencia_repasse está inválido. Valide as informações preenchidas e tente novamente. OBS: A agência deve conter 4 números + DV (um dígito)."

A agência informada pode estar incorreta ou incompleta. Verifique os dados informados e tente novamente.

Erro: "Para usar o Boleto Fácil você precisa estar credenciado."

Nesse caso, você já deve ter cadastrado sua conta Boleto Fácil (ela aparece como "Credenciada"), mas está faltando marcar a opção "Esta é a conta padrão para emissão de boletos". Faça essa alteração no cadastro da conta.

Banco do Brasil

Erro: "Nosso Número já incluído anteriormente"

Esse erro acontece quando um boleto BB da mesma conta foi emitido diretamente pelo aplicativo ou internet banking do banco, fora do Fácil123, duplicando a numeração. Evite emitir boletos fora do Fácil123 para a mesma conta e, se o erro já aconteceu, entre em contato com o suporte para reconfigurar a sequência de emissão junto ao banco.

Bradesco

Erro: "TÍTULO JÁ CADASTRADO"

Esse erro indica que o banco recusou o boleto porque o número do título já foi usado anteriormente. Isso costuma acontecer quando a conta financeira usada para emitir boletos é trocada, quando há duas contas configuradas para o mesmo banco ou quando boletos são emitidos fora do Fácil123 (como pelo internet banking ou outro sistema). Entre em contato com o suporte para verificarmos a configuração das contas.

Erro: "REGISTRO DE TITULOS ECOMMERCE NAO CONTRATADO"

Esse erro indica que o Registro de Títulos Ecommerce não está habilitado na conta Bradesco do cliente. Esse é um serviço contratado diretamente com o banco, exigido para a emissão de boletos pelo Fácil123. Solicite ao gerente de contas do Bradesco a habilitação do Registro de Títulos Ecommerce. Depois que o banco confirmar a habilitação, clique em Tentar novamente na própria venda para gerar o boleto.

Erro: "O campo (bairroPagador) não deve conter caracteres especiais"

Esse erro acontece quando o bairro cadastrado no endereço do cliente tem algum caractere especial que a API do Bradesco não aceita, como acentos. Edite o cadastro do cliente removendo o acento ou outro caractere especial do nome do bairro e gere a cobrança novamente.

Erro: "SSL_read: tlsv1 alert unknown ca (SSL alert number 48)"

Esse erro indica uma instabilidade temporária na comunicação com o servidor do Bradesco, e pode aparecer ao gerar ou editar boletos. Aguarde alguns minutos e gere o boleto novamente. Se o erro persistir, entre em contato com o suporte.

Sicoob

Erro: "Forbidden"

Este erro é do próprio Sicoob, uma instabilidade na API deles. Muito provavelmente eles já estão cientes e trabalhando para resolver esta questão. Para mais informações entre em contato com o seu gerente de contas do Sicoob.

Erro: "Erro no servidor do Sicoob, tente novamente mais tarde"

Esse erro indica uma instabilidade temporária no servidor do Sicoob. Aguarde alguns instantes e clique em Tentar novamente na própria tela onde o erro apareceu. Se o erro persistir, entre em contato com o suporte.

Erro: "invalid_grant – Provided Authorization Grant is invalid"

Esse erro ocorre ao gerar boleto e indica que a versão da API do Sicoob utilizada pode estar desatualizada. Verifique se está emitindo boletos na versão mais atual da API do Sicoob. Confira esta informação com nosso suporte.

Erro: "Não foi possível cancelar a cobrança, verifique os erros apontados. TRANSFERENCIA: BLOQUEADO PARA BAIXA"

Esse erro é retornado do próprio banco. Não temos como ajudar por aqui. Entre em contato com o seu gerente de contas do Sicoob.

Erro: "Para o contrato selecionado, o beneficiário não está habilitado para realizar Negativação Automática"

Esse erro indica que a funcionalidade de Negativação Automática não está habilitada para o beneficiário no contrato junto ao Sicoob.

Para resolver, entre em contato com o seu gerente de contas do Sicoob e solicite a habilitação da Negativação Automática para o seu contrato.

Santander

Dados do cliente saem incompletos no boleto

O Santander exige que alguns campos no boleto tenham uma quantidade máxima de caracteres. Para evitar que erros aconteçam e seja necessário arrumar os dados manualmente, o Fácil123 resume os dados para que estejam dentro do tamanho permitido.

Erro: "undefined method '[]' for nil" ou status 405 "Method Not Allowed"

Esse erro acontece quando o webhook da conta de boleto Santander não foi registrado, um passo necessário na configuração da conta para que a emissão funcione. Edite a conta de boleto Santander em Financeiro → Contas e clique em Registrar webhook.

Erro: "Seu boleto foi emitido no Santander, mas o banco esta indisponivel para baixar o PDF no momento"

Esse erro indica uma instabilidade temporária no Santander. O boleto já está registrado no banco, mas o serviço do Santander que fornece o PDF do boleto está indisponível. Aguarde alguns minutos e clique em Tentar novamente na própria venda para baixar o PDF.

Sicredi

Erro: "Boleto não localizado. Verifique os dados informados ou entre em contato com o Beneficiário." (status "Não registrada")

Esse erro acontece quando há uma falha temporária na sincronização com a API do Sicredi durante a geração do boleto. O boleto pode já estar registrado no banco, mesmo com o Fácil123 exibindo o status "Não registrada" e sem enviar o boleto por e-mail para o cliente.

Na própria venda, onde aparece o erro do boleto, clique em Tentar novamente. Como o erro foi apenas uma falha temporária de sincronização, o sistema não duplica o boleto: ele sincroniza com o Sicredi e corrige o que for necessário.

Erro: "Connection reset by peer - SSL_connect"

Esse erro acontece quando a configuração da conta Sicredi no Fácil123 está desatualizada, geralmente porque o código de acesso gerado no Internet Banking expirou ou a conta ainda está na versão anterior da API do Sicredi.

Gere um novo código de acesso no Internet Banking Sicredi (Cobrança → Código de acesso → Gerar) e atualize-o na conta de boleto em Financeiro → Contas. Aproveite para conferir se o campo Emissor do boleto (versão da API) está configurado como Sicredi (API V1.2).

Erro: "Negócio: Não é permitido cadastro com negativação e protesto automático simultaneamente."

Esse erro acontece quando a conta Boleto Sicredi está com o protesto automático e a negativação habilitados ao mesmo tempo. O Sicredi aceita apenas uma das duas opções por boleto. Vá em Financeiro → Contas, edite a conta Boleto Sicredi, desabilite Protestar após ou Negativação após e gere a cobrança novamente.

Itaú

Erro: "Código de multa inválido"

Esse erro acontece quando a conta de boleto híbrido Itaú ainda não tem juros e multa configurados. O Itaú exige esses valores preenchidos para autorizar a emissão do boleto.

Vá em Engrenagem → Cobranças, escolha uma categoria padrão para tarifa de cobrança e para juros e multa das cobranças, e informe os juros ao mês e a multa. Gere o boleto novamente.

Erro: "Authentication Failed"

A causa mais comum desse erro é sua conta Itaú ter habilitado apenas o modelo "Cobrança" na API do banco, sem a opção "Pix Bolecode" necessária para a emissão do boleto híbrido pelo Fácil123. Entre em contato com o gerente da sua conta no Itaú e solicite a habilitação da opção "Pix Bolecode" na API de cobrança.

Inter

Erro: "Beneficiário não encontrado.[BBRQ108]"

Esse erro acontece quando o cliente ainda não está habilitado para emitir boletos no Inter. Habilite o Boleto de Cobrança na conta do banco. Depois de habilitada, pode demorar até dois dias para o Inter liberar a emissão junto ao Fácil123.

Erro: "Unauthorized" na venda, ou "Too Many Requests" no log de erros

Esses erros também aparecem quando os boletos e Pix do Inter param de baixar automaticamente. Pode ser que o Inter tenha criado novos direitos de acesso para a integração. Vá no Internet Banking do Inter, crie um novo certificado com os devidos direitos de acesso, espere o Inter aprovar e depois substitua no Fácil123. Se o problema persistir, entre em contato com o suporte.

Erro: "Tente novamente mais tarde, caso o erro persista favor entrar em contato com o suporte Inter"

Esse é um erro temporário do próprio banco. Tente gerar o boleto novamente. Se o erro persistir, entre em contato com o suporte do Inter diretamente.

Erro: "404 page not found" ao gerar boleto Inter

Uma das causas conhecidas é o meio de pagamento estar configurado para emitir boleto normal, já que atualmente o Inter só permite a emissão pelo formato boleto híbrido. Vá em Vendas → Meio de pagamento, clique em Boleto → Alterar e confira se no Método de Pagto está selecionado Boleto híbrido.