Central de Ajuda

Aparência

Tarefa - Atualiza Recorrência Pix modobank por Financeiro ​

INTRODUÇÃO ​

A Agenda de Tarefas é uma ferramenta essencial para automatizar processos e garantir a execução regular de tarefas importantes no sistema. Este documento abordará especificamente a configuração da tarefa Atualiza recorrência PIX modobank por financeiro, uma funcionalidade crucial para o gerenciamento financeiro eficiente.

Acesso ao Formulário

Caminho: Menu Ferramentas > Ferramentas > Agenda de tarefas

CONCEITO ​

Esta tarefa atua diretamente nos títulos financeiros (Contas a Receber) que possuem vínculo com uma recorrência Pix. Seu objetivo é tratar o campo "Pix Recorrente" dos boletos, garantindo que a cobrança esteja coerente com o status do contrato e respeite os prazos de aprovação.

Como funciona: A tarefa analisa os boletos gerados e aplica regras de negócio para limpeza de vínculo ou cancelamento, baseando-se tanto na resposta da API quanto no tempo de criação da recorrência:

  • Limpeza por Expiração de Tempo (24h):
    • Se a recorrência vinculada ao título estiver com status "Aguardando aprovação" e sua data de criação for superior a 24 horas, a tarefa limpa automaticamente o campo "Pix Recorrente". Isso libera o boleto para pagamento por outros meios, assumindo que a recorrência não foi aprovada pelo pagador a tempo.
  • Limpeza por Status da API:
    • Se a consulta à API retornar status "Expirado", "Rejeitado" ou "Cancelado", o vínculo também é removido.
  • Cancelamento de Cobrança Específica:
    • Caso a recorrência necessite de ajuste, mas o status na API ainda conste como "Criado" ou "Ativo", a tarefa tenta cancelar apenas a transação da cobrança recorrente vinculada, sem cancelar o título financeiro (boleto) em si.

Essa rotina assegura que o financeiro do cliente não fique preso a uma tentativa de débito automático inválida ou expirada, mantendo o contas a receber disponível para liquidação.

Passo a Passo - Configuração da Tarefa Atualiza recorrência PIX modobank por financeiro ​

  1. Acesse o menu Ferramentas no sistema.

  2. Selecione a opção Ferramentas.

  3. Clique em Agenda de tarefas.

  4. Na tela de Agenda de tarefas, clique no botão Novo para adicionar uma nova tarefa.

  5. No campo Tarefa, selecione Atualiza recorrência PIX modobank por financeiro.

  6. Agora, nos parâmetros de data, é recomendado que a tarefa seja configurada para executar uma vez no dia, em um horário que não vá conflitar com a comunicação Webhook da integração de pagamento, sendo assim, configure:

    • Minuto (0-59)
      • Tipo: Selecione a opção Valor
      • Valor: Insira o número 30
    • Hora (0-23)
      • Tipo: Selecione a opção Valor
      • Valor: Insira o número 1
    • Dia do mes (1-31)
      • Tipo: Selecione a opção Valor
      • Valor: Não preencher
    • Mes (1-12)
      • Tipo: Selecione a opção Valor
      • Valor: Não preencher
    • Dia da semana (0-6) 0=dom, 1=seg...
      • Tipo: Selecione a opção Valor
      • Valor: Não preencher

  7. Clique no botão Salvar para confirmar a configuração da tarefa.

  8. Verifique se a tarefa aparece na lista de tarefas agendadas.

Finalizado!

Com a configuração acima, a tarefa ficou configurada para executar todos os dias às 01:30 da manhã.

FLUXO DE PROCESSO ​

CONSIDERAÇÕES FINAIS ​

A atualização desta tarefa é vital para evitar inconsistências financeiras. Ao incorporar a validação de 24 horas para recorrências não aprovadas, o sistema impede que o financeiro fique dependente de webhooks que podem falhar, agilizando a liberação do boleto para o cliente final.

LEIA TAMBÉM ​

Disponibilizado por IXC S.A.

© 2025