Central de Ajuda Quaza Provedores

Tarefas automáticas do financeiro (PT)

Tarefas automáticas do financeiro — Quaza

Boa parte do trabalho do financeiro do Quaza acontece sozinha, em horários programados: gerar as cobranças do mês, avisar quem vai vencer, montar boletos e carnês, dar baixa no que foi pago e gerar as faturas. Essas rotinas são as tarefas automáticas. Este documento lista todas as tarefas que tocam o financeiro, explica o que cada uma faz e mostra como acompanhar, na tela Admin → Tarefas, se elas rodaram ou falharam.

Nesta página:

O que são tarefas automáticas

Uma tarefa é uma rotina que o Quaza executa sozinho, em horários definidos, sem ninguém precisar clicar. É assim que as cobranças do mês nascem, os avisos de vencimento saem, os boletos e carnês são montados e os pagamentos confirmados pelo banco caem como baixados — tudo em lote, para todos os clientes, no horário programado.

Quase tudo que você faz manualmente em uma cobrança (gerar, enviar, dar baixa) também acontece por tarefa, em massa. A diferença é que a tarefa percorre todos os contratos e cobranças de uma vez, no horário marcado.

Quem liga ou desliga uma tarefa é o administrador do servidor (a equipe técnica), na agenda de tarefas do servidor — a chamada crontab. Não é o operador que liga/desliga pela tela. A tela Admin → Tarefas apenas informa: mostra a descrição de cada tarefa, o resumo da última execução, o e-mail que recebe avisos de erro e o tempo limite. Se uma tarefa precisa começar a rodar, parar ou mudar de horário, abra um chamado para a equipe técnica.

Quando este documento ajuda (e quando não)

Use este documento quando…	Procure outro quando…
Quer entender o que cada rotina automática do financeiro faz.	Quer aprender a operar a tela de Cobranças no dia a dia — veja Cobranças .
Uma cobrança, fatura ou carnê não foi gerado e quer saber se a tarefa rodou.	Quer configurar a carteira, multa, juros ou o gateway — veja Regras de cobrança e Gateway bancário .
Um pagamento foi feito mas a cobrança continua aberta, e quer saber qual tarefa dá a baixa.	Quer mudar o horário ou ligar/desligar uma rotina — isso é com a equipe técnica (crontab).
Quer acompanhar em Admin → Tarefas se algo falhou.	Quer gerar as faturas das mensalidades — veja Fatura .

Todas as tarefas do financeiro

As tarefas estão agrupadas por assunto. A coluna Pré-requisito diz o que precisa estar configurado para a tarefa ter o que fazer — sem isso, ela roda mas não produz nada.

Gerar cobranças e documentos

Tarefa	O que faz	Pré-requisito
Contrato — Criar as Faturas	Percorre os contratos do dia com débitos marcados para a próxima fatura e gera a fatura da competência. Pula contratos unificados ou que já têm fatura no período.	Módulo de faturas ligado e contratos com débitos marcados para a próxima fatura.
Financeiro — Documento recorrente	Gera, no dia configurado de cada recorrência, os documentos das vendas/assinaturas recorrentes ativas.	Vendas recorrentes cadastradas e ativas, com o dia de inclusão definido.
Financeiro — Criar entrada sequencia	Prepara as sequências de numeração que os boletos e as remessas usam, para cada carteira de cobrança ativa.	Carteira de cobrança ativa.
Financeiro — Processar sequencia	Processa em lote as cobranças do período conforme a sequência da carteira e notifica o responsável ao terminar.	Sequência preparada e carteira de cobrança ativa.

Avisar e enviar ao cliente

