Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Quadro de Vagas e Orçamento > Com.senior.g5.rh.ql.Proposta

Web service com.senior.g5.rh.ql.Proposta

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/ql_Synccom_senior_g5_rh_ql_Proposta?wsdl
Assíncrono: http://example.com/g5-senior-services/ql_Asynccom_senior_g5_rh_ql_Proposta?wsdl
Agendado: http://example.com/g5-senior-services/ql_Scheduledcom_senior_g5_rh_ql_Proposta?wsdl

EfetuarCCusto

Web service de integração que permite efetuar ou aprovar as propostas de alterações no Quadro de Lotação por c.custo.
Disponível no módulo QL - Quadro de Vagas e Orçamento.

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:EfetuarCCusto>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <efeApr>String</efeApr>
        <codCcu>String</codCcu>
        <cmpQua>String</cmpQua>
        <propostas>
          <codCar>String</codCar>
          <tipVag>Integer</tipVag>
          <vagTu1>Integer</vagTu1>
          <vagTu2>Integer</vagTu2>
          <vagTu3>Integer</vagTu3>
          <vagTu4>Integer</vagTu4>
          <vagMis>Integer</vagMis>
          <vagGer>Integer</vagGer>
          <sitPrp>Integer</sitPrp>
          <tipCol>Integer</tipCol>
          <numCad>Integer</numCad>
          <empSol>Integer</empSol>
          <tipSol>Integer</tipSol>
          <cadSol>Integer</cadSol>
        </propostas>
      </parameters>
    </ser:EfetuarCCusto>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
tipOpe	Obrigatório	String	Tipo da operação a ser efetuada na integração. Valores: I - Inclusão A - Alteração E - Exclusão
numEmp	Obrigatório	Integer	Código da empresa que será utilizado na integração. - Chave
efeApr	Obrigatório	String	Informar a operação a ser realizada nas propostas. Valores: E - Efetuar A - Aprovar
codCcu	Obrigatório	String	Indicar em qual C.Custo serão cadastradas as propostas efetuadas, ou em qual serão aprovadas. - Chave - Máscara: U[18]
cmpQua	Obrigatório	DateTime	Data na qual o sistema deve gravar as propostas efetuadas, ou buscar as propostas a aprovar. - Chave - Máscara: DD/MM/YYYY
propostas	Opcional	Set
propostas.codCar	Obrigatório	String	Código do cargo para o qual será feita a proposta. - Chave
propostas.tipVag	Opcional	Integer	Definir o tipo de vaga da proposta. - Chave Observações: O campo deverá ser informado somente se a empresa controlar tipo de vaga.
propostas.vagTu1	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 1º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagTu2	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 2º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagTu3	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 3º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagTu4	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 4º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagMis	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo em turnos mistos. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagGer	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no turno geral. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.sitPrp	Obrigatório	Integer	Situação atual da proposta, para aprovar a mesma basta colocar o código 2 (Aprovada) em sua situação. Valores: 1 - Proposta 2 - Aprovada 3 - Não aprovada 4 - Efetivada 5 - Suspensa
propostas.tipCol	Opcional	Integer	Tipo do colaborador responsável pela proposta. Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Não deverá ser informado caso for efetuar propostas.
propostas.numCad	Opcional	Integer	Código do colaborador responsável pela proposta. O campo deverá ser preenchido caso for informado um tipo de responsável. Não deverá ser informado caso for efetuar propostas.
propostas.empSol	Opcional	Integer	Empresa do Solicitante. Não deverá ser informado caso for aprovar propostas.
propostas.tipSol	Opcional	Integer	Tipo do colaborador solicitante. Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Não deverá ser informado caso for aprovar propostas.
propostas.cadSol	Opcional	Integer	Código do colaborador solicitante. O campo deverá ser preenchido caso for informado um tipo de solicitante. Não deverá ser informado caso for aprovar propostas.

Resposta:

Nota

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

EfetuarLocal

