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.Quadro

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

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_Quadro?wsdl
Assíncrono: http://example.com/g5-senior-services/ql_Asynccom_senior_g5_rh_ql_Quadro?wsdl
Agendado: http://example.com/g5-senior-services/ql_Scheduledcom_senior_g5_rh_ql_Quadro?wsdl

ConsultarVagasCCusto

Web service de integração que permite consultar a quantidade de vagas de um determinado c.custo e cargo.
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:ConsultarVagasCCusto>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <estCar>Integer</estCar>
        <codCar>String</codCar>
        <codCcu>String</codCcu>
        <tipTur>Integer</tipTur>
        <datRef>String</datRef>
        <tipVag>Integer</tipVag>
      </parameters>
    </ser:ConsultarVagasCCusto>
  </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 consulta. - Obrigatório
estCar	Obrigatório	Integer	Código da estrutura de cargo que será utilizado na consulta. - Obrigatório
codCar	Obrigatório	String	Código do cargo que será utilizado na consulta. - Obrigatório
codCcu	Obrigatório	String	Código do C.Custo que será utilizado na consulta. - Obrigatório - Máscara: U[18]
tipTur	Obrigatório	Integer	Tipo do turno que será utilizado na consulta. - Obrigatório Valores: 1 - 1º Turno 2 - 2º Turno 3 - 3º Turno 4 - 4º Turno 8 - Misto 9 - Geral
datRef	Obrigatório	DateTime	Data que será utilizado na consulta. - Obrigatório - Máscara: DD/MM/YYYY
tipVag	Obrigatório	Integer	Código do tipo de vaga que será utilizado na consulta. - Obrigatório

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:ConsultarVagasCCustoResponse>
      <result>
        <qtdVag>Integer</qtdVag>
        <qtdVagPre>Integer</qtdVagPre>
        <qtdVagRes>Integer</qtdVagRes>
        <totVagPre>Integer</totVagPre>
        <vagTmp>Integer</vagTmp>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarVagasCCustoResponse>
  </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.
qtdVag	Opcional	Integer	Quantidade de vagas que a consulta retornou.
qtdVagPre	Opcional	Integer	Quantidade de vagas previstas sem o efetivo que a consulta retornou.
qtdVagRes	Opcional	Integer	Quantidade de vagas reservadas que a consulta retornou.
totVagPre	Opcional	Integer	Quantidade de vagas previstas que a consulta retornou.
vagTmp	Opcional	Integer	Quantidade de vagas temporárias sem o efetivo que a consulta retornou.

ConsultarVagasLocal

Web service de integração que permite consultar a quantidade de vagas de um determinado local e cargo.
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:ConsultarVagasLocal>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <estCar>Integer</estCar>
        <codCar>String</codCar>
        <tabOrg>String</tabOrg>
        <codLoc>String</codLoc>
        <tipTur>Integer</tipTur>
        <datRef>String</datRef>
        <tipVag>Integer</tipVag>
      </parameters>
    </ser:ConsultarVagasLocal>
  </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 consulta. - Obrigatório
estCar	Obrigatório	Integer	Código da estrutura de cargo que será utilizado na consulta. - Obrigatório
codCar	Obrigatório	String	Código do cargo que será utilizado na consulta. - Obrigatório
tabOrg	Obrigatório	String	Código do Organograma que será utilizado na consulta. - Obrigatório
codLoc	Obrigatório	String	Código do local que será utilizado na consulta. - Obrigatório
tipTur	Obrigatório	Integer	Tipo do turno que será utilizado na consulta. - Obrigatório Valores: 1 - 1º Turno 2 - 2º Turno 3 - 3º Turno 4 - 4º Turno 8 - Misto 9 - Geral
datRef	Obrigatório	DateTime	Data que será utilizado na consulta. - Obrigatório - Máscara: DD/MM/YYYY
tipVag	Obrigatório	Integer	Código do tipo de vaga que será utilizado na consulta. - Obrigatório

Resposta:

Observação

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarVagasLocalResponse>
      <result>
        <qtdVag>Integer</qtdVag>
        <qtdVagPre>Integer</qtdVagPre>
        <qtdVagRes>Integer</qtdVagRes>
        <totVagPre>Integer</totVagPre>
        <vagTmp>Integer</vagTmp>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarVagasLocalResponse>
  </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.
qtdVag	Opcional	Integer	Quantidade de vagas que a consulta retornou.
qtdVagPre	Opcional	Integer	Quantidade de vagas previstas sem o efetivo, que a consulta retornou.
qtdVagRes	Opcional	Integer	Quantidade de vagas reservadas que a consulta retornou.
totVagPre	Opcional	Integer	Quantidade de vagas previstas que a consulta retornou.
vagTmp	Opcional	Integer	Quantidade de vagas temporárias sem o efetivo que a consulta retornou.

