# Tarefa - Processamento Retorno Asaas API

## Introdução

A Agenda de Tarefas é uma ferramenta indispensável para automatizar processos e garantir a execução regular de atividades no sistema. Este documento aborda a configuração da tarefa "Processamento retorno Asaas API", uma funcionalidade essencial para o gerenciamento financeiro eficiente, especialmente quando a comunicação Webhook falha em trazer atualizações de cobrança para o sistema.

> [!NOTA] **Acesso ao Formulário**  
> **Caminho:** Menu Ferramentas > Ferramentas > Agenda de tarefas.

## Conceito

A tarefa "Processamento retorno Asaas API" utiliza a API Asaas para consultar e atualizar automaticamente o status de pagamentos de boletos bancários no sistema. Por meio de uma conexão segura com a API, esta rotina verifica o status dos boletos emitidos, processa as informações recebidas e atualiza os registros internos no sistema. Essa tarefa é essencial para:  

- Garantir a precisão das informações financeiras.  
- Eliminar a necessidade de verificações manuais.  
- Melhorar a gestão do fluxo de caixa.  
- Proporcionar uma visão atualizada dos recebimentos.  

A tarefa é normalmente configurada para ser executada uma vez ao dia, no final da noite, como por exemplo, às 23h50.

## Passo a Passo - Configuração Da Tarefa "Processamento Retorno Asaas API"

1. Acesse o menu **Ferramentas** no sistema.  
2. Clique na opção **Ferramentas**.  
3. Selecione **Agenda de tarefas**.  
4. Na tela de Agenda de tarefas, clique no botão **Novo** para adicionar uma nova tarefa.  
5. No campo **Tarefa**, escolha "Processamento retorno Asaas API".  
6. Configure os parâmetros de data para que a tarefa seja executada uma vez ao dia, em um horário que não conflite com a comunicação Webhook da integração de pagamento. Recomenda-se a seguinte configuração:  
   - **Minuto (0-59):**  
     - **Tipo:** Selecione "Valor".  
     - **Valor:** Insira **50**.  
   - **Hora (0-23):**  
     - **Tipo:** Selecione "Valor".  
     - **Valor:** Insira **23**.  
   - **Dia do mês (1-31):**  
     - **Tipo:** Selecione "Valor".  
     - **Valor:** Deixe em branco.  
   - **Mês (1-12):**  
     - **Tipo:** Selecione "Valor".  
     - **Valor:** Deixe em branco.  
   - **Dia da semana (0-6), 0=dom, 1=seg...:**  
     - **Tipo:** Selecione "Valor".  
     - **Valor:** Deixe em branco.  
7. Clique no botão **Salvar** para confirmar a configuração.  
8. Verifique se a tarefa aparece na lista de tarefas agendadas. 
9. Fim.

> [!SUCCESS] Finalizado!
> Com a configuração acima, a tarefa ficou configurada para executar todos os dias às 23h50.

## Fluxo de Processo

```mermaid
graph TD
    A[Início] --> B[Acesse o menu Ferramentas]
    B --> C[Selecione a opção Ferramentas]
    C --> D[Clique em Agenda de tarefas]
    D --> E[Clique no botão Novo]
    E --> F[Selecione Processamento retorno Asaas API no campo Tarefa]
    F --> G[Configure os parâmetros de data]
    G --> H[Minuto: Tipo Valor, Valor 50]
    H --> I[Hora: Tipo Valor, Valor 23]
    I --> J[Dia do mês: Tipo Valor, Valor em branco]
    J --> K[Mês: Tipo Valor, Valor em branco]
    K --> L[Dia da semana: Tipo Valor, Valor em branco]
    L --> M[Clique no botão Salvar]
    M --> N{Tarefa aparece na lista de tarefas agendadas?}
    N -->|Sim| O[Fim]
    N -->|Não| P[Verifique a configuração]
    P --> G

```

## Considerações Finais

A configuração da tarefa "Processamento retorno Asaas API" representa um importante avanço na gestão financeira das empresas que utilizam boletos da Asaas. Essa automação reduz a necessidade de intervenções manuais, otimiza processos internos e melhora significativamente a precisão das informações financeiras, facilitando a reconciliação bancária.  

Ao garantir atualizações em tempo quase real, a tarefa fornece dados mais confiáveis, contribuindo para uma tomada de decisão mais assertiva e uma gestão de fluxo de caixa mais eficiente. No entanto, é essencial monitorar regularmente o funcionamento da tarefa, verificar as credenciais de acesso à API para mantê-las sempre atualizadas e revisar periodicamente os logs gerados. Dessa forma, podem ser identificadas eventuais anomalias ou oportunidades de melhoria no processo, garantindo seu desempenho ideal.

## ETIQUETAS
#AgendaTarefas #ConsultaPagamentos #AutomacaoFinanceira #GestaoFinanceira #BoletoHibrido #Boleto #Pix #Asaas

## LEIA TAMBÉM
- [[carteira de cobranca|Carteira de Cobrança]]
- [[contas a receber|Contas a Receber]]
- [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
- [[integracoes bancarias - api|Integrações Bancárias - API]]
- [[gateway asaas|Gateway Asaas]]
- [[consulta manual de pagamentos|Consulta Manual de Pagamentos]]
- [[logs gateway|Logs Gateway]]
- [[como reprocessar logs gateway|Como Reprocessar Logs Gateway]]
- [[localizar pagamentos - logs gateway|Localizar Pagamentos - Logs Gateway]]
- [[logs de rotinas de cobranca gateway|Logs de Rotinas de Cobrança Gateway]]
- [[logs gateway|Logs Gateway]]
- [[logs de tarefas|Logs de Tarefas]]