Agendador de Cálculos de Folha de Pagamento

Módulo: Pessoal+
Versão Mínima: 5.126
Caminho de Acesso: Pessoal+ > Rotinas Folha
ID da Tela: br.com.sankhya.mgepes.CalculoFolhaAgendador

Sumário

1. O que é o Agendador
2. Antes de começar
3. Como o agendamento funciona
4. Conhecendo a tela
5. Como criar um agendamento
6. Como o sistema define a data de pagamento
7. Alterar, pausar, duplicar e excluir
8. Conferir o resultado da execução
9. Exemplos práticos
10. Solução de Problemas
11. Perguntas Frequentes

1. O que é o Agendador

O Agendador de Cálculos de Folha programa o cálculo da folha Mensal ou do Adiantamento para ser executado automaticamente nos dias e horários que você definir, para uma ou mais empresas.

Com ele, você não precisa lembrar de disparar o cálculo todo mês. 

Por exemplo: 

• calcular o Adiantamento todo dia 15, às 7h;

• calcular a folha Mensal todo dia 23, às 18h;

• programar mais de um horário para o mesmo dia, para que colaboradores que ainda estejam pendentes sejam calculados em uma nova execução.

O que a tela guarda:

Para cada agendamento, o sistema mantém:

• a programação, com meses, dias e horários de execução;
• as configurações do cálculo, como tipo de folha, data de pagamento e empresas;
• o resultado de cada execução, com a quantidade de folhas calculadas e as que apresentaram erro;
• o log de alterações, com o histórico das alterações realizadas no agendamento.

2. Antes de começar

Antes de utilizar o Agendador, verifique:

Permissões:

• se você tem acesso à tela Agendador de Cálculos Folha de pagamento (Pessoal+ > Rotinas Folha). Essa liberação é feita na tela Acessos (Configurações > Controle de Acesso), pelo administrador do sistema.

Parâmetros: 

Se você não tiver acesso aos parâmetros, solicite a configuração ao administrador do sistema.

Configurações prévias:

• Referência aberta da empresa 

  O Agendador calcula a empresa somente quando a referência aberta no DP corresponde ao mês atual no momento da execução.

• Cadastro de feriados

  Quando a data de pagamento cai em um feriado, o sistema antecipa o pagamento para um dia útil anterior. Para que isso aconteça corretamente, os feriados precisam estar cadastrados na tela Feriados (Pessoal+> Cadastros).

• Cidade da empresa

  Os feriados são aplicados conforme a cidade informada no cadastro da Empresa (Configurações > Cadastros).

3. Como o agendamento funciona

Antes de criar o primeiro agendamento, é importante entender algumas regras. Elas ajudam a identificar por que uma empresa ou funcionário pode não ter sido calculado.

• O Agendador calcula somente quem está pendente

  A cada execução, o sistema calcula apenas os funcionários que ainda não possuem cálculo naquele tipo de folha e naquela competência.

  Isso significa que:

  • colaboradores que já foram calculados não são recalculados;
  • alterações feitas depois do cálculo não são aplicadas automaticamente aos colaboradores que já foram calculados;
  • uma nova execução pode calcular colaboradores que ficaram pendentes desde a execução anterior, como uma admissão lançada posteriormente.

  ⚠️ Atenção O Agendador não substitui o recálculo manual. Se você alterar um evento, uma regra da CCT, um reajuste ou outra informação que exija o recálculo de funcionários já calculados, utilize a rotina de cálculo manual da folha.

• Quem entra no cálculo

  São considerados:

  • funcionários ativos da empresa;
  • funcionários admitidos até o último dia do mês da competência;
  • funcionários que ainda não possuem cálculo para o tipo de folha agendado;
  • funcionários transferidos, quando a transferência ocorre posteriormente à referência.

• Qual competência será calculada

  A competência é sempre o mês atual no momento da execução.

  A empresa só será calculada se a referência aberta no DP for o mês atual. Se a referência da empresa estiver em outro mês, ela será ignorada, sem nenhuma mensagem de erro.

  Exemplo:

  Se o Agendador executar em 3 de outubro, mas a referência aberta da empresa ainda for setembro, a empresa não será calculada.

  Se a folha de setembro já estiver fechada e a referência tiver avançado para outubro, uma execução em outubro calculará outubro, e não setembro.

• Quando o cálculo é executado

  O sistema verifica os agendamentos a cada minuto.

  Quando encontra um agendamento ativo cuja Próxima execução em seja igual ou anterior ao horário atual, o cálculo é disparado.

  Depois de cada execução, mesmo que ocorra erro, o sistema calcula a próxima execução de acordo com a frequência configurada.

  Até 5 agendamentos podem ser executados simultaneamente. Os demais aguardam na fila.

  Se o servidor estiver indisponível no horário programado: o cálculo será executado no primeiro minuto após o retorno do servidor.