ConsultarVagasPosto

Web service de integração que permite consultar a quantidade de vagas de um determinado posto de trabalho.
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:ConsultarVagasPosto>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <tipQua>Integer</tipQua>
        <estPos>Integer</estPos>
        <posTra>String</posTra>
        <datRef>String</datRef>
      </parameters>
    </ser:ConsultarVagasPosto>
  </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 consulta. - Máscara: 9999 - Obrigatório
tipQua	Obrigatório	Integer	Tipo de consulta do quadro - Obrigatório - Valores: 1 - Completo (Previsto, Efetivo, Afastamentos, Requisições, Solicitações de vaga) 2 - Previsto 3 - Efetivo 4 - Afastamentos 5 - Requisições em andamento 6 - Solicitações de vaga em andamento
estPos	Obrigatório	Integer	Código da estrutura de postos que será utilizada na consulta. - Máscara: 999 - Obrigatório
posTra	Obrigatório	String	Código do posto de trabalho que será utilizado na consulta. - Máscara:U[24] - Obrigatório
datRef	Obrigatório	DateTime	Data que será utilizado na consulta. - Obrigatório - Máscara: DD/MM/YYYY

Resposta:

Observação

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarVagasPostoResponse>
      <result>
        <qtdPre>Integer</qtdPre>
        <qtdEfe>Integer</qtdEfe>
        <qtdAfa>Integer</qtdAfa>
        <qtdRqu>Integer</qtdRqu>
        <qtdSol>Integer</qtdSol>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarVagasPostoResponse>
  </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.
qtdPre	Opcional	Integer	Quantidade de vagas previstas para o posto que a consulta retornou. - Máscara: 9999
qtdEfe	Opcional	Integer	Quantidade de vagas efetivas para o posto que a consulta retornou. - Máscara: 9999
qtdAfa	Opcional	Integer	Quantidade de colaboradores afastados do quadro para o posto que a consulta retornou. Depende de assinalamento específico no cadastro de situações de afastamento. - Máscara: 9999
qtdRqu	Opcional	Integer	Quantidade de requisições em andamento para o posto que a consulta retornou. - Máscara: 9999
qtdSol	Opcional	Integer	Quantidade de solicitações de vagas em andamento para o posto que a consulta retornou. - Máscara: 9999

ConsultarVagasPostoColetivo

Web service de integração que permite consultar a quantidade de vagas de vários postos de trabalho.
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:ConsultarVagasPostoColetivo>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <tipQua>Integer</tipQua>
        <estPos>Integer</estPos>
        <abrPosTra>String</abrPosTra>
        <datRef>String</datRef>
      </parameters>
    </ser:ConsultarVagasPostoColetivo>
  </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 consulta. - Máscara: 9999 - Obrigatório
tipQua	Obrigatório	Integer	Tipo de consulta do quadro - Obrigatório - Valores: 1 - Completo (Previsto, Efetivo, Afastamentos, Requisições, Solicitações de vaga) 2 - Previsto 3 - Efetivo 4 - Afastamentos 5 - Requisições em andamento 6 - Solicitações de vaga em andamento
estPos	Obrigatório	Integer	Código da estrutura de postos que será utilizada na consulta. - Máscara: 999 - Obrigatório
abrPosTra	Opcional	String	Abrangência de postos de trabalho - Opcional Obs: Para a abrangência funcionar corretamente, deve-se informar os valores entre aspas sem hífem. Exe: "Posto01","Posto02"
datRef	Obrigatório	DateTime	Data que será utilizado na consulta. - Obrigatório - Máscara: DD/MM/YYYY

Resposta:

Observação

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarVagasPostoColetivoResponse>
      <result>
        <gridPostos>
          <posTra>String</posTra>
          <qtdPre>Integer</qtdPre>
          <qtdEfe>Integer</qtdEfe>
          <qtdAfa>Integer</qtdAfa>
          <qtdRqu>Integer</qtdRqu>
          <qtdSol>Integer</qtdSol>
        </gridPostos>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarVagasPostoColetivoResponse>
  </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.
gridPostos	Opcional	Set	Postos de trabalho
gridPostos.posTra	Opcional	String	Posto de Trabalho
gridPostos.qtdPre	Opcional	Integer	Quantidade de vagas previstas para o posto que a consulta retornou.
gridPostos.qtdEfe	Opcional	Integer	Quantidade de vagas efetivas para o posto que a consulta retornou.
gridPostos.qtdAfa	Opcional	Integer	Quantidade de colaboradores afastados do quadro para o posto que a consulta retornou. Depende de assinalamento específico no cadastro de situações de afastamento.
gridPostos.qtdRqu	Opcional	Integer	Quantidade de requisições em andamento para o posto que a consulta retornou.
gridPostos.qtdSol	Opcional	Integer	Quantidade de solicitações de vagas em andamento para o posto que a consulta retornou.

