RH - Linha Protheus - GPE - eSocial - S-2206/S-2230 - Como Configurar o Job Schedule GPEM026B no Protheus
05/11/26, 16:00
Na Linha Protheus RH, o job schedule GPEM026B automatiza a integração com o TAF de eventos não periódicos do eSocial, como alteração de contrato ou salário (S-2206) e término de afastamento temporário com data futura (S-2230). Este conteúdo apresenta o passo a passo da configuração no SIGACFG, desde as validações iniciais, como os parâmetros MV_DTALTSA e MV_DTCGINI, até a ativação do Agent, a definição dos escopos de execução (alteração salarial, afastamentos, sindical, convocação, dependentes, turno e função) e o agendamento da recorrência. Também mostra como acompanhar a execução pelo monitor de agendamentos e pelo CONSOLE.LOG, além de pontos de atenção para evitar reprocessamentos e falhas de entrega ao TAF. Ideal para analistas e equipes de RH e TI que precisam garantir a transmissão correta dos eventos ao eSocial.
Antes de iniciar a configuração do job schedule GPEM026B, é necessário realizar as seguintes validações:
Para que o evento S-2206 seja gerado com a tag utilizando a data da alteração salarial (R3_DATA), o parâmetro MV_DTALTSA deve estar configurado como falso. Consulte o documento específico: RH - Linha Protheus - GPE - eSocial - S-2206 - Como utilizar o parâmetro MV_DTALTSA.
Sempre que houver integração com o TAF, os eventos S-2206/S-2306 (Alteração de contrato ou salário) e S-2230 (Término de afastamento temporário com data futura) terão o campo de integração com o TAF preenchido. Caso não exista informação de integração com o TAF no SIGAGPE, a execução do job schedule realizará essa integração, mesmo que as informações já estejam disponíveis no SIGATAF e/ou no eSocial. Exemplo: se no histórico de salário o campo "Integ. TAF (R3_INTGTAF)" estiver vazio, ao executar o job schedule a informação será integrada e o campo "Integ. TAF (R3_INTGTAF)" será preenchido.
Para configurar o job schedule, realize os procedimentos abaixo:
O sistema verificará o conteúdo do parâmetro MV_DTCGINI, que deve conter a data oficial a partir da qual a empresa iniciou a entrega dos eventos não periódicos (2ª fase). Em caso de dúvidas sobre as datas oficiais, consulte o cronograma de implantação. Atenção: a data do parâmetro pode variar conforme o grupo de empresas, ou seja, os eventos não periódicos serão enviados a partir da data informada no parâmetro.
Abra o SIGACFG para a configuração da rotina. Caminho: Ambiente > Schedule > Schedule. Verifique se o status do schedule encontra-se iniciado:
Configure o Agent e verifique o status dele — os Agents são os responsáveis por executar as funções:
Se o IP/PORTA não estiver ativo ou liberado, o job será iniciado, porém não levará o evento para o TAF. Para confirmar se o job está funcionando corretamente, acesse o arquivo CONSOLE.
LOG localizado na pasta appserver e procure pelos textos "Starting Job" ou "Alert info". Para saber como gerar o CONSOLE.
LOG para análise do suporte, consulte o documento específico: Como gerar o Console.log para análise do Suporte?
O status do Agent deve estar como iniciado:
4. Configure o agendamento de acordo com a necessidade da empresa:
Se a execução não devolver alguma informação, é possível desabilitar a integração. Para isso, informe o parâmetro como falso no cadastro do Job, respeitando a ordem dos campos:
lAltSal - indica se a rotina de alteração salarial deve ou não ser executada
lAfast - indica se a rotina de afastamentos deve ou não ser executada
lAltSindica - indica se a rotina de alteração sindical deve ou não ser executada
lConvoca - indica se a rotina de locais de convocação deve ou não ser executada
lAltDep - indica se a rotina de alteração de dependentes deve ou não ser executada
lAltTurno - indica se a rotina de troca de turno deve ou não ser executada
lFunCargo - indica se a rotina de alteração contratual por atualização de função deve ou não ser executada
Para quem já utiliza o job GPEM026B(), essa nova execução vem desabilitada por padrão (False), sendo necessário habilitá-la. Para isso, no cadastro do Schedule no módulo Configurador, informe o sétimo parâmetro como True (verdadeiro), da seguinte forma: GPEM026B(.F.,.F.,.F.,.F.,.F.,.F.,.T.)
Como gerar o S-2206 para alteração de CBO via job:
Exemplo: GPEM026B(.T.,.F.,.F.,.F.,.F.,.F.,.F.)
No exemplo acima, o primeiro campo foi parametrizado como "True" para integrar somente as alterações salariais, e as demais informações de alteração ficaram como False para não serem integradas.
Após essa configuração, informe a recorrência em que a rotina será iniciada:
5. No monitor de agendamentos é possível visualizar algumas informações da execução da rotina:
 | Dica do especialistaA configuração é simples; o risco está na ordem. Habilite um escopo por vez — comece pela alteração salarial e valide um ciclo antes de liberar afastamento, sindical, convocação, dependentes e turno. Confira o MV_DTCGINI, porque o job só transmite a partir daquela data, que muda por grupo de empresa. E antes de rodar, levante os registros com o R3_INTGTAF vazio: o job reprocessa esse volume mesmo que o dado já exista no TAF e no eSocial, e é aí que nasce a duplicidade. Por fim, garanta Agent ativo e IP/PORTA liberados — sem isso o job roda e não entrega nada, e o sintoma só aparece no CONSOLE. |