Central de Ajuda

Aparência

Tarefa - Atualiza Recorrência Pix modobank por Contrato ​

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 contrato, uma funcionalidade crucial para o gerenciamento financeiro eficiente.

Acesso ao Formulário

Caminho: Menu Ferramentas > Ferramentas > Agenda de tarefas

CONCEITO ​

Esta tarefa automática visa garantir a integridade do status da recorrência Pix vinculado ao contrato do cliente, reduzindo a dependência exclusiva da API da modobank para validação de expiração e focando na base de dados interna para evitar travamentos.

Como funciona: A rotina é executada diariamente (preferencialmente na madrugada) e aplica duas regras de negócio distintas baseadas no status atual da recorrência no sistema:

  1. Validação por Tempo (Status "Aguardando aprovação"):

    • O sistema verifica a data de criação da recorrência no histórico do contrato.
    • Regra de 24h: Se a recorrência estiver como "Aguardando aprovação" há mais de 24 horas, a tarefa altera automaticamente o status para "Expirado".
    • Independência da API: Esta validação é feita sem consultar a API da modobank, contornando problemas onde a API retorna "Não encontrado" ou falhas de webhook.

  2. Validação via API (Status "Ativa"):

    • Para contratos que já constam com status "Ativa", a tarefa realiza a consulta na API da modobank.
    • O objetivo é verificar se a recorrência permanece ativa ou se houve alguma alteração externa não notificada.

Essa abordagem híbrida garante que contratos não fiquem presos aguardando uma resposta de aprovação que nunca chegará, permitindo ao provedor realizar alterações de plano ou novos vínculos sem erros de validação.

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

  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 Consulta de pagamentos modobank.

  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 configuração correta desta tarefa é fundamental para manter a consistência dos dados. Ao forçar a expiração de recorrências pendentes há mais de 24 horas, o sistema evita inconsistências causadas pela falta de webhooks de expiração, garantindo um fluxo operacional mais fluido.

LEIA TAMBÉM ​

Disponibilizado por IXC S.A.

© 2025