Como gerar boletos pelo Asaas
O Falcon Finanças permite gerar boletos pelo Banco Digital Asaas diretamente a partir do Contas a Receber. Assim, você cria a cobrança, acompanha o status e mantém o boleto vinculado ao lançamento financeiro.
Você acessa esse recurso em Financeiro > Contas a Receber, selecionando uma receita e clicando em Boleto.
O que você precisa antes de gerar boletos
Antes de gerar boletos, confirme estes pontos:
a empresa possui uma conta ativa no Asaas;
a chave de API do Asaas foi gerada;
a chave de API foi salva no Falcon;
o cliente possui CPF/CNPJ válido;
o cliente possui e-mail e telefone preenchidos, quando possível;
a receita está cadastrada no Contas a Receber com valor e vencimento corretos.
Se esta é a primeira configuração, siga antes o guia Como integrar o Asaas ao Falcon Finanças.
Configurar a chave de API do Asaas
Acesse sua conta no Asaas pela versão web com um usuário administrador.
Em Integrações > Chaves de API, gere e copie uma chave de produção.
No Falcon, acesse Sistema > Configuração do Sistema > Integrações.
Cole a chave no campo do Asaas, ative a integração e clique em Salvar.
Volte ao Contas a Receber e abra novamente a opção de boleto.
Depois de validar a chave, o Falcon libera a aba de boleto para geração das cobranças.
Para ver o passo a passo completo, incluindo Conta Conectada, troca de chave e diagnóstico de erros, consulte Como integrar o Asaas ao Falcon Finanças.
Gerar boleto pelo Contas a Receber
Acesse Financeiro > Contas a Receber.
Localize a receita que será cobrada.
Selecione o lançamento.
Clique em Boleto ou use a opção Boleto no menu de ações.
Confira os dados exibidos:
Cliente;
Valor;
Vencimento;
Descrição;
Telefone;
E-mail.
Clique em Gerar Boleto.
Ao gerar, o Falcon envia a cobrança ao Asaas e registra o boleto vinculado à parcela do Contas a Receber.
O que acontece ao gerar o boleto
Quando o boleto é gerado:
o Falcon verifica se o cliente já existe no Asaas pelo CPF/CNPJ;
se necessário, cria o cliente no Asaas;
envia os dados da cobrança;
recebe o identificador do boleto;
salva a URL do boleto;
exibe o boleto na lista Boletos Gerado;
permite abrir o boleto ou o PDF.
Acompanhar boletos gerados
Na tela de Manutenção de Boletos, o Falcon mostra a lista de boletos vinculados à receita.
As principais colunas são:
Boleto: ação para abrir ou visualizar a cobrança;
Status: situação retornada pelo Asaas;
Cadastro: data de criação;
Recebimento: data confirmada de pagamento, quando houver;
Identificador: código da cobrança no Asaas;
PDF: acesso ao PDF do boleto.
O Falcon atualiza o status consultando o Asaas enquanto a tela está aberta.
Visualizar boleto ou PDF
Na lista de boletos gerados:
clique na ação de Boleto para abrir a cobrança;
clique na ação de PDF para abrir o arquivo do boleto.
Esses links podem ser usados para conferência e envio ao cliente.
Cancelar ou inativar boleto
Quando um boleto não deve mais ser cobrado:
Abra a tela de boleto da receita.
Localize o boleto na lista Boletos Gerado.
Use a ação de cancelamento/exclusão.
Confirme a operação.
O Falcon solicita o cancelamento no Asaas e inativa o boleto no sistema.
Use essa opção com cuidado. Se o cliente já recebeu o boleto, avise que a cobrança foi cancelada ou substituída por outra.
Status mais comuns
Os status são retornados pelo Asaas e podem variar conforme a situação da cobrança.
Os mais comuns são:
PENDING: cobrança aguardando pagamento.
RECEIVED: pagamento confirmado.
CONFIRMED: pagamento confirmado ou em processo de confirmação, conforme regra do Asaas.
OVERDUE: cobrança vencida.
DELETED ou CANCELLED: cobrança removida ou cancelada.
Se houver dúvida sobre um status específico, confira também a cobrança diretamente no painel do Asaas.
Boletos pagos e recebimento no Falcon
O boleto estar pago no Asaas indica que a cobrança foi recebida pela instituição. Para manter a gestão financeira correta, confira também:
se a receita no Falcon está baixada corretamente;
se a conta de recebimento está correta;
se o valor recebido bate com o valor esperado;
se há juros, multa, desconto ou taxa;
se a movimentação aparece no extrato/conciliador.
Essa conferência é importante para manter saldo, fluxo de caixa e relatórios consistentes.
Cuidados com dados do cliente
Antes de gerar boleto, revise o cadastro do cliente:
CPF/CNPJ;
razão social ou nome;
e-mail;
telefone;
endereço, quando necessário.
Dados incorretos podem impedir a geração da cobrança ou causar problemas no envio ao cliente.
Quando gerar um novo boleto
Gere um novo boleto quando:
o vencimento mudou;
o valor mudou;
a cobrança anterior foi cancelada;
o cliente solicitou uma nova cobrança;
o boleto anterior foi criado com dados incorretos.
Evite manter vários boletos ativos para a mesma receita, pois isso pode confundir o cliente e dificultar a conciliação.
Dúvidas comuns
Preciso ter conta no Asaas?
Sim. A geração de boletos usa a integração com o Banco Digital Asaas.
Onde pego a chave de API?
No painel do Asaas, na área de integração/API da sua conta. Depois de copiar, salve a chave no Falcon.
Posso gerar boleto sem cliente cadastrado?
Não é recomendado. O cliente precisa estar cadastrado corretamente no Falcon, principalmente com CPF/CNPJ válido.
O boleto aparece no Asaas?
Sim. O Falcon cria a cobrança no Asaas e armazena o identificador retornado pela integração.
Posso cancelar boleto pelo Falcon?
Sim, pela tela de manutenção de boletos. O Falcon envia a solicitação ao Asaas e inativa o boleto localmente.
O boleto pago quita automaticamente o Contas a Receber?
O status do boleto é acompanhado pela integração, mas é importante conferir o recebimento, conta e conciliação. Isso evita divergência entre boleto, extrato, saldo e relatórios.
Atualizado