> 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/integracoes/como-gerar-boletos-pelo-asaas.md).

# Como gerar boletos pelo Asaas

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

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

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