• Quando nenhuma empresa é selecionada

  Se nenhuma empresa for adicionada ao agendamento, o cálculo será realizado para todas as empresas com cadastro ativo na folha.

  🚨 Risco operacional Em bases com muitas empresas, essa configuração pode iniciar um cálculo grande e incluir empresas que não deveriam fazer parte daquela programação. Sempre que possível, selecione as empresas que devem ser calculadas.

4. Conhecendo a tela

Listagem (grade)

Ao abrir a tela, os agendamentos aparecem em uma grade. Para abrir um agendamento, dê duplo clique sobre a linha.

Barra de ferramentas

Durante a edição, ficam disponíveis os botões Salvar [F7] e Descartar.

Cabeçalho

O cabeçalho fica disponível acima das abas.

Abas

5. Como criar um agendamento

1. Clique em + Cadastrar Agendamento Tarefa.
2. No cabeçalho:
   • preencha a Descrição agendamento;
   • ative a chave Ativo.
3. Na aba Frequência Agendamento:
   • informe o horário da 1ª execução;
   • selecione os meses ou Todos;
   • escolha a periodicidade: Diário, Semanal ou Mensal;
   • marque os dias correspondentes.
4. Na aba Configurações:
   • selecione o Tipo Folha;
   • selecione a Sugestão de data de pagamento;
   • informe o Dia do pagamento, quando necessário;
   • clique em Adicionar e selecione as empresas. Se não selecionar nenhuma, o cálculo roda para todas as empresas ativas.

5. Clique em Salvar [F7]. 

   Você não precisa preencher a Próxima execução em (aba Horários). O sistema calcula esse campo automaticamente com base na frequência configurada.

6. Depois do horário programado, acesse a aba Resumo para conferir o resultado da execução.

Se não for possível salvar

Algumas mensagens indicam problemas específicos:

• “Já existe um agendamento ativo...”

  Já existe um agendamento ativo para a mesma empresa e tipo de folha. Ajuste o agendamento existente ou verifique se ele deve ser excluído antes de criar outro.

• “Dia do pagamento inválido para a referência selecionada.”

  O dia informado não é válido para a combinação de tipo de folha e sugestão de pagamento selecionada.

6. Como o sistema define a data de pagamento

A data de pagamento é definida a partir de:

• Tipo Folha;
• Sugestão de data de pagamento;
• Dia do pagamento.

Combinações disponíveis

Até o 5º dia útil — folha Mensal

O pagamento acontece no mês seguinte à competência. 

O Dia do pagamento é opcional:

Exemplo: para uma competência de setembro de 2026:

• sem informar o dia: pagamento no 5º dia útil de outubro;
• informar 3: pagamento no 3º dia útil;
• informar 5: pagamento no 5º dia útil;
• informar 7: pagamento no 5º dia útil, porque 5 é menor que 7.

Dentro do mês — Mensal e Adiantamento

O pagamento acontece no mesmo mês da competência. 

Antecipação da data

Quando necessário, o sistema aplica os ajustes nesta ordem:

1. Se o dia informado não existir no mês, aplica a regra correspondente a 29, 30 ou 31.
2. Se a data cair em um fim de semana, antecipa para a sexta-feira anterior.
3. Se a data cair em um feriado, antecipa para o primeiro dia útil anterior.

O resultado final é sempre um dia útil.

7. Como gerenciar os agendamentos

Alterar

1. Abra o agendamento.
2. Altere as informações necessárias.
3. Clique em Salvar [F7].

A alteração será considerada na próxima execução e ficará registrada no Log de alterações.

Desativar

Para interromper temporariamente o cálculo automático:

1. Abra o agendamento.
2. Desligue a chave Ativo.
3. Salve.

As configurações permanecem salvas e podem ser reutilizadas quando o agendamento for ativado novamente.

Duplicar

Use Duplicar quando quiser reaproveitar uma configuração existente.

1. Abra o agendamento que deseja copiar.
2. Clique em Duplicar.
3. Altere a Descrição agendamento.
4. Ajuste a Empresa ou o Tipo Folha, conforme necessário.
5. Salve.

Se a cópia mantiver a mesma empresa e o mesmo tipo de folha de um agendamento ativo existente, o sistema poderá impedir o salvamento.

Excluir

Para excluir um agendamento:

1. Selecione o agendamento na grade.
2. Clique em Lixeira.

8. Como conferir o resultado

Depois que o agendamento executar, consulte a aba Resumo.

Depois de cada execução, abra a aba Resumo:

Também é possível consultar o detalhamento por Cód. Empresa e Qtd Funcionários.

Como referência para a conferência:

Qtd Folhas Carregadas = Qtd Folhas Calculadas e Qtd Folhas Cálculo Erro = 0 indicam que não houve funcionários com erro nessa execução.

Quando o Resumo fica vazio

O Resumo recebe uma linha quando o cálculo chega a ser iniciado.

Ele pode permanecer vazio, mesmo com o status Finalizado, quando:

