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
- Síncrono: http://example.com/g5-senior-services/rubi_Synccom_senior_g5_rh_fp_feriasColetivas?wsdl
- Assíncrono: http://example.com/g5-senior-services/rubi_Asynccom_senior_g5_rh_fp_feriasColetivas?wsdl
- Agendado: http://example.com/g5-senior-services/rubi_Scheduledcom_senior_g5_rh_fp_feriasColetivas?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:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Calcular> <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: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:
|
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: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. |