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.

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:

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:

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.

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.