O passo-a-passo abaixo exemplificam a utilização da rotina:

No módulo SIGAGPE:

• Cadastre um atendente na rotina "Funcionários".

      Figura 1 - Criação do Atendente de matricula "000005".

• Cadastre uma verba na rotina "Verbas (GPEA040)" .

       Figura 2 - Criação de verba.

No modulo SIGATEC:

• Por meio da rotina "Atendentes", faça a importação do mesmo, cadastrado no passo acima.

       Figura 3 - Importa o atendente desejado.

• Gerar um orçamento de serviços, adicione o tipo de beneficio e a verba editada anteriormente.

             A grid de benefícios fica localizada dentro dos itens de RH.

           Figura 4 - Verba no orçamento de serviço.

• Acessar o "Assistente de Contrato" gerar o contrato e torná-lo vigente. 

        Figura 5 - Contrato vigente.

• Fazer alocação dos atendentes no "Gestão de Escala"ou no "Gestão de Contratos".
• Acessar a rotina "Geração de Atendimentos de Ordens de Serviços" e gerar as OS para a agenda dos atendentes 

        Figura 6 - Gerando atendimento da O.S.

• Na Geração de Benefícios para RH, o sistema exibirá uma tela com os parâmetros:

       Figura 7 - Parâmetros para informar o beneficio.                        Figura 8 - Processo concluído.

Esta rotina possui 3 opções de saída, conforme o conteúdo do parâmetro MV_GSOUT

• Caso uma das opções de saída seja o Protheus, Apos completar as etapas acesse novamente o SIGAGPE e acesse a rotina "Lançamento Por Verba (GPEA590)" e localize a verba utilizada no processo:

      Figura 9 - Visão dos atendentes pertencentes a verba.

• Caso uma das opções de saída seja o Ponto de Entrada, a saída será definida nos pontos de Entrada conforme a operação

Inclusão: At351IBe

Exclusão :At35EIBe

• Caso um das opções de saída seja o Arquivo CSV, a saída será o arquivo At351[nOpcAuto][AAAAMMDDHHMMSS].csv, gravado no local definido no parâmetro  MV_GSRHDIR onde:

nOpcAuto - Operação onde: 3 - Inclusão (Não é gerado arquivo CSV na operação de Exclução)

AAAAMMDD - Data/Hora da geração do Arquivo

O campo "Verba de Pgt (ABP_VERBA)" é o código da verba cadastrada no SIGAGPE, que preenche os campos "Descrição" e "Tipo Verba" com os respectivos valores.

O "Valor" será utilizado no cálculo, onde é usado para fazer a divisão da verba, baseando-se nas ordens de serviço (atendimento). o valor considerado é o valor total do benefício.

A "QteMin" é a quantidade mínima necessária para o pagamento, ela será calculada de acordo com o "Tipo Verba" cadastrado, seja em dias, horas ou valor.

O cálculo é feito pela seguinte expressão :  Valor * Fator * Percentual

Onde o valor é passado no campo "Valor" na hora da geração do orçamento.

O fator é decidido no cadastro da verba. podendo ser em dias, horas ou valor, no SIGAGPE. Ele será a data ou hora final menos a inicial, o resultado dessa diferença é o fator.

Quando for do tipo Valor ou as datas finais e iniciais forem iguais, o fator será 1.

O Percentual é o dado digitado no cadastro da verba, ele deve ser fornecido em Porcentagem, no SIGAGPE.

Baseado no exemplo da utilização, segue o mesmo caso com ênfase no cálculo :

No caso demonstrado, os campos "Percentual" e "Tipo Verba" no SIGAGPE, e o campo "Valor", na geração do orçamento, foram inseridas as seguintes informações:

Durante o cálculo, o sistema verifica as entradas e saídas dos atendentes nas Ordens de Serviço:

Como o exemplo foi configurado para "Dias" a rotina consulta o dia de entrada e saída, como o atendente teve a pausa para almoço e retornou para o posto no mesmo dia, o fator é 1.

Fator = Dia Final(25/04/2019) - Dia Inicial(25/04/2019)

Percentual = 25/100

Afim de calculo com os números fica: 154,4 (Valor) * 1 (Fator) * 0,25(Percentual)

• Beneficio = 38,60. Esse será o valor a presentado na rotina "Por Verba(GPEA590)" Se configurada a integração RH Protheus

É possível utilizar a rotina "Geração de Benefícios" via API REST.

É necessário possuir o fonte TECM351.prw compilado no repositório. O caminho da API é o api/tec/v1/SMBenefitsToHR/ e a requisição é através de uma operação de POST.

A tabela abaixo indica quais propriedades do JSON no POST correspondem com quais parâmetros da rotina:

A propriedade "contracts" pode ser utilizada para listar quais contratos (CN9_NUMERO) devem ser considerados.

Exemplo 1 de requisição:

{
"contracts": ["TECC0700CT0025D"],
"startDate": "2019-05-01",
"endDate": "2019-06-01",
"payrollPeriod": "201905",
"paymentNumber": "01",
"operation": 1
}

Exemplo 2 de requisição:

{
"contractFrom": "TECC0700CT0025D",
"contractTo" : "TECC0700CT0025D",
"startDate": "2019-05-01",
"endDate": "2019-06-01",
"payrollPeriod": 201905,
"paymentNumber": 1,
"operation": 1
}