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

Web service com.senior.g5.rh.fp.feriasColetivas

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

Portas

Calcular

Web service de Férias Coletivas

**Necessita autenticação: **Sim

**Situação de versão: ** Atual

**Versão: **1

**Requisição: **

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

diaInv

Opcional

Set

Desconsiderar.

DiaInv.Invalidos

Opcional

DateTime

Dias das férias coletivas, que não devem ser considerados.



  • Máscara: DD/MM/YYYY

numEmp

Obrigatório

Integer

Código da empresa que será utilizada no processo.



  • Máscara: 9999

diaAbo

Opcional

Integer

Número de dias de abono de férias a serem quitados junto ao recibo das férias coletivas.



  • Máscara: ZZ9,99


Este parâmetro só pode ser informado se o parâmetro ConPro for igual a “N”.


Caso este parâmetro não seja informado, o sistema utilizará o valor 0,00.

calHfe

Opcional

String

Gerar adiantamento de horas de férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S”.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

gruEmp

Opcional

Integer

Abrangência: Código de grupo de empresas.



  • Máscara: 999

codCal

Obrigatório

Integer

Código de cálculo que será usado no cálculo.



  • Máscara: 9999

opc13s

Opcional

String

Pagar adiantamento de 13º salário junto com as férias coletivas.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro ConPro for igual a “N” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “N”.

calAdf

Opcional

String

Gerar adiantamento de adicionais de férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S”.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

codLot

Opcional

Integer

Abrangência: Código de lote de colaboradores.



  • Máscara: 9999

conPro

Obrigatório

String

Calcular somente os colaboradores que possuírem programação de férias dentro do período indicado.



  • Máscara: U


Valores:


“S” - Sim.


“N” - Não.



Caso este parâmetro não seja informado, o sistema utilizará o valor “N”.

gerAdt

Opcional

String

Valores do recibo de férias devem ser adiantados no recibo ou não.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro ConPro for igual a “N” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

calTfe

Opcional

String

Gerar adiantamento de 1/3 das férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S”.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

lotExc

Opcional

Integer

Abrangência: Código de lote de exceções de colaboradores.



  • Máscara: 9999

iniFer

Obrigatório

DateTime

Data de início das férias coletivas.



  • Máscara: DD/MM/YYYY

mulDob

Opcional

String

Em caso de vencimento do segundo período de férias, pagar a multa do dobro das férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

calAbo

Opcional

String

Gerar adiantamento de horas de abono.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o parâmetro DiaAbo for maior que 0,00.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

abrEmp

Opcional

String

Abrangência: Empresa (+).



  • Máscara: A[200]

fimFer

Opcional

DateTime

Último dia de paralização das férias coletivas.



  • Máscara: DD/MM/YYYY


Caso este parâmetro não seja informado, o sistema utilizará o valor “00/00/0000”.

datPag

Opcional

DateTime

Data em que será efetuado o pagamento das férias coletivas.



  • Máscara: DD/MM/YYYY


Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor de 3 dias antes do valor informado no parâmetro IniFer.



Para as férias coletivas, o sistema sugere uma data com base nestas condições:

  • Por padrão, a data sugerida será dois dias antes do início das férias dos colaboradores.
  • Se houver programação de férias, a data sugerida será dois dias antes da data programada para início das férias.
  • Se não houver adiantamento de férias, a data sugerida será três dias antes do início das férias.

Para as coletivas, o sistema não verifica se a data sugerida é um sábado, domingo ou feriado, mantendo a sugestão mesmo que caia em um destes dias. Neste caso, é necessário alterar a data manualmente.

calAAb

Opcional

String

Gerar adiantamento de adicionais de abono.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o parâmetro DiaAbo for maior que 0,00.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

abrTcl

Opcional

String

Abrangência: Tipo de Colaborador (+).



  • Máscara: A[100]

pctAdt

Opcional

Double

Percentual do adiantamento de férias, diferente do cálculo normal de adiantamento de férias.



  • Máscara: Z9,99


Este parâmetro só pode ser informado se os parâmetros GerAdt, CalHfe, CalAdf, CalTFe, CalAbo, CalAAb, CalTAb forem igual a “S” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor 0,00 e calculará o adiantamento normal de férias.

calTAb

Opcional

String

Gerar adiantamento de 1/3 do abono.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o parâmetro DiaAbo for maior que 0,00.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

abrCad

Opcional

String

Abrangência: Colaborador (+).



  • Máscara: A[200]

prvDes

Opcional

Double

Percentual que será abatido no total das férias que será adiantado.



  • Máscara: Z9,99


