Web service com.senior.g5.rh.ql.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/ql_Synccom_senior_g5_rh_ql_hierarquiasPosto?wsdl
- Assíncrono: http://example.com/g5-senior-services/ql_Asynccom_senior_g5_rh_ql_hierarquiasPosto?wsdl
- Agendado: http://example.com/g5-senior-services/ql_Scheduledcom_senior_g5_rh_ql_hierarquiasPosto?wsdl
Porta
ConsultarHierarquiasPosto_2
QL - 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 |