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 Nota
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 Nota
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 | Envia um e-mail aos gestores com as pendências de incidentes dos seus liderados, através de chamada via regra customizada. |
gestaoponto.IncidenteWS
É importante considerar que:
Exemplo de criação de regra
@ Agendamento para notificar incidentes – Gestor @Definir GestaoPonto. gestaoponto.IncidenteWS.enviarNotificacaoPendencias enviarEml;enviarEml.token = "Senior";enviarEml.executar(); Nota
|
| Pendências de acerto | Notificação de pendências de acerto para colaboradores |
gestaoponto.NotificacaoPendenciasAcerto Nota
Para mais informações, acesse o manual do Gestão de Pessoas, selecione a respectiva versão na seção Gestão de Pessoas | HCM e, através do menu (na lateral esquerda), acesse Informações adicionais > Informações técnicas > Gestão do Ponto > Customizações > E-mail de notificação de pendências de acerto. |
| Notificação de pendências de acerto para gestores |
gestaoponto.NotificacaoGestoresPonto Nota
Para mais informações, acesse o manual do Gestão de Pessoas, selecione a respectiva versão na seção Gestão de Pessoas | HCM e, através do menu (na lateral esquerda), acesse Informações adicionais > Informações técnicas > Gestão do Ponto > Customizações > E-mail de notificação de pendências de acerto. |
|
| 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.
English
Español