Este parâmetro só pode ser informado se os parâmetros GerAdt, CalHfe, CalAdf, CalTFe, CalAbo, CalAAb, CalTAb forem igual a “S” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor 0,00.

abrFil

Opcional

String

Abrangência: Filial (+).



  • Máscara: A[200]

gerNeg

Opcional

String

Gerar Negativa de Férias



  • Máscara: U


Valores:


“S” - Sim. Gerar férias coletivas, mesmo que os dias de saldo do período aquisitivo, sejam inferiores ao número de dias das coletivas, deixando o período com saldo negativo.


“N” - Não. Gerar as férias coletivas com os dias de saldo existentes, complementando o restante como licença remunerada na folha mensal.


“A” - Abonados Abono. Gerar as férias coletivas, com os dias de saldo existentes, jogando o restante para o próximo período como Dias Abonados.



Este parâmetro não deve ser informado se o país ativo for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

abrLoc

Opcional

String

Abrangência: Local (”+”).



  • Máscara: A[200]

admSsd

Opcional

String

Procedimento com os admitidos que tem menos de um ano de serviço.



  • Máscara: U


Valores:


“S” - Período c/ Saldo Negativo


“N” - Licença Remunerada Folha


“Q” - Quita p/ Direito = Dias Férias


“E” - Encerra Período Independente do Saldo



Este parâmetro não deve ser informado se o país ativo for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

abrSin

Opcional

String

Abrangência: Sindicato (+).



  • Máscara: A[200]

abrTco

Opcional

String

Abrangência: Tipo de Contrato (+).



  • Máscara: A[100]

abrCar

Opcional

String

Abrangência: Cargo (”+”).



  • Máscara: A[200]

abrCCu

Opcional

String

Abrangência: Centro de Custo (”+”).



  • Máscara: A[200]

abrEsc

Opcional

String

Abrangência: Escala (+).



  • Máscara: A[200]

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:CalcularResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:CalcularResponse>
</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.

Escalonar

Web service de Férias Coletivas Escalonado

**Necessita autenticação: **Sim

**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:Escalonar>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<diaInv>
<invalidos>String</invalidos>
</diaInv>
<numEmp>Integer</numEmp>
<diaAbo>Integer</diaAbo>
<calHfe>String</calHfe>
<gruEmp>Integer</gruEmp>
<codCal>Integer</codCal>
<opc13s>String</opc13s>
<calAdf>String</calAdf>
<codLot>Integer</codLot>
<conPro>String</conPro>
<gerAdt>String</gerAdt>
<calTfe>String</calTfe>
<lotExc>Integer</lotExc>
<iniFer>String</iniFer>
<mulDob>String</mulDob>
<calAbo>String</calAbo>
<abrEmp>String</abrEmp>
<fimFer>String</fimFer>
<datPag>String</datPag>
<calAAb>String</calAAb>
<abrTcl>String</abrTcl>
<pctAdt>Double</pctAdt>
<calTAb>String</calTAb>
<abrCad>String</abrCad>
<prvDes>Double</prvDes>
<abrFil>String</abrFil>
<gerNeg>String</gerNeg>
<abrLoc>String</abrLoc>
<admSsd>String</admSsd>
<abrSin>String</abrSin>
<abrTco>String</abrTco>
<abrCar>String</abrCar>
<abrCCu>String</abrCCu>
<abrEsc>String</abrEsc>
</parameters>
</ser:Escalonar>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

diaInv

Opcional

Set

Desconsiderar.

diaInv.invalidos

Opcional

DateTime

numEmp

Obrigatório

Integer

Código da empresa que será utilizada no processo.



  • Máscara: 9999

diaAbo

Opcional

Integer

Número de dias de abono de férias a serem quitados junto ao recibo das férias coletivas.



  • Máscara: ZZ9,99


Este parâmetro só pode ser informado se o parâmetro ConPro for igual a “N”.


Caso este parâmetro não seja informado, o sistema utilizará o valor 0,00.

calHfe

Opcional

String

Gerar adiantamento de horas de férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S”.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

gruEmp

Opcional

Integer

Abrangência: Código de grupo de empresas.



  • Máscara: 999

codCal

Obrigatório

Integer

Código de cálculo que será usado no cálculo.



  • Máscara: 9999

opc13s

Opcional

String

Pagar adiantamento de 13º salário junto com as férias coletivas.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro ConPro for igual a “N” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “N”.

calAdf

Opcional

String

Gerar adiantamento de adicionais de férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S”.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

codLot

Opcional

Integer

Abrangência: Código de lote de colaboradores.



  • Máscara: 9999

conPro

Obrigatório

String

Calcular somente os colaboradores que possuírem programação de férias dentro do período indicado.



  • Máscara: U


