Í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:
- Gerar um orçamento de serviços.
- Acessar o "Assistente de Contrato" e gerar o contrato do orçamento
- Fazer alocação de atende no "Gestão de Escala" ou "Gestão de Contratos".
- 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 employeeFrom e employeeTo |
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:
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:
- Faça a Geração de Atendimento de Ordens de Serviços (TECA 900)
- 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. |