Tarefa	O que faz	Pré-requisito
Financeiro — Aviso de vencimento	Envia ao cliente o lembrete de vencimento — antes do vencimento, no dia ou após vencer — por e-mail, SMS ou WhatsApp, conforme os dias configurados. Pode anexar a nota fiscal quando o envio é por e-mail.	Modelo de mensagem configurado, dias de aviso definidos e cliente com e-mail/telefone cadastrado.
Contrato — Enviar email das faturas	Envia as faturas do dia por e-mail e WhatsApp, conforme as ações da regra de cobrança. Respeita a opção de não reenviar faturas já pagas.	Módulo de faturas ligado e regra de cobrança com a ação de envio de fatura.
Financeiro — Envio carnê PDF	Monta o carnê do contrato em PDF e envia ao cliente por e-mail, com o link para acessar o boleto.	Cliente com carnê e e-mail cadastrado, e modelo de mensagem definido.
Financeiro — Alerta fim carnê	Avisa internamente quando o carnê de um cliente está acabando (resta uma parcela em aberto), para que um novo carnê seja gerado a tempo.	Clientes com carnê em andamento.

Montar boletos e carnês

Tarefa	O que faz	Pré-requisito
Financeiro — Criar boleto PDF	Gera, em lote, o PDF dos boletos do período, agrupando vários boletos em um arquivo para impressão e envio.	Cobranças com boleto geradas em uma carteira de cobrança.
Financeiro — Criar boleto cliente	Gera o PDF dos boletos separado por cliente, para o cliente acessar o próprio documento.	Cobranças com boleto geradas e clientes vinculados.
Financeiro — Processar carnê	Processa em lote o carnê dos clientes (gera as parcelas) e notifica o responsável ao terminar.	Contratos configurados para carnê e carteira de cobrança ativa.
Financeiro — Criar segunda via	Reemite a 2ª via do boleto para cobranças que precisam de novo arquivo (atualização do documento).	Cobrança em aberto com boleto.

Baixar e atualizar valores

Tarefa	O que faz	Pré-requisito
Financeiro — Processar retorno	Lê o arquivo de retorno enviado pelo banco e dá baixa automática nas cobranças que foram pagas, registrando o recebimento. Notifica o responsável com o resumo da importação.	Carteira por arquivo de remessa/retorno (boleto registrado) e o arquivo de retorno disponível.
Financeiro — Gateway	Consulta no gateway (intermediário de pagamento) as cobranças ainda em aberto, verifica se foram pagas e dá baixa nas que já receberam.	Carteira com gateway configurado e credenciais válidas.
Financeiro — Remessa gateway	Gera e envia ao intermediário a remessa das cobranças em aberto e processa o retorno, para registrar e confirmar pagamentos pelo intermediário.	Carteira que opera por remessa via intermediário, configurada.
Financeiro — Atualiza valor	Recalcula o valor atualizado das cobranças vencidas em aberto, somando multa e juros do atraso ao valor original.	Carteira com regras de multa e juros definidas.

Cartão recorrente e protesto

Tarefa	O que faz	Pré-requisito
Financeiro — Pagamento recorrente no cartão	Cobra automaticamente, no cartão de crédito do cliente, as cobranças recorrentes que vencem, e dá baixa nas que forem aprovadas.	Carteira de cartão recorrente configurada e cartão do cliente cadastrado.
Financeiro — Aviso de pagamento recorrente	Avisa o cliente, com antecedência, que a cobrança no cartão recorrente será feita.	Carteira de cartão recorrente e modelo de mensagem configurados.
Financeiro — Protesto	Prepara e envia ao intermediário as cobranças vencidas em aberto para protesto, quando o provedor usa esse recurso.	Carteira com protesto habilitado e cobranças vencidas em aberto.

Cartão recorrente roda por dentro do gateway. A cobrança no cartão e o aviso de pagamento recorrente acontecem junto das rotinas de gateway. Por isso, no painel Admin → Tarefas, você acompanha esses processos pelas linhas de Gateway e Remessa gateway — não há uma linha separada de cartão recorrente para cada caso.

Boa parte é, na prática, a versão em massa do que você faz na tela. Gerar cobrança, enviar boleto, dar baixa de pagamento — tudo isso você também consegue fazer um a um na tela de Cobranças . As tarefas só fazem o mesmo para todos os clientes de uma vez, no horário programado.

Tela Admin → Tarefas — o que cada coluna mostra

Admin → Tarefas

Essa tela lista todas as tarefas do sistema (não só as do financeiro). Você não adiciona nem liga/desliga tarefa por aqui — a tela é de consulta. Cada linha mostra:

