Web services do Gestão do Ponto
O Gestão do Ponto disponibiliza os seguintes web services:
Categoria | Descrição | Web service |
---|---|---|
Apuração | Processos Automáticos | gestaoponto.ServicoProcessoAutomatico |
Zerar Apuração | gestaoponto.ApuracaoWS | |
Recálculo da Apuração | gestaoponto.RecalculoApuracao | |
Assinatura de espelho do ponto | Enviar e-mail com pendências vencidas de assinatura | gestaoponto.AssinaturaEspelhoPontoWS |
Banco de horas | Relatório de conferência do banco de horas |
gestaoponto.ConferenciaBancoHoras Observação
O campo params desse web service deve ser informado em formato XML, com os dados do banco a ser conferido. Exemplo:
<?xml version="1.0" encoding="UTF-8"?>
<token>senior</token>
<params>
<response>
<params>
<codBhr>1</codBhr>
<datIni>31/01/2012</datIni>
<abrEmp>3</abrEmp>
<abrTip>1</abrTip>
<abrCad>3</abrCad>
<email>12345@senior.com.br</email>
</params>
</response>
</params>
|
Fechamento do banco de horas na integração | gestaoponto.ServicoFechamentoBH | |
Migração do banco de horas | gestaoponto.MigrarBancoHoras | |
Zerar saldo do banco de horas |
gestaoponto.ServicoZerarBH Observação
O campo params desse web service deve ser informado em formato XML, com os dados do banco a ser zerado. Exemplo:
<?xml version="1.0" encoding="UTF-8"?>
<response>
<params>
<numEmp>1</numEmp>
<tipCol>1</tipCol>
<numCad>1</numCad>
<codBhr>100</codBhr>
<data>02/07/2012</data>
<excLan>S</excLan>
<fecCon>S</fecCon>
</params>
</response>
|
|
Retornar eventos do banco de horas | gestaoponto.ServicoRetornarEventoBH | |
Antecipar abono | gestaoponto.ServicoAnteciparAbono | |
Anular débito | gestaoponto.ServicoAnularDebito | |
Calcular banco de horas | gestaoponto.CalcularBancoHoras | |
Antecipar desconto | gestaoponto.AnteciparDesconto | |
Incidentes | Enviar e-mail de pendências para o gestor | gestaoponto.IncidenteWS |
Pendências de acerto | Notificação de pendências de acerto para colaboradores | gestaoponto.NotificacaoPendenciasAcerto |
Notificação de pendências de acerto para gestores | gestaoponto.NotificacaoGestoresPonto | |
Diversos | Limpeza de cache do sistema | gestaoponto.ClearCacheRondaWs |
Configuração
Todos os web services do Gestão do Ponto podem ser agendados através de regras customizadas, a partir do Gestão de Pessoas | HCM. Isso é possível depois de serem devidamente importados e configurados no Editor de web services, dentro de um servidor de terceiro que aponte para a URL de servidor do Gestão do Ponto.
Para realizar essas configurações, acompanhe os passos a seguir:
- No Editor de web services, acesse a janela Adicionar provedor de serviços, através do menu Arquivo > Provedor > Adicionar.
- Configure o Provedor como demonstra a imagem abaixo, substituindo apenas as informações no campo URL do servidor (URL e porta).
O nome informado no campo Nome do provedor deve ser o mesmo que foi dado para o contexto do Gestão do Ponto durante a sua instalação. - Depois de inserir as informações, clique em Ok e, de volta no Editor de web services, selecione o provedor criado.
- Acesse a janela Importar serviços, através do menu Arquivo > Importar.
- Em Arquivo de origem, selecione o arquivo "provedorGestaoPonto.ssf", disponível para download diretamente pelo link: provedorGestaoPonto.ssf.
- Clique no botão Executar.
- Depois da execução, os web services importados já aparecem na janela, semelhante à imagem abaixo:
Importante:
Caso utilizar web services do sistema de forma customizada é recomendável, após a atualização do sistema, reimportar o arquivo provedorGestaoPonto.ssf.
Configurar web services internos
Para agendar a execução, é necessário criar uma regra que executa o web service. Este deve ser criado no editor de regras com um código semelhante à regra abaixo:
@ Agendamento para notificar email – Colaborador @
Definir GestaoPonto.gestaoponto.NotificacaoPendenciasAcerto.enviarEmail enviarEmail;
enviarEmail.token = "senior";
enviarEmail.executar();
@ Agendamento para notificar email – Gestor @
Definir GestaoPonto.gestaoponto.NotificacaoGestoresPonto.enviarEmail enviarEmailGes;
enviarEmailGes.token = "senior";
enviarEmailGes.executar();
O web service da Senior vai chamar o web service de terceiro. Dessa forma pode ser feito o agendamento através da tela de agendamento de serviços. Além disso, habilite o agendador de processos automáticos em Central de Configurações Senior > Middleware > Web 5.0 > Processos Automáticos.
Para os web services de envio de e-mail é necessário configurar o envio de e-mail conforme o ambiente existente. Esta configuração é realizada em Central de Configurações > Conexões de rede > Envio de e-mail.
Importante
- O token não é sempre senior, mas sim, o token que está configurado no SeniorConfigCenter (Sistemas > Gestão de Pessoas > Gestão do Ponto) no campo Usuário para processos batch.
- Consulte mais informações sobre os web services na pós-instalação e sobre o e-mail de notificação de pendências de acerto do Gestão do Ponto.