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

Tipo de execução

Para cada tipo de execução, existem parâmetros específicos, alguns dos quais podem ser comuns a todas as portas de web service.

Autenticação

Quando for utilizada alguma forma de autenticação na integração de informações por meio de web services, é necessário informar o tipo correspondente no parâmetro <encryption>, conforme os valores possíveis.

WSDL

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

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:

Nota

O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, 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.

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

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:

Nota

<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.

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.

PORTAL DE DOCUMENTAÇÃO
Gestão de Pessoas \| HCM - versão 6.10.4