Tela Admin → Tarefas: cada linha é uma tarefa, com a descrição, o resumo da última execução, o e-mail de aviso e o tempo limite.

Coluna	O que mostra
Código	O lápis para abrir a tarefa e consultar os detalhes. O código identifica a tarefa.
Descrição	O nome da tarefa, com o módulo na frente (ex.: "Financeiro — Aviso de vencimento", "Contrato — Criar as Faturas"). É por aqui que você localiza a tarefa que procura.
Resumo	Um texto curto explicando o que a tarefa faz. Ajuda a confirmar se é a tarefa certa.
E-mail	Endereço que recebe o aviso quando a tarefa dá erro. Se estiver vazio, ninguém é avisado por e-mail — o erro só aparece no histórico.
Tempo limite	Quanto tempo (em segundos) a tarefa pode demorar antes de ser considerada travada. Se passar disso e não terminar, ela aparece destacada no histórico.
Alteração / Alterador	Quando e por quem o cadastro da tarefa foi alterado pela última vez.

O horário em que a tarefa roda NÃO aparece nessa tela. A frequência e o horário ficam na agenda do servidor (crontab), controlada pela equipe técnica. Aqui você vê a descrição, o resumo, o e-mail de aviso e o tempo limite — mas não o horário de execução.

Como saber se uma tarefa rodou ou falhou

Cada vez que uma tarefa é executada, o Quaza registra um histórico com início, fim, tempo gasto, estado e o resultado (o que ela processou ou o erro encontrado). É aí que você descobre se a rotina rodou e o que ela reportou.

Histórico de execuçãoAdmin → Tarefas (histórico)

Lista cada execução, da mais recente para a mais antiga. Em cada linha você vê quando começou e terminou, quanto tempo levou, o estado e se já foi resolvida. Abrindo a execução, o campo de resultado traz o detalhe (ex.: quantas cobranças processou ou a mensagem de erro). Quem investiga "por que a cobrança não saiu?" começa por aqui.

Os estados de uma execução são:

Estado	Significado	O que fazer
Iniciada	A tarefa começou e ainda não terminou.	Aguarde. Se passar do tempo limite, ela aparece destacada (possível travamento).
Concluída	A tarefa rodou até o fim sem erro.	Nada. Confira o resultado para ver o que foi processado.
Falhada	A tarefa parou com erro. A linha aparece em vermelho.	Abra a execução, leia a mensagem de erro no resultado e corrija a causa (ver Pegadinhas).

Linhas em vermelho são execuções que falharam; linhas em amarelo/destaque são execuções que passaram do tempo limite sem terminar (possível travamento). Depois de tratar uma execução com problema, marque-a como resolvida para tirá-la da lista de pendências.

Atalho de diagnóstico: uma cobrança, fatura ou carnê não saiu? Abra Admin → Tarefas (histórico), localize a última execução da tarefa correspondente e leia o resultado. Ele costuma dizer exatamente o que faltou (ex.: "Nenhum template configurado", "O módulo de faturas está desabilitado").

Configuração-chave: ligar a automação

Uma tarefa só produz alguma coisa se houver o que processar. Antes de cobrar resultado de uma rotina, confira os pré-requisitos:

Carteira de cobrança ativaFinanceiro → Carteira de cobrança

Define o banco, o meio de pagamento (boleto, PIX, cartão, carnê ou débito em conta) e as regras de multa, juros e desconto. Sem uma carteira ativa, as tarefas de gerar, montar boleto e dar baixa não têm o que processar. Detalhes em Regras de cobrança .

Geração automática (módulo de faturas)Configurações → Configurações da fatura

As tarefas de criar e enviar fatura só funcionam com o módulo de faturas ligado. Com ele desligado, essas tarefas param na hora com o aviso "O módulo de faturas está desabilitado", mesmo que estejam ativas na agenda do servidor. Veja Fatura .

Gateway ou conta no bancoFinanceiro → Gateway bancário

