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

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

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_ferias?wsdl
Assíncrono: http://example.com/g5-senior-services/rubi_Asynccom_senior_g5_rh_fp_ferias?wsdl
Agendado: http://example.com/g5-senior-services/rubi_Scheduledcom_senior_g5_rh_fp_ferias?wsdl

Porta

Programacao

AP - Férias - Programação

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:Programacao>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <programacoes>
          <tipOpe>String</tipOpe>
          <prgDat>String</prgDat>
          <prgDfe>Double</prgDfe>
          <prgDAb>Double</prgDAb>
          <prg13s>String</prg13s>
          <prgDPg>String</prgDPg>
          <gerAdt>String</gerAdt>
          <prgPcl>Integer</prgPcl>
          <efePrg>String</efePrg>
        </programacoes>
        <tipCol>Integer</tipCol>
        <numCad>Integer</numCad>
        <iniPer>String</iniPer>
      </parameters>
    </ser:Programacao>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
numEmp	Obrigatório	Integer	Código da empresa que será utilizada na integração. - Chave - Máscara: 9999
programacoes	Opcional	Set	Programações de Férias. Este web service considera as seguintes situações: - sempre confirmará a exclusão. - sempre aceitará período vencido. - se fim das férias > término período seguinte o pagamento estará sujeito a multa. - permitirá parcelar férias com x anos mesmo não podendo. - se existirem períodos anteriores ao período xx a xx com situação em aberto.
programacoes.tipOpe	Obrigatório	String	Tipo da operação a ser efetuada para um lançamento (uma linha). - Máscara: U - Valores: "I" - Inclusão "A" - Alteração "E" - Exclusão - Obs.: Se não for informado, será considerado "Alteração".
programacoes.prgDat	Obrigatório	DateTime	Data inicial para o gozo das férias. - Chave - Máscara: DD/MM/YYYY
programacoes.prgDfe	Opcional	Double	Quantidade de dias férias. - Máscara: Z9,99 - Obs.: Em uma inserção, a soma deste parâmetro com a quantidade de dias de abono pecuniário deve ser maior que 0, ou seja, um dos dois parâmetros deve ser informado.
programacoes.prgDAb	Opcional	Double	Quantidade de dias de abono pecuniário. - Máscara: Z9,99 - Obs.: Em uma inserção, a soma deste parâmetro com a quantidade de dias férias deve ser maior que 0, ou seja, um dos dois parâmetros deve ser informado.
programacoes.prg13s	Obrigatório	String	Haverá ou não adiantamento de 13° Salário no recibo de férias. - Máscara: U - Valores: "S" - Sim "N" - Não - Obs.: Se o parâmetro não for informado, o sistema utilizará o valor "N".
programacoes.prgDPg	Opcional	DateTime	Data de pagamento do recibo de férias. - Máscara: DD/MM/YYYY - Obs.: Se o parâmetro não for informado, o sistema irá calcular a data de pagamento conforme orientação legislativa.
programacoes.gerAdt	Obrigatório	String	Valores do recibo de férias devem ser adiantados no recibo ou não. - Máscara: U - Valores: "S" - Sim "N" - Não - Obs.: Se o parâmetro não for informado, o sistema utilizará o valor "S".
programacoes.prgPcl	Opcional	Integer	Quantidade de parcelas desejadas para integração das férias na folha mensal. - Máscara: 99
programacoes.efePrg	Opcional	String	Cadastrar a programação com o status "Efetiva" (S) ou "Provisória" (N). - Máscara: U - Valores: "S" - Sim "N" - Não - Obs.: Em uma inclusão, se o parâmetro não for informado, o sistema utilizará o valor "S". Se o valor for diferente de "S", o sistema utilizará o valor "N".
tipCol	Obrigatório	Integer	Tipo de colaborador. - Chave - Máscara: 9 Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro
numCad	Obrigatório	Integer	Código do Colaborador. - Chave - Máscara: 999999999
iniPer	Obrigatório	DateTime	Período aquisitivo que receberá a programação de férias. - Chave - 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:ProgramacaoResponse>
      <result>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ProgramacaoResponse>
  </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.