Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Controle de Ponto e Refeitório > Com.senior.g5.rh.hr.hierarquiasPosto

Web service com.senior.g5.rh.hr.hierarquiasPosto

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/ronda_Synccom_senior_g5_rh_hr_hierarquiasPosto?wsdl
Assíncrono: http://example.com/g5-senior-services/ronda_Asynccom_senior_g5_rh_hr_hierarquiasPosto?wsdl
Agendado: http://example.com/g5-senior-services/ronda_Scheduledcom_senior_g5_rh_hr_hierarquiasPosto?wsdl

Porta

ConsultarHierarquiasPosto_2

CP - Posto de Trabalho - Hierarquias: esta porta tem objetivo de consultar a hierarquia de postos de trabalho, considerando também, os postos adicionais e as delegações.

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 2

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarHierarquiasPosto_2>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <estPos>Integer</estPos>
        <posTra>String</posTra>
        <numEmp>Integer</numEmp>
        <tipCol>Integer</tipCol>
        <numCad>Integer</numCad>
        <codTap>Integer</codTap>
        <codThp>Integer</codThp>
        <datRef>DateTime</datRef>
        <tipBus>Integer</tipBus>
        <codHie>Integer</codHie>
        <posHie>Integer</posHie>
        <conAbr>String</conAbr>
      </parameters>
    </ser:ConsultarHierarquiasPosto_2>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
estPos	Opcional	Integer	Informar a Estrutura do Posto de trabalho a ser considerada na consulta. Este parâmetro é necessário informar caso a consulta da hierarquia for realizada através de um Posto de trabalho. Nos casos onde se deseja fazer a consulta através de um Colaborador, este parâmetro não deve ser informado.
posTra	Opcional	String	Informar o Posto de trabalho a ser considerado na consulta. Este parâmetro é necessário informar caso a consulta da hierarquia for realizada através de um Posto de trabalho. Nos casos onde se deseja fazer a consulta através de um Colaborador, este parâmetro não deve ser informado.
numEmp	Opcional	Integer	Informar a Empresa do Colaborador a ser considerado na consulta. Este parâmetro é necessário informar caso a consulta da hierarquia for realizada através de um Colaborador. Nos casos onde se deseja fazer a consulta através de um Posto de trabalho, este parâmetro não deve ser informado.
tipCol	Opcional	Integer	Informar o Tipo do Colaborador a ser considerado na consulta. Este parâmetro é necessário informar caso a consulta da hierarquia for realizada através de um Colaborador. Nos casos onde se deseja fazer a consulta através de um Posto de trabalho, este parâmetro não deve ser informado. Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro
numCad	Opcional	Integer	Informar o Cadastro do Colaborador a ser considerado na consulta. Este parâmetro é necessário informar caso a consulta da hierarquia for realizada através de um Colaborador. Nos casos onde se deseja fazer a consulta através de um Posto de trabalho, este parâmetro não deve ser informado.
codTap	Opcional	Integer	Informar o Tipo de atuação ser considerado para buscar o Posto do Colaborador na consulta. Este parâmetro é necessário informar caso a consulta da hierarquia for realizada através de um Colaborador. Nos casos onde se deseja fazer a consulta através de um Posto de trabalho, este parâmetro não deve ser informado.
codThp	Obrigatório	Integer	Informar o Tipo de hierarquia que se deseja consultar. Este parâmetro é obrigatório
datRef	Obrigatório	DateTime	Informar a data de referência (DD/MM/YYYY) para buscar a hierarquia e os ocupantes dos postos Este parâmetro é obrigatório
tipBus	Obrigatório	Integer	Tipo de busca na hierarquia. Valores: 1 - Busca o posto de trabalho "pai" na hierarquia 2 - Busca os postos de trabalho "filhos" na hierarquia
codHie	Opcional	Integer	Informar o Nível da Hierarquia do Posto que se deseja retornar. Quando informado, o sistema irá retornar os postos conforme o Nível informado, considerando a característica do posto vigente na data de referência. O parâmetro é opcional.
posHie	Opcional	Integer	Informar a posição dos postos na hierarquia que se deseja consultar. Quando informado, o sistema irá retornar os postos conforme sua posição na hierarquia. O parâmetro é opcional.
conAbr	Opcional	String	Informar se deve considerar abrangência de usuário ao consultar a hierarquia (S/N). Este parâmetro é opcional, e quando não informado assume o valor "S", ou seja, considera abrangência.

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:ConsultarHierarquiasPosto_2Response>
      <result>
        <postos>
          <posHie>Integer</posHie>
          <estPos>Integer</estPos>
          <posTra>String</posTra>
          <colaboradores>
            <numEmp>Integer</numEmp>
            <tipCol>Integer</tipCol>
            <numCad>Integer</numCad>
            <nomFun>String</nomFun>
            <sitAfa>Integer</sitAfa>
            <delegacoes>
              <numEmp>Integer</numEmp>
              <tipCol>Integer</tipCol>
              <numCad>Integer</numCad>
              <nomFun>String</nomFun>
              <sitAfa>Integer</sitAfa>
            </delegacoes>
          </colaboradores>
        </postos>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarHierarquiasPosto_2Response>
  </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.
postos	Opcional	Set	Postos de trabalho da hierarquia
postos.posHie	Opcional	Integer
postos.estPos	Opcional	Integer	Number(003) - Est. Posto
postos.posTra	Opcional	String	String(012) - Cód. Posto
colaboradores	Opcional	Set
colaboradores.numEmp	Opcional	Integer	Number(004) - Empresa
colaboradores.tipCol	Opcional	Integer	Number(001) - Tipo - Lista: 1 = Empregado, 2 = Terceiro, 3 = Parceiro
colaboradores.numCad	Opcional	Integer	Number(009) - Cadastro
colaboradores.nomFun	Opcional	String	String(040) - Nome
colaboradores.sitAfa	Opcional	Integer	Number(003) - Situação
delegacoes	Opcional	Set
delegacoes.numEmp	Opcional	Integer	Number(004) - Empresa
delegacoes.tipCol	Opcional	Integer	Number(001) - Tipo - Lista: 1 = Empregado, 2 = Terceiro, 3 = Parceiro
delegacoes.numCad	Opcional	Integer	Number(009) - Cadastro
delegacoes.nomFun	Opcional	String	String(040) - Nome
delegacoes.sitAfa	Opcional	Integer	Number(003) - Situação

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