Índice
Objetivo
Enviar marcações de benefícios dos atendentes para o gestão de pessoal, baseando-se nos atendimentos de Ordens de Serviços.
O valor e suas respectivas informações podem ser acessadas no modulo Gestão de Pessoal.
Mapa Mental
Conheça neste diagrama as informações que contemplam as funcionalidades da rotina:
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.
Importante
Somente atendentes que estão com o campo AA1_ALOCA = Disponível serão considerados para o calculo de benefícios.
- 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
IMPORTANTE
Caso exista a mesma Verba, do tipo Valor em diferentes Locais ou Postos para o mesmo atendente, no mesmo período o sistema considera o primeiro valor referente ao primeiro Local/Posto.
É 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:
Propriedade |
Parâmetro |
Tipo |
Obrigatório |
---|---|---|---|
contractFrom | MV_PAR01 | texto | Sim, se não possuir a propriedade contracts. |
contractTo | MV_PAR02 | texto | Sim, se não possuir a propriedade contracts. |
startDate | MV_PAR03 | texto, no formato YYYY-MM-DD | Sim |
endDate | MV_PAR04 | texto, no formato YYYY-MM-DD | Sim |
payrollPeriod | MV_PAR05 | texto, no formato YYYYMM |
Sim |
paymentNumber | MV_PAR06 | numérico | Sim |
operation | MV_PAR08 | numérico (1 ou 2) 1 = Inclusão 2 = Exclusão |
Sim |
contracts | array | Sim, se não possuir as propriedades contractFrom e contractTo |
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
}
Parâmetros
Campo: | Descrição |
Contrato De ? | Selecione o primeiro contrato, considerado no momento do envio dos benefícios. Para realizar o envio dos benefícios para todos os contratos, deixar esse campo em branco. Exemplo: Exemplo: TECC0700CT00213 |
Contrato Até ? | Selecione o último contrato, considerado no momento do envio dos benefícios. Para realizar o envio dos benefícios para todos os contratos, preencher todas as posições co campo com a letra "Z" Exemplo: Exemplo: TECC0700CT00213 ZZZZZZZZZZZZZZZ |
Data Início De ? | Informe a data inicial. Exemplo: 01/04/2019 |
Data Fim Até ? | Informe a data final. Exemplo: 30/04/2020 |
Período da Folha ? | Indica qual o período da folha a ser utilizado para o envio dos benefícios. Deve ser o mesmo informado no processo associado a verba. Para editar acesse "Por Verba(GPEA590)" no SIGAGPE. Nota Cadastre o Processo por meio de "Processos (GPEA420)" e configure o período, número de pagamento e roteiro na rotina "Períodos (GPEA400)" Exemplo: 201511 |
Numero de Pagamento ? | Define qual a sequência de pagamento que o benefício será associado. Deve ser o mesmo informado no processo associado a verba. Exemplo: 01 |
Roteiro ? | Define em qual roteiro da folha serão associados os benefícios. Deve ser o mesmo informado no processo associado a verba. Exemplo: FOL |
Processamento | Qual o processo que ira ocorrer 1 - Inclusão 2 - Exclusão |
Conteúdos Relacionados
- Parâmetros/Configurações
- Gestão de Serviços
- Atendentes
- Oportunidade de venda
- Gestão de Contratos
- Gestão de Escala
- Geração de Atendimentos de Ordens de Serviços