Central de Ajuda

Leitura de 4 min

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.

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.

Finalizado!

Com a configuração acima, a tarefa ficou configurada para executar todos os dias às 23h50.

Fluxo de Processo

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

Visão de gráfico