> 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-utilizar-o-extrato-do-asaas.md).

# Como utilizar o extrato do Asaas

O **Extrato do Asaas** permite consultar movimentações da conta Asaas integrada ao [**Falcon Finanças**](https://falcon.financeiro.app). Ele ajuda a conferir cobranças, recebimentos, taxas e demais movimentações retornadas pela integração.

***

## Antes de usar

Confira se:

* a empresa possui conta ativa no Asaas;
* a chave de API do Asaas foi configurada no Falcon;
* a conexão foi testada com sucesso;
* a conta Asaas está relacionada corretamente à rotina financeira utilizada.

Se ainda não configurou a chave, siga primeiro o guia [**Como integrar o Asaas ao Falcon Finanças**](/guia-completo/integracoes/como-integrar-o-asaas-ao-falcon-financas.md).

***

## Onde encontrar

Acesse **Financeiro > Extrato do Asaas**.

Use a tela para consultar movimentações retornadas pela integração e comparar com os lançamentos financeiros do Falcon.

***

## Consultar o extrato

1. Acesse **Financeiro > Extrato do Asaas**.
2. Se a empresa possui mais de uma Conta Conectada do Asaas, escolha a conta desejada.
3. Informe a data inicial e a data final da consulta.
4. Clique em **Atualizar**.
5. Confira os indicadores de **Saldo Atual**, **Entrada** e **Saída**.
6. Analise a lista de movimentações, que apresenta data, identificador, descrição, valor e saldo.

O Falcon abre a tela considerando inicialmente um período recente. Ajuste as datas sempre que precisar consultar uma movimentação mais antiga.

***

## Exportar as movimentações

Na parte superior da tela, você pode usar as ações de exportação:

* **Excel:** gera uma planilha com as movimentações exibidas;
* **OFX:** gera um arquivo de extrato que pode ser usado em rotinas compatíveis com esse formato.

Antes de exportar, selecione a conta correta, informe o período desejado e clique em **Atualizar**.

***

## Chave geral e chave da Conta Conectada

Quando existe uma Conta Conectada do Asaas selecionada, o extrato usa a chave salva no cadastro dessa conta. Se nenhuma chave específica estiver disponível, o Falcon usa a chave geral configurada para a empresa.

Se você atualizou a chave em **Sistema > Configuração do Sistema > Integrações**, mas o extrato ainda apresenta erro, atualize também a chave em **Cadastros > Contas > Conta Conectada**.

***

## Relação com boletos e conciliação

Boletos gerados pelo Asaas podem ter status acompanhados pelo Falcon, mas a conferência financeira continua sendo importante.

Ao analisar o extrato, verifique:

* data do recebimento;
* valor recebido;
* tarifas ou descontos;
* conta usada no lançamento;
* baixa do Contas a Receber;
* conciliação com o movimento bancário.

***

## Boas práticas

* Compare o extrato do Asaas com o Contas a Receber antes de considerar uma cobrança totalmente conferida.
* Registre taxas, juros, descontos ou estornos quando necessário.
* Confira se a conta e o período selecionados estão corretos antes de exportar.
* Mantenha a chave de API protegida e atualizada.

***

## Solução de problemas

### A chave está inválida ou expirou

Valide a situação da chave em **Integrações > Chaves de API** no Asaas. Depois, atualize a chave geral da empresa ou a chave da Conta Conectada e teste novamente.

### A conta desejada não aparece na seleção

Abra **Cadastros > Contas** e confirme se a conta está ativa, usa o banco **Asaas**, está marcada como **Conta Conectada** e possui uma chave válida.

### O saldo ou as movimentações parecem desatualizados

Confira a conta selecionada, ajuste o período e clique em **Atualizar**. Se o problema continuar, consulte a mesma movimentação no painel do Asaas para comparar os dados.

### O boleto foi recebido, mas a receita não está conferida

Compare o valor recebido com o Contas a Receber e verifique taxas, descontos, juros, estornos e a conta usada na baixa. A consulta do extrato não substitui a conferência financeira.