ReservarCCusto

Web service de integração que permite efetuar reservas de vagas.
Controle do quadro 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:ReservarCCusto>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <codCcu>String</codCcu>
        <cmpQua>String</cmpQua>
        <reservas>
          <codCar>String</codCar>
          <tipVag>Integer</tipVag>
          <vagGer>Integer</vagGer>
          <vagTu1>Integer</vagTu1>
          <vagTu2>Integer</vagTu2>
          <vagTu3>Integer</vagTu3>
          <vagTu4>Integer</vagTu4>
          <vagMis>Integer</vagMis>
          <tipCol>Integer</tipCol>
          <numCad>Integer</numCad>
        </reservas>
      </parameters>
    </ser:ReservarCCusto>
  </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 - Obrigatório Valores: I - Inclusão A - Alteração E - Exclusão
numEmp	Obrigatório	Integer	Empresa a ser considerada ao consultar assinalamentos para efetuar esta reserva de vagas - Obrigatório
codCcu	Obrigatório	String	Código do centro de custo para o qual serão efetuadas as reservas de vagas - Obrigatório - Chave - Máscara: U[18]
cmpQua	Obrigatório	DateTime	Indicar a competência na qual deverá ser considerada a reserva das vagas - Obrigatório - Chave - Máscara: DD/MM/YYYY
reservas	Opcional	Set	Lista de reservas de vagas por centro de custo
reservas.codCar	Obrigatório	String	Código do cargo para o qual será feita a reserva. - Obrigatório - Chave
reservas.tipVag	Opcional	Integer	Definir o tipo de vaga da reserva. - Obrigatório - Chave Observação: O campo devera ser informado somente se a empresa controlar tipo de vaga.
reservas.vagGer	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no turno geral. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu1	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 1º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu2	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 2º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu3	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 3º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu4	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 4º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagMis	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo em turnos mistos. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.tipCol	Opcional	Integer	Tipo do colaborador responsável pela reserva. - Opcional Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro
reservas.numCad	Opcional	Integer	Código do colaborador responsável pela reserva. - Opcional O campo devera ser preenchido caso for informado um tipo de responsável.

Resposta:

Observação

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ReservarCCustoResponse>
      <result>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ReservarCCustoResponse>
  </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.

ReservarLocal

Web service de integração que permite efetuar reservas de vagas.
Controle do quadro 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:ReservarLocal>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <numLoc>String</numLoc>
        <cmpQua>String</cmpQua>
        <reservas>
          <codCar>String</codCar>
          <tipVag>Integer</tipVag>
          <vagGer>Integer</vagGer>
          <vagTu1>Integer</vagTu1>
          <vagTu2>Integer</vagTu2>
          <vagTu3>Integer</vagTu3>
          <vagTu4>Integer</vagTu4>
          <vagMis>Integer</vagMis>
          <tipCol>Integer</tipCol>
          <numCad>Integer</numCad>
        </reservas>
      </parameters>
    </ser:ReservarLocal>
  </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 - Obrigatório Valores: I - Inclusão A - Alteração E - Exclusão
numEmp	Obrigatório	Integer	Empresa a ser considerada ao consultar assinalamentos para efetuar esta reserva de vagas - Obrigatório
numLoc	Obrigatório	String	Código do local para o qual serão efetuadas as reservas de vagas - Obrigatório - Chave
cmpQua	Obrigatório	DateTime	Indicar a competência na qual deverá ser considerada a reserva das vagas - Obrigatório - Chave - Máscara: DD/MM/YYYY
reservas	Opcional	Set	Lista de reservas de vagas por centro de custo
reservas.codCar	Obrigatório	String	Código do cargo para o qual será feita a reserva. - Obrigatório - Chave
reservas.tipVag	Opcional	Integer	Definir o tipo de vaga da reserva. - Obrigatório - Chave Observação: O campo devera ser informado somente se a empresa controlar tipo de vaga.
reservas.vagGer	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no turno geral. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu1	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 1º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu2	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 2º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu3	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 3º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagTu4	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo no 4º turno. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.vagMis	Opcional	Integer	Quantidade de vagas a ser reservada para o cargo em turnos mistos. - Opcional Não deve ser informado caso a empresa não utilizar turno QL.
reservas.tipCol	Opcional	Integer	Tipo do colaborador responsável pela reserva. - Opcional Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro
reservas.numCad	Opcional	Integer	Código do colaborador responsável pela reserva. - Opcional O campo devera ser preenchido caso for informado um tipo de responsável.

Resposta:

Observação

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ReservarLocalResponse>
      <result>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ReservarLocalResponse>
  </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.