Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Controle de Ponto e Refeitório > Com.senior.g5.rh.hr.feriados

Web service com.senior.g5.rh.hr.feriados

Tipo de execução

Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.

Autenticação

Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificado o tipo no parâmetro <encryption>, conforme seus valores possíveis.

WSDL

Portas

UsuarioFeriados

Este web service retorna a quantidade de feriados e dias não trabalhados contidos em um período. Considerando a escala do usuário/colaborador informado.

Necessita autenticação: Não

Situação de versão: Atual

Versão: 1

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:UsuarioFeriados>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <nomUsu>String</nomUsu>
        <datFim>String</datFim>
        <datIni>String</datIni>
      </parameters>
    </ser:UsuarioFeriados>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
nomUsu Obrigatório String Nome do usuário que será utilizado na busca da quantidade de feriados/dias não trabalhados.
O usuário deve ter um colaborador associado, e o colaborador deve possuir histórico de escala válido.
datFim Obrigatório DateTime Período final.

- Máscara: DD/MM/YYYY
datIni Obrigatório DateTime Período inicial.

- Máscara: DD/MM/YYYY

Resposta:

Observação

Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:UsuarioFeriadosResponse>
      <result>
        <nroFer>Integer</nroFer>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:UsuarioFeriadosResponse>
  </soapenv:Body>
</soapenv:Envelope>

Atributos da resposta:

Nome Preenchimento Tipo Descrição
erroExecucao Opcional String Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:
- Vazio ou nulo, indicando que a execução foi feita com sucesso;
- A mensagem do erro ocorrido no servidor.
nroFer Opcional Integer Número de feriados e dias não trabalhados entre o período inicial e final, de acordo com os horários da escala.

UsuarioProximoDiaUtil

Este web service retorna a quantidade de feriados e dias não trabalhados contidos em um período. Considerando a escala do usuário/colaborador informado.

Necessita autenticação: Não

Situação de versão: Atual

Versão: 1

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:UsuarioProximoDiaUtil>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <nomUsu>String</nomUsu>
        <diaInt>Integer</diaInt>
        <datIni>String</datIni>
      </parameters>
    </ser:UsuarioProximoDiaUtil>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
nomUsu Obrigatório String Nome do usuário que será utilizado na busca da quantidade de feriados/dias não trabalhados.
O usuário deve ter um colaborador associado, e o colaborador deve possuir histórico de escala válido.
diaInt Obrigatório Integer Intervalo de dias a ser considerado para realizar a contagem e retornar o próximo dia útil sem considerar feriados, sábados e domingos.
datIni Obrigatório DateTime Período inicial.

- Máscara: DD/MM/YYYY

Resposta:

Observação

Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:UsuarioProximoDiaUtilResponse>
      <result>
        <datUti>String</datUti>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:UsuarioProximoDiaUtilResponse>
  </soapenv:Body>
</soapenv:Envelope>

Atributos da resposta:

Nome Preenchimento Tipo Descrição
erroExecucao Opcional String Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:
- Vazio ou nulo, indicando que a execução foi feita com sucesso;
- A mensagem do erro ocorrido no servidor.
datUti Opcional DateTime Próximo dia útil a partir do período inicial considerando o intervalo informado.

Este artigo ajudou você?