Se a carteira usa um intermediário de pagamento, as credenciais precisam estar configuradas e válidas para as tarefas de gateway, remessa e protesto funcionarem. Se usa boleto registrado por arquivo, a remessa/retorno precisa estar ativa. Veja Gateway bancário .

Modelo de mensagemComunicação → Modelos

As tarefas de aviso de vencimento, envio de carnê e envio de fatura usam um modelo de e-mail (e, se houver, de SMS/WhatsApp). Sem modelo configurado, o envio falha avisando que o modelo não foi definido.

Glossário

Termo	Significado
Tarefa	Rotina que o Quaza executa sozinho, em horário programado, sem ninguém clicar.
Crontab	A agenda de tarefas do servidor, controlada pela equipe técnica. É ela que decide quando cada tarefa roda. O operador não mexe nela.
Resumo	Texto curto que descreve o que a tarefa faz, exibido na tela Admin → Tarefas.
Tempo limite	Tempo máximo (em segundos) que uma tarefa pode demorar antes de ser considerada travada.
Histórico	Registro de cada execução de uma tarefa: início, fim, estado e resultado.
Retorno (do banco)	Arquivo enviado pelo banco informando quais boletos foram pagos. O Quaza lê esse arquivo para dar baixa nas cobranças.
Remessa	Arquivo enviado ao banco com as cobranças a registrar (o caminho inverso do retorno).
Gateway	Intermediário de pagamento (ex.: para boleto, PIX ou cartão) que registra as cobranças e informa quando foram pagas.
Carnê	Conjunto de parcelas (boletos) de um contrato, geralmente entregues de uma vez para o cliente.
Recorrência	Venda ou assinatura que gera documentos automaticamente em um dia fixo, todo período.
Protesto	Envio de uma cobrança vencida em aberto a cartório, via intermediário, como medida de cobrança.

Pegadinhas frequentes

1. A tela não liga nem desliga tarefa. Admin → Tarefas só informa. Para começar a rodar, parar ou mudar o horário de uma tarefa, é a equipe técnica na agenda do servidor (crontab). Abra um chamado.

2. O horário não aparece na tela. A frequência (diária, de hora em hora) fica na crontab. A tela mostra descrição, resumo, e-mail e tempo limite — não o horário.

3. Tarefa rodou, mas não fez nada. Concluída não quer dizer que gerou algo. Se faltava pré-requisito (carteira inativa, sem débitos marcados, sem modelo), a tarefa termina sem produzir nada. Leia o resultado no histórico.

4. Módulo desligado trava a tarefa. Com o módulo de faturas desligado, as tarefas de criar/enviar fatura param na hora com "O módulo de faturas está desabilitado" — mesmo ativas na crontab.

5. Aviso de vencimento sem template não envia. Sem o modelo de mensagem configurado, o aviso falha dizendo que o template não foi definido. Configure em Comunicação → Modelos.

6. Cliente sem e-mail/telefone não recebe. Aviso de vencimento e envio de carnê dependem do contato cadastrado no cliente. Sem e-mail (ou telefone, para SMS/WhatsApp), o envio para aquele cliente é pulado.

7. Baixa não é imediata. Pagamento por boleto registrado só baixa quando a tarefa de retorno lê o arquivo do banco; por gateway, quando a tarefa de gateway sincroniza. Até lá, a cobrança segue aberta. Para conferir na hora, use Verificar gateway no detalhe da cobrança.

8. "Atualiza valor" não cobra sozinho. Ela só recalcula multa e juros das cobranças vencidas (o valor atualizado). Não envia nada nem dá baixa. Quem avisa o cliente é o aviso de vencimento.

9. Documento recorrente roda no dia certo. A recorrência só gera documento no dia configurado nela. Se o dia já passou ou a recorrência está inativa, nada é gerado naquele dia.

10. Falha investigada continua na lista. Tratar a causa não tira a execução falhada da lista de pendências. Depois de resolver, marque-a como resolvida no histórico.

11. Protesto e cartão recorrente só rodam se o provedor usa. Essas tarefas dependem de carteira específica (protesto habilitado, cartão recorrente). Se o provedor não usa esses recursos, elas não têm o que processar.

Perguntas frequentes

