Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Administração de Pessoal > Com.senior.g5.rh.fp.feriasColetivas

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

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

Calcular

Web service de Férias Coletivas

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 1

Requisição:

<soapenv:Envelope xmlns:ser="http://services.senior.com.br" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <ser:Calcular>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <diaInv>
      <invalidos>DateTime</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>DateTime</iniFer>
      <mulDob>String</mulDob>
      <calAbo>String</calAbo>
      <abrEmp>String</abrEmp>
      <fimFer>DateTime</fimFer>
      <datPag>DateTime</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>
      <oriPrc>Integer</oriPrc>
      <abrTco>String</abrTco>
      <nroPar>Integer</nroPar>
      <abrCar>String</abrCar>
      <abrCCu>String</abrCCu>
      <abrEsc>String</abrEsc>
    </parameters>
  </ser:Calcular>
</soapenv:Body>
</soapenv:Envelope>

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]
oriPrc Opcional Integer

Origem das parcelas do desconto do adiantamento de férias

- "0 - Parcelas informadas em tela"
- "1 - Utilizar assinalamentos do Sindicato"

Máscara: 9

abrTco Opcional String Abrangência: Tipo de Contrato (+).

- Máscara: A[100]
nroPar Opcional Integer

Números de parcelas do adiantamento de férias

Máscara: 99

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:

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

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: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ê?