Linha Microsiga Protheus

Árvore de páginas

Í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.

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

             

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

           

            Figura 5 - Contrato vigente.

           

            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