• a referência aberta da empresa não corresponde ao mês atual;
• não havia funcionários pendentes;
• o parâmetro FPCALCFOLASYNC estava desligado.

Log de alterações

O log permite verificar:

• número do log;
• data e hora da alteração;
• campo alterado;
• valor anterior;
• novo valor;
• usuário responsável pela alteração.

São registrados, entre outros, os seguintes campos:

• dias do mês;
• meses;
• dias da semana;
• sugestão de data de pagamento;
• dia do pagamento;
• empresas;
• Ativo;
• horários de execução.

Não são registrados:

• a criação do agendamento;
• alterações na descrição;
• alterações no tipo de folha;
• alterações na próxima execução.

Os campos podem aparecer com seus nomes técnicos. Por exemplo:

• MODOPAGAMENTO;
• DIAEXECUCAO.

As empresas são apresentadas pelos códigos separados por vírgula, como 1,22.

9. Exemplos práticos

10. Solução de Problemas

• Agendei, mas não calculou

  Confira, nesta ordem:

  1. O agendamento está Ativo?
  2. O parâmetro FPCALCFOLASYNC está habilitado?
  3. A referência aberta da empresa corresponde ao mês atual?
  4. Existem funcionários sem cálculo para aquele tipo de folha?
  5. O mês, o dia e o horário configurados correspondem à data esperada?
  6. A Próxima execução em apresenta a data esperada?

• Calculou somente alguns funcionários

  Isso pode acontecer porque o Agendador calcula somente funcionários que ainda não possuem cálculo.

  Confira também a Qtd Folhas Cálculo Erro no Resumo. Funcionários com erro precisam ser analisados e, se necessário, calculados manualmente.

• Uma das empresas não foi calculada

  Confira a referência aberta dessa empresa.

  Se ela não corresponder ao mês atual, a empresa será ignorada sem mensagem de erro.

• O status está Finalizado, mas o Resumo está vazio

  Confira:

  • a referência aberta da empresa;
  • se havia funcionários pendentes;
  • se o parâmetro FPCALCFOLASYNC estava habilitado.

• A próxima execução está com uma data que já passou

  O sistema verifica os agendamentos a cada minuto e recalcula a próxima execução após cada processamento.

  Se a data permanecer no passado, pode haver um problema no serviço responsável pelo agendamento. Nesse caso, acione o suporte ou o administrador do servidor.

• Já existe um agendamento ativo para a empresa e tipo de folha

  Verifique se já existe um agendamento ativo para a combinação de empresa + tipo de folha.

  ⚠️ Atenção A trava não cobre todos os cenários de múltiplas empresas. Ela compara somente a primeira empresa da lista do agendamento que está sendo salvo e não é aplicada quando a lista está vazia, ou seja, quando o agendamento considera todas as empresas. Nesses casos, confira a grade antes de criar uma nova programação.

• O dia do pagamento é inválido

  O valor informado não está dentro da faixa aceita para a combinação de Tipo Folha e Sugestão de data de pagamento.

  Consulte Como o sistema define a data de pagamento.

• A tela não aparece no menu

  Verifique se o parâmetro FPHABTELAGECALC está habilitado.

• O cálculo apresentou erro e ninguém foi avisado

  O Agendador não envia notificação nem e-mail.

  Crie o hábito de consultar a aba Resumo após as execuções programadas.

11. Perguntas Frequentes

1. Consigo executar o agendamento imediatamente, sem esperar o horário programado?

Não. A tela não possui a opção Executar agora. Para calcular a folha imediatamente, utilize a rotina de cálculo manual.

2. O Agendador recalcula funcionários que já foram calculados?

Não. O Agendador considera somente funcionários que ainda não possuem cálculo para o tipo de folha e a competência.

3. O agendamento calcula uma folha já fechada?

Não. Depois que a folha é fechada, a referência avança e a empresa deixa de corresponder à competência anterior.

4. Como faço para o cálculo automático parar de executar?

Desative a chave Ativo e salve o agendamento. As demais configurações serão mantidas.

5. Posso programar mais de um horário por dia?

Sim. Utilize o botão + na aba Frequência Agendamento para adicionar outros horários.

Cada execução adicional calcula somente os funcionários que ainda estiverem pendentes.

6. Se eu não selecionar empresa, o que acontece?

O cálculo roda para todas as empresas com cadastro ativo na folha.

7. Posso ter um agendamento de Mensal e outro de Adiantamento para a mesma empresa?

Sim. A combinação considerada para a trava é empresa + tipo de folha.

8. O que acontece se o servidor estiver indisponível no horário programado?

Quando o servidor voltar, o sistema verifica os agendamentos e executa o que estiver pendente no primeiro minuto disponível.

9. Agendamentos criados pela BIA aparecem aqui?

Sim. Quando não possuem descrição, aparecem como Agendamento feito pela BIA.

10. Por quanto tempo o Log de alterações fica guardado?

As informações do log são mantidas por 90 dias.