Árvore de páginas

Índice

Objetivo

Permite incluir e excluir marcações no ponto eletrônico para os atendentes, baseando-se nos atendimentos de Ordens de Serviços.

Os atendimentos gerados são enviados para o módulo de Ponto Eletrônico. 

 

Nota

É importante considerar que as informações deste relatório dependem de pré-condições cadastradas nas seguintes rotinas:

  • Funcionários
  • Atendentes.
  • Ordem de Serviço.
  • Atendimento da Ordem de Serviço.
  • Períodos de Apontamento no módulo SIGAPON.


Mapa Mental

Conheça neste diagrama as informações que contemplam as funcionalidades da rotina: 

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

    1. Gerar um orçamento de serviços.
    2. Acessar o "Assistente de Contrato" e gerar o contrato do orçamento
    3. Fazer alocação de atende no "Gestão de Escala" ou "Gestão de Contratos".
    4. Utilizar a rotina "Geração de Atendimentos de Ordens de Serviços" para gerar as ordens de serviços para a agenda de trabalho dos atendentes.

             

              

                Figura 1 - Geração de O.S.

          5. Acessar a rotina de geração das marcações:

                    

                                       

                Figura 3 - Parâmetros da rotina.                                                                                 Figura 2 - Geração de marcações.

         

    Nota

    A partir da versão de 22/04/2020 10:27:23, essa rotina permitirá realizar o envio das marcações para várias filiais, ao mesmo tempo, ou alterar a filial de processamento, utilizando o campo Filial?

    Obs.: Caso a rotina esteja atualizada, o pergunte deverá ser criado, conforme orientações no documento técnico: DSERSGS-8326 DT Envio das marcações em modo multifilial. Se a opção não for criada, o comportamento da rotina permanece inalterado. 

    Figura 4 - Parâmetro para escolha de filial.

    Mobile

    Para a integração com mobile será possível a utilização do parâmetro MV_GSHRPON. Ele tem como valor padrão 2 (desativado).

    O parâmetro pega as informações do campo ABB_HRCHIN e ABB_HRCHOUT, que são preenchidos com a integração.

    Campo Descrição Tipo
    MV_GSHRPON

    Valor 1  : "SIM"

    Pega o campo de integração para preenchimento de horas.

    Valor Padrão 2 : "NÃO"

    Segue o padrão pega os campos de entrada e saída da ABB( ABB_HRINI e ABB_HRFIM).

    Carácter

    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, visualizar na rotina do SIGAPON "Marcações", selecione um atendente escolhido no 3° processo e observe as marcações geradas.

               

                Figura 4 - Visualização do atendente no SIGAPON.

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

    nOpcAuto - Operação onde: 3 - Inclusão; 5 - Exclusão

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

    É possível utilizar a rotina "Geração das Marcações" via API REST.

    É necessário possuir o fonte TECM910.prw compilado no repositório. O caminho da API é o api/tec/v1/SMTimeTrack/ 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
    employeeFrom MV_PAR01 texto Sim, se não possuir a propriedade employees.
    employeeTo MV_PAR02 texto Sim, se não possuir a propriedade employees.
    startDate MV_PAR03 texto, no formato YYYY-MM-DD Sim
    endDate MV_PAR04 texto, no formato YYYY-MM-DD Sim
    operation MV_PAR05

    numérico (1 ou 2)

    1 = Inclusão

    2 = Exclusão

    Sim
    keepShiftBreak MV_PAR06

    numérico (1 ou 2)

    1 = Sim

    2 = Não

    Sim
    employees
    array Sim, se não possuir as propriedades employeeFromemployeeTo

    A propriedade "employees" pode ser utilizada para listar quais atendentes (AB9_CODTEC) devem ser considerados.


    Exemplo 1 de requisição:

    {
    "employees": ["TEC01900000135","TEC01900000136","TEC01900000137"],
    "startDate": "2019-05-07",
    "endDate": "2019-05-08",
    "operation": 1,
    "keepShiftBreak": 1
    }


    Exemplo 2 de requisição:

    {
    "employeeFrom": "TEC01900000135",
    "employeeTo": "TEC01900000137",
    "startDate": "2019-05-07",
    "endDate": "2019-05-08",
    "operation": 1,
    "keepShiftBreak": 1
    }


    A API pode retornar status 200 - OK caso alguma marcação seja inclusa ou 400 caso nenhuma marcação seja processada. No retorno também existe uma propriedade "message" que exibe o mesmo retorno que seria exibido caso a rotina fosse executada via interface.

    {
    "message": "Foram processadas: 4 marcações de entrada e saída."
    }

    Saiba mais em:

    Web Services REST/Server

    Configuração REST do Protheus

    FWRestModel - API RESTful dos modelos de dados do Protheus

    A partir do dia 15/07/2019 será possível a utilização do parâmetro MV_GSGEROS. Ele tem como valor padrão "1" (ativo).

    Com a ativação do parametro MV_GSGEROS não será gerada Ordem de Serviço na Geração do Atendimento, e com isso a projeção da agenda(ABB) do atendente será a base para o envio das marcações para o ponto. Para tal, deverá ser criado o campo ABB_MPONTO, que será usado como base para o envio das marcações para o ponto. Apenas as agendas marcadas como atendidas através do processo de Confirmação de Atendimento serão enviadas para o ponto

    Maior informação sobre o outra parte do processo do parâmetro: Ordem de Serviço.

    Para criação do campo, ABB_MPONTO, deve respeitar:

     

     Figura 1 - Campo.     

      Figura 2 - Informações.           

     Figura 4 - Validações.


    Figura 5 - Uso.                                                                       

     Figura 6 - Módulo.                                                               


     Figura 7 - Regras de dependência. 


    Caso opte pelo preenchimento pelo X3:

    Campo

    Conteúdo

    X3_ARQUIVO

    ABB

    X3_CAMPO ABB_MPONTO
    X3_TIPO L
    X3_TAMANHO 1
    X3_DECIMAL 0
    X3_TITULO Marc. Ponto
    X3_DESCRIC Marcacao Ponto Eletronico
    X3_USADO €€€€€€€€€€€€€€ 
    X3_RELACAO .F.
    X3_NIVEL 1
    X3_RESERV þÀ
    X3_PROPRI U
    X3_BROWSE N
    X3_VISUAL V
    X3_CONTEXT R
    X3_ORTOGRA N
    X3_IDXFLD N
    X3_POSLGT 1
    X3_MODAL 2

    A partir do dia 15/07/2019 é possível aplicar hora extra no intervalo e ao enviar par ao ponto o mesmo é "eliminado" ficando assim o período completo sem o intervalo.

    Importante

    O processo só funcionará de fato, se a saída for exatamente a mesma hora da próxima entrada.

    Figura 1 - Mesa Operacional aplicação da Hora Extra.

    Realize o procedimento normal:

    1. Faça a Geração de Atendimento de Ordens de Serviços (TECA 900)
    2. Envie para o ponto o período desejado. 

    Visualize no ponto as marcações.

    Figura 2 - Visualização no ponto.

    Parâmetros


    Os parâmetros definem os filtros para fazer a geração somente do atendente desejado.  

    Campo:

    Descrição

    Atendente De ?

    Selecione o primeiro atendente para começar a marcação.

    Caso queria sem filtro, apenas deixe em branco. 

    Exemplo:                                           Exemplo:

    TEC01900000002                               

    Atendente Ate ?

    Selecione até qual o atendente processar.

    Caso queria sem filtro, preencha com a letra "Z".

    Exemplo:                                           Exemplo:

    TEC01900000015                               ZZZZZZZZZZZZZZ

    Data de Inicio De ? *

    Data inicial para a geração de marcação.

    *O inicio do período, tem que estar alinhado com a data cadastrado no parâmetro MV_PAPONTA.

    Exemplo:

    01/04/2019 

    Data de Fim Ate ? *

    Data final da geração de marcação.

    *O fim do período, tem que estar alinhado com o fim da data cadastrado no parâmetro MV_PAPONTA.

    Exemplo:

    30/04/2019 

    Processamento ?

    Qual o tipo de processo que será feito.

    1 - Inclusão

    2 - Exclusão 

    Mantem Intervalo Turnos ?

    Define se irá conter os atendimentos de ordens de serviço para gerar marcações em apenas uma entrada e uma saída.

    1 - Sim

    2 - Não

    Filial?

    Define para qual filial será realizado o processamento. Permite a seleção de várias filiais. Exemplos:

    Preenchimento: D MG 01; D MG 02 → Realiza a geração das marcações para as filiais D MG 01 e D MG 02

    Preenchimento: em branco → Realiza a geração das marcações para a filial logada. 

    Local De?

    Selecione o primeiro Local de Atendimento para começar a marcação.

    Caso queria sem filtro, apenas deixe em branco. 

    Exemplo:                                           Exemplo:

    00000001                               

    Local Até?

    Selecione até qual  Local de Atendimento processar.

    Caso queria sem filtro, preencha com a letra "Z".

    Exemplo:                                           Exemplo:

    00000009                               ZZZZZZZZZZZZZZ

    Processa Todas as Filiais ?   

    Define se a rotina deve executar em todas as filiais (conforme parâmetro MV_GSMSFIL) ou apenas nas filiais definidas no Pergunte de Filiais.

    Processa em MultiThread ?     

    Opção disponível apenas para Envio. Define se o processamento deve ser executado em multiplas threads.

    Quantidade de threads ?       

    Define quantas threads a rotina deve iniciar para o processamento. Verificar características do servidor antes de preencher este parâmetro.

    Aglutina marcações ?          

    Define se o sistema deve modificar o valor dos campos TDV_HRMEN e TDV_HRMAI de forma que todas as marcações para a mesma data de referência sejam preservadas no Ponto com a mesma data.

    Local do Arquivo de Log       Escolha um local para geração do arquivo de Log. Caso não seja informado será gravado no servidor.

    Conteúdos Relacionados