Valores:


“S” - Sim.


“N” - Não.



Caso este parâmetro não seja informado, o sistema utilizará o valor “N”.

gerAdt

Opcional

String

Valores do recibo de férias devem ser adiantados no recibo ou não.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro ConPro for igual a “N” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

calTfe

Opcional

String

Gerar adiantamento de 1/3 das férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S”.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

lotExc

Opcional

Integer

Abrangência: Código de lote de exceções de colaboradores.



  • Máscara: 9999

iniFer

Obrigatório

DateTime

Data de início das férias coletivas.



  • Máscara: DD/MM/YYYY

mulDob

Opcional

String

Em caso de vencimento do segundo período de férias, pagar a multa do dobro das férias.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

calAbo

Opcional

String

Gerar adiantamento de horas de abono.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o parâmetro DiaAbo for maior que 0,00.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

abrEmp

Opcional

String

Abrangência: Empresa (+).



  • Máscara: A[200]

fimFer

Opcional

DateTime

Último dia de paralização das férias coletivas.



  • Máscara: DD/MM/YYYY


Caso este parâmetro não seja informado, o sistema utilizará o valor “00/00/0000”.

datPag

Opcional

DateTime

Data em que será efetuado o pagamento das férias coletivas.



  • Máscara: DD/MM/YYYY


Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor de 3 dias antes do valor informado no parâmetro IniFer.

calAAb

Opcional

String

Gerar adiantamento de adicionais de abono.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o parâmetro DiaAbo for maior que 0,00.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

abrTcl

Opcional

String

Abrangência: Tipo de Colaborador (+).



  • Máscara: A[100]

pctAdt

Opcional

Double

Percentual do adiantamento de férias, diferente do cálculo normal de adiantamento de férias.



  • Máscara: Z9,99


Este parâmetro só pode ser informado se os parâmetros GerAdt, CalHfe, CalAdf, CalTFe, CalAbo, CalAAb, CalTAb forem igual a “S” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor 0,00 e calculará o adiantamento normal de férias.

calTAb

Opcional

String

Gerar adiantamento de 1/3 do abono.



  • Máscara: U


Valores:


“S” - Sim


“N” - Não



Este parâmetro só pode ser informado se o parâmetro GerAdt for igual a “S” e se o parâmetro DiaAbo for maior que 0,00.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”.

abrCad

Opcional

String

Abrangência: Colaborador (+).



  • Máscara: A[200]

prvDes

Opcional

Double

Percentual que será abatido no total das férias que será adiantado.



  • Máscara: Z9,99


Este parâmetro só pode ser informado se os parâmetros GerAdt, CalHfe, CalAdf, CalTFe, CalAbo, CalAAb, CalTAb forem igual a “S” e se o país ativo não for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor 0,00.

abrFil

Opcional

String

Abrangência: Filial (+).



  • Máscara: A[200]

gerNeg

Opcional

String

Gerar Negativa de Férias



  • Máscara: U


Valores:


“S” - Sim. Gerar férias coletivas, mesmo que os dias de saldo do período aquisitivo, sejam inferiores ao número de dias das coletivas, deixando o período com saldo negativo.


“N” - Não. Gerar as férias coletivas com os dias de saldo existentes, complementando o restante como licença remunerada na folha mensal.


“A” - Abonados Abono. Gerar as férias coletivas, com os dias de saldo existentes, jogando o restante para o próximo período como Dias Abonados.



Este parâmetro não deve ser informado se o país ativo for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

abrLoc

Opcional

String

Abrangência: Local (”+”).



  • Máscara: A[200]

admSsd

Opcional

String

Procedimento com os admitidos que tem menos de um ano de serviço.



  • Máscara: U


Valores:


“S” - Período c/ Saldo Negativo


“N” - Licença Remunerada Folha


“Q” - Quita p/ Direito = Dias Férias


“E” - Encerra Período Independente do Saldo



Este parâmetro não deve ser informado se o país ativo for o Peru.


Caso este parâmetro não seja informado, o sistema utilizará o valor “S”. Se o país ativo for o Peru, o valor será “N”.

abrSin

Opcional

String

Abrangência: Sindicato (+).



  • Máscara: A[200]

abrTco

Opcional

String

Abrangência: Tipo de Contrato (+).



  • Máscara: A[100]

abrCar

Opcional

String

Abrangência: Cargo (”+”).



  • Máscara: A[200]

abrCCu

Opcional

String

Abrangência: Centro de Custo (”+”).



  • Máscara: A[200]

abrEsc

Opcional

String

Abrangência: Escala (+).



  • Máscara: A[200]

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:EscalonarResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:EscalonarResponse>
</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.

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).