Web service de integração que permite efetuar ou aprovar as propostas de alterações no Quadro de Lotação por local.
Disponível no módulo QL - Quadro de Vagas e Orçamento.

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:EfetuarLocal>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <efeApr>String</efeApr>
        <cmpQua>String</cmpQua>
        <numLoc>String</numLoc>
        <propostas>
          <codCar>String</codCar>
          <tipVag>Integer</tipVag>
          <vagTu1>Integer</vagTu1>
          <vagTu2>Integer</vagTu2>
          <vagTu3>Integer</vagTu3>
          <vagTu4>Integer</vagTu4>
          <vagMis>Integer</vagMis>
          <vagGer>Integer</vagGer>
          <sitPrp>Integer</sitPrp>
          <tipCol>Integer</tipCol>
          <numCad>Integer</numCad>
          <empSol>Integer</empSol>
          <tipSol>Integer</tipSol>
          <cadSol>Integer</cadSol>
        </propostas>
      </parameters>
    </ser:EfetuarLocal>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
tipOpe	Obrigatório	String	Tipo da operação a ser efetuada na integração. Valores: I - Inclusão A - Alteração E - Exclusão
numEmp	Obrigatório	Integer	Código da empresa que será utilizado na integração. - Chave
efeApr	Obrigatório	String	Informar a operação a ser realizada nas propostas. Valores: E - Efetuar A - Aprovar
cmpQua	Obrigatório	DateTime	Data na qual o sistema deve gravar as propostas efetuadas, ou buscar as propostas a aprovar. - Chave - Máscara: DD/MM/YYYY
numLoc	Obrigatório	String	Indicar em qual Local serão cadastradas as propostas efetuadas, ou em qual serão aprovadas. - Chave
propostas	Opcional	Set	Grid de propostas.
propostas.codCar	Obrigatório	String	Código do cargo para o qual será feita a proposta. - Chave
propostas.tipVag	Opcional	Integer	Definir o tipo de vaga da proposta. - Chave Observações: O campo deverá ser informado somente se a empresa controlar tipo de vaga.
propostas.vagTu1	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 1º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagTu2	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 2º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagTu3	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 3º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagTu4	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no 4º turno. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagMis	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo em turnos mistos. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.vagGer	Opcional	Integer	Quantidade de vagas a ser proposta para o cargo no turno geral. Não deve ser informado caso a empresa não utilizar turno QL.
propostas.sitPrp	Obrigatório	Integer	Situação atual da proposta, para aprovar a mesma basta colocar o código 2 (Aprovada) em sua situação. Valores: 1 - Proposta 2 - Aprovada 3 - Não aprovada 4 - Efetivada 5 - Suspensa
propostas.tipCol	Opcional	Integer	Tipo do colaborador responsável pela proposta. Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Não deverá ser informado caso for efetuar propostas.
propostas.numCad	Opcional	Integer	Código do colaborador responsável pela proposta. O campo deverá ser preenchido caso for informado um tipo de responsável. Não deverá ser informado caso for efetuar propostas.
propostas.empSol	Opcional	Integer	Empresa do Solicitante. Não deverá ser informado caso for aprovar propostas.
propostas.tipSol	Opcional	Integer	Tipo do colaborador solicitante. Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Não deverá ser informado caso for aprovar propostas.
propostas.cadSol	Opcional	Integer	Código do colaborador solicitante. O campo deverá ser preenchido caso for informado um tipo de solicitante. Não deverá ser informado caso for aprovar propostas.

Resposta:

Nota

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

EfetivarLocal

Web service de integração que permite efetivar as propostas de alterações no Quadro de Lotação por local.
Disponível no módulo QL - Quadro de Vagas e Orçamento.

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:EfetivarLocal>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <datIni>String</datIni>
        <datFim>String</datFim>
        <tipEfe>String</tipEfe>
        <atuQFu>String</atuQFu>
        <mesPro>Integer</mesPro>
        <abrLoc>String</abrLoc>
        <abrCar>String</abrCar>
      </parameters>
    </ser:EfetivarLocal>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
