> For the complete documentation index, see [llms.txt](https://ajuda.financeiro.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.financeiro.app/guia-completo-versao-classica/integracoes/como-gerar-boletos-pelo-asaas.md).

# Como gerar boletos pelo Asaas

{% hint style="info" %}
Usa o Falcon Finanças 3.0? Veja [Como gerar boletos e carnês](/guia-completo-3.0/financeiro/contas-a-receber/como-gerar-boletos-e-carnes.md) no Guia do Falcon Finanças 3.0.
{% endhint %}

O [Falcon Finanças](https://falcon.financeiro.app) 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**](/guia-completo-versao-classica/integracoes/como-integrar-o-asaas-ao-falcon-financas.md).

## Configurar a chave de API do Asaas

1. Acesse sua conta no Asaas pela versão web com um usuário administrador.
2. Em **Integrações > Chaves de API**, gere e copie uma chave de produção.
3. No Falcon, acesse **Sistema > Configuração do Sistema > Integrações**.
4. Cole a chave no campo do Asaas, ative a integração e clique em **Salvar**.
5. 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**](/guia-completo-versao-classica/integracoes/como-integrar-o-asaas-ao-falcon-financas.md).

## Gerar boleto pelo Contas a Receber

1. Acesse **Financeiro > Contas a Receber**.
2. Localize a receita que será cobrada.
3. Selecione o lançamento.
4. Clique em **Boleto** ou use a opção **Boleto** no menu de ações.
5. Confira os dados exibidos:
   * **Cliente**;
   * **Valor**;
   * **Vencimento**;
   * **Descrição**;
   * **Telefone**;
   * **E-mail**.
6. Clique em **Gerar Boleto**.

Ao gerar, o Falcon envia a cobrança ao Asaas e registra o boleto vinculado à parcela do Contas a Receber.

## Gerar vários boletos de uma vez

Você também pode gerar boletos para vários documentos em uma única operação. Os documentos podem pertencer ao mesmo cliente ou a clientes diferentes.

1. Acesse **Financeiro > Contas a Receber**.
2. Selecione dois ou mais documentos na lista.
3. Confira a quantidade indicada no botão **Boletos**.
4. Clique em **Boletos**.
5. Revise a quantidade de documentos e o valor total apresentados na confirmação.
6. Confirme a geração.

O Falcon gera **um boleto separado para cada documento selecionado**, mantendo o cliente, o valor e o vencimento de cada parcela. A operação não agrupa vários documentos em uma única cobrança.

Durante o processamento, documentos já recebidos, vinculados a cartão de crédito, sem CPF/CNPJ, com valor inválido ou que já possuam boleto ativo são ignorados. Ao final, o sistema informa quantos boletos foram gerados e apresenta eventuais documentos que precisam de correção.

## Como o valor do boleto é calculado

O valor enviado ao Asaas considera a composição atual da parcela:

**Valor do boleto = valor da parcela - desconto + juros + multa**

Antes de confirmar, revise o valor da parcela e os campos de desconto, juros e multa no lançamento. Se houver desconto registrado, o boleto será gerado com o valor líquido correspondente.

## 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:

1. Abra a tela de boleto da receita.
2. Localize o boleto na lista **Boletos Gerado**.
3. Use a ação de cancelamento/exclusão.
4. 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.

### Posso gerar boletos para clientes diferentes ao mesmo tempo?

Sim. Selecione os documentos desejados no Contas a Receber e clique em **Boletos**. O Falcon criará uma cobrança separada para cada documento e para o respectivo cliente.

### O desconto do lançamento é considerado no boleto?

Sim. O valor do boleto desconta o valor informado como desconto e acrescenta juros e multa, quando existirem.

### 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.