Boleto e Pix da Asaas não saem: as mensagens do sistema e a ordem de diagnóstico
A Asaas é integração externa: o ERP valida o lançamento e entrega a emissão a um serviço de cobrança de fora, que fala com a Asaas. O que a Asaas responde não se audita aqui — o ERP só guarda o retorno. O panorama da integração está na fonte de visão geral; o vínculo da forma de pagamento, na fonte da forma de pagamento. Forma de pagamento, baixa e link de pagamento em si: fontes do Financeiro.
ANTES DE TUDO
A forma de pagamento do lançamento precisa ter a Asaas escolhida no campo de banco. Sem isso o lançamento nem entra no caminho da integração.
ORDEM DE DIAGNÓSTICO (é a ordem em que o sistema valida; aparece só a mensagem da primeira checagem que falha)
1. O lançamento tem forma de pagamento.
2. A forma está marcada para boleto ou cartão (no caminho do Pix: para Pix ou cartão).
3. O recurso Asaas está liberado no plano — a checagem olha a empresa e a loja do lançamento.
4. Quem tentou tem a permissão de imprimir boleto ou de imprimir Pix. É permissão do Financeiro do ERP, não da tela da Asaas, e só é checada para quem está logado.
5. O lançamento está baixado. É a última checagem, não a primeira.
AS MENSAGENS E A CAUSA
"Este lançamento não está vinculado a uma forma de pagamento válida!" O lançamento está sem forma, ou a forma não está marcada para boleto nem cartão (no caminho do Pix: nem Pix nem cartão).
"O seu plano atual não lhe permite utilizar a integração com a Asaas. Por favor, contrate outro plano!" O recurso Asaas não está liberado na checagem por empresa e loja.
"O seu plano atual não lhe permite acessar a integração com o Asaas. Por favor, contrate outro plano!" Mesma causa, na segunda checagem (por empresa) feita na hora de gerar o Pix.
"Você não tem permissão para acessar esta área!" Falta a permissão de imprimir boleto ou de imprimir Pix.
"Este lançamento já foi pago!" Está baixado.
Forma de pagamento "X" não vinculada a integração! Na prática é mensagem do caminho do Pix: a forma não tem banco de integração — campo banco vazio ou apontando para um banco comum. No boleto o sistema só chama a integração quando o banco é de integração; forma sem integração gera o boleto comum em PDF, não essa mensagem.
"Este lançamento não está disponível!" Ou o lançamento não foi encontrado (link ou hash errado, lançamento de outra empresa), ou quem abriu não está logado na empresa dona — nesse caso o sistema esconde de propósito a causa real. Para ver a causa verdadeira, mande gerar pelo Financeiro, logado na empresa do lançamento.
"Hash não encontrado" e "Link de pagamento não encontrado!" São do link de pagamento enviado: link inválido ou que não corresponde a nenhum envio.
A PERMISSÃO QUE TRAVA A EMISSÃO NÃO É A DO APLICATIVO
Vale insistir porque isso trava atendimento. A permissão checada no passo 4 é a do Financeiro do sistema principal: imprimir boleto e imprimir Pix, nas movimentações financeiras. Ela não está na lista de permissões do Asaas — a lista do Asaas governa as telas do próprio aplicativo. Liberar tudo dentro do Asaas não resolve "Você não tem permissão para acessar esta área!" na hora de emitir. A lista do aplicativo está na fonte de permissões do Asaas.
O QUE COSTUMA DAR ERRADO
Cada tentativa grava o resultado no lançamento. Deu certo, a cobrança (ou o Pix) passa a constar como gerada na Asaas, com a data do dia. Falhou, fica como não gerada e a mensagem devolvida pela integração fica registrada no lançamento — é ela que aparece na lista de lançamentos. Leia essa mensagem antes de qualquer outra coisa: é o retorno real da tentativa.
Lançamento baixado sempre aparece na lista como cobrança gerada, mesmo que nunca tenha sido gerada.
A emissão de boleto por integração tem espera de 15 segundos por lançamento: se houve tentativa nos últimos 15 segundos que não terminou bem, a próxima demora esse tempo. Quando a emissão dá certo, a trava é liberada na hora. O Pix não passa por ela.
Impressão em lote: qualquer lançamento que falhe na validação para o lote inteiro com aquela mensagem, e o primeiro lançamento com integração encerra o lote, respondendo só ele.
No link de pagamento do envio, forma marcada como Pix abre Pix; senão, boleto.