numEmp	Obrigatório	Integer	Código da empresa que será utilizado na integração.
datIni	Obrigatório	DateTime	Informar data de início a ser considerado na efetivação. Máscara: DD/MM/YYYY
datFim	Obrigatório	DateTime	Informar data final a ser considerado na efetivação. Máscara: DD/MM/YYYY
tipEfe	Obrigatório	String	De acordo com as situações, informar quais propostas devem ser consideradas na efetivação. Valores: A - Aprovadas T - Todas
atuQFu	Obrigatório	String	Neste item é possível definir se quando houverem novas propostas a serem efetivadas e a normalização do quadro já tiver sido feita incluindo meses posteriores, as vagas existentes no quadro para os meses seguintes deverão ou não ser atualizadas. Valores: S - Sim N - Não
mesPro	Opcional	Integer	Este campo tem como objetivo projetar em uma determinada quantidade de meses (informado pelo usuário) a proposta efetuada. Sendo que, ele fica visível somente se o tipo de quadro for definido como por competência.
abrLoc	Opcional	String	Informar o(s) local(is) de custo(s) que deveram ser processados.
abrCar	Opcional	String	Permite tratar apenas alguns cargos ou deixar em branco para considerar todos.

Resposta:

Nota

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

EfetivarCCusto

Web service de integração que permite efetivar as propostas de alterações no Quadro de Lotação por c.custo.
Disponível no módulo QL - Quadro de Vagas e Orçamento.

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:EfetivarCCusto>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <datIni>String</datIni>
        <datFim>String</datFim>
        <tipEfe>String</tipEfe>
        <atuQFu>String</atuQFu>
        <mesPro>Integer</mesPro>
        <abrCcu>String</abrCcu>
        <abrCar>String</abrCar>
      </parameters>
    </ser:EfetivarCCusto>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
numEmp	Obrigatório	Integer	Código da empresa que será utilizado na integração.
datIni	Obrigatório	DateTime	Informar data de início a ser considerado na efetivação. Máscara: DD/MM/YYYY
datFim	Obrigatório	DateTime	Informar data final a ser considerado na efetivação. Máscara: DD/MM/YYYY
tipEfe	Obrigatório	String	De acordo com as situações, informar quais propostas devem ser consideradas na efetivação. Valores: A - Aprovadas T - Todas
atuQFu	Obrigatório	String	Neste item é possível definir se quando houverem novas propostas a serem efetivadas e a normalização do quadro já tiver sido feita incluindo meses posteriores, as vagas existentes no quadro para os meses seguintes deverão ou não ser atualizadas. Valores: S - Sim N - Não
mesPro	Opcional	Integer	Este campo tem como objetivo projetar em uma determinada quantidade de meses (informado pelo usuário) a proposta efetuada. Sendo que, ele fica visível somente se o tipo de quadro for definido como por competência.
abrCcu	Opcional	String	Informar o(s) centro(s) de custo(s) que deveram ser processados.
abrCar	Opcional	String	Permite tratar apenas alguns cargos ou deixar em branco para considerar todos.

Resposta:

Nota

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

EfetivarPosto

Web Service para efetivar propostas por posto de trabalho através do menu Lotação x Posto > Propostas > Efetivar (FREFEPOS), no módulo Quadro de Vagas e Orçamentos.

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Versão atual: 1.

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:EfetivarPosto>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <efeCanc>String</efeCanc>
        <estPos>Integer</estPos>
        <plaVag>Integer</plaVag>
        <seque>Integer</seque>
        <posTra>String</posTra>
        <desHis>String</desHis>
      </parameters>
    </ser:EfetivarPosto>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
numEmp	Obrigatório	Integer	Número da empresa. Máscara: 9\[4]
efeCanc	Obrigatório	String	Indicador de efetivação/cancelamento das propostas. Valores: C - Cancelar E - Efetivar Máscara: A\[1]
estPos	Opcional	Integer	Código da Estrutura de Postos de Trabalho. Máscara: 9\[3]
plaVag	Opcional	Integer	Código do Plano de Vagas. Máscara: 9\[4]
seque	Integer	Integer	Sequência da proposta de alteração do quadro de vagas por posto. Máscara: 9\[9]
posTra	Opcional	String	Posto de trabalho envolvido na proposta de alteração do quadro. Máscara: A\[24] Observação: Quando a proposta for do tipo Criação de novo posto, este campo passa a ser obrigatório e servirá para definir e substituir (caso tenha sido digitado) o nome do novo posto.\|
desHis	Opcional	String	Observações sobre efetivação ou cancelamento de proposta. Máscara: A\[2000]

Resposta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:EfetivarPostoResponse>
      <result>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:EfetivarPostoResponse>
  </soapenv:Body>
</soapenv:Envelope>

Nota

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.

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.

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