A cobrança do mês não foi gerada. Como descubro o motivo?

Abra Admin → Tarefas (histórico), localize a última execução da tarefa de geração (criar fatura, processar sequência ou documento recorrente, conforme o caso) e leia o resultado. Ele costuma indicar a causa: carteira inativa, sem débitos marcados, módulo desligado.

Posso ligar ou desligar uma tarefa pela tela Admin → Tarefas?

Não. A tela só informa. Ligar, desligar ou mudar o horário de uma tarefa é feito pela equipe técnica na agenda do servidor (crontab). Abra um chamado descrevendo o que precisa.

Onde vejo se uma tarefa falhou?

No histórico (Admin → Tarefas, histórico). Execuções com falha aparecem em vermelho e com estado Falhada; abra a execução para ler a mensagem de erro no resultado.

O cliente pagou mas a cobrança continua aberta. Qual tarefa resolve?

Para boleto registrado, a tarefa de Processar retorno dá a baixa ao ler o arquivo do banco. Para pagamento por intermediário, a tarefa de Gateway. Até a próxima execução, a cobrança segue aberta; no detalhe da cobrança, o botão Verificar gateway checa na hora.

Qual tarefa envia o aviso de vencimento?

A tarefa Financeiro — Aviso de vencimento. Ela manda o lembrete por e-mail, SMS ou WhatsApp, conforme os dias configurados e o contato do cliente, antes, no dia ou depois do vencimento.

O que significa o "Tempo limite" da tarefa?

É o tempo máximo, em segundos, que a tarefa pode demorar antes de ser considerada travada. Se passar disso sem terminar, a execução aparece destacada no histórico. Quem ajusta esse valor é a equipe técnica.

Para quem vai o e-mail de erro de uma tarefa?

Para o endereço que estiver na coluna E-mail daquela tarefa, em Admin → Tarefas. Se estiver em branco, ninguém é avisado por e-mail — o erro só fica registrado no histórico.

A tarefa apareceu como Concluída, mas nada foi gerado. É erro?

Não necessariamente. Concluída significa que rodou sem erro; se não havia o que processar (carteira inativa, sem débitos, sem modelo), ela termina sem produzir nada. O resultado no histórico mostra o que aconteceu.

Qual tarefa gera as faturas das mensalidades?

A tarefa Contrato — Criar as Faturas gera, e a Contrato — Enviar email das faturas envia. Ambas exigem o módulo de faturas ligado. Detalhes em Fatura .

Como o carnê é montado e enviado automaticamente?

A tarefa Processar carnê gera as parcelas e a Envio carnê PDF monta o PDF e envia ao cliente por e-mail, com o link do boleto. A Alerta fim carnê avisa quando o carnê está acabando, para gerar o próximo a tempo.

A tarefa "Atualiza valor" cobra multa e juros do cliente?

Não. Ela apenas recalcula o valor atualizado (original + multa + juros) das cobranças vencidas em aberto, conforme a carteira. Não envia mensagem nem dá baixa — só mantém o valor em dia para quando o cliente for pagar.

Como cobro automaticamente no cartão de crédito do cliente?

Pela tarefa Pagamento recorrente no cartão, que cobra as recorrências que vencem e baixa as aprovadas. A tarefa de Aviso de pagamento recorrente avisa o cliente antes. Ambas exigem a carteira de cartão recorrente configurada.

Tratei o erro de uma execução. Por que ela continua na lista?

Resolver a causa não muda o registro da execução. Depois de corrigir, abra a execução no histórico e use Marcar como resolvida para tirá-la das pendências.

Documentos relacionados

Cobranças — operar a cobrança no dia a dia: gerar, enviar, dar baixa, reabrir.
Fatura — como as faturas das mensalidades são geradas e enviadas.
Carnê — montar e enviar carnês aos clientes.
Regras de cobrança — carteira, multa, juros, desconto e meios de pagamento.
Gateway bancário — credenciais e configuração do intermediário de pagamento.
Renegociação — juntar cobranças vencidas em um novo parcelamento.
Administração — visão geral das telas administrativas, incluindo Tarefas.