Este conteúdo não recebe atualizações, pois é referente a uma versão do sistema que foi descontinuada. Acesse a documentação da versão 6.10.3 aqui
Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Cargos e Salários > Com.senior.g5.rh.cs.cursos

Web service com.senior.g5.rh.cs.cursos

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

Portas

CursosFormacao

Web service usado para cadastrar os cursos de formação que serão utilizados nos requisitos dos cargos como também aqueles indicados no currículo dos candidatos. Também deverão ser cadastrados os cursos que farão parte do histórico de cursos de formação dos colaboradores.

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:CursosFormacao>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <codCuf>Integer</codCuf>
        <nomCuf>String</nomCuf>
        <nomRed>String</nomRed>
        <codAss>Integer</codAss>
        <nivCuf>Integer</nivCuf>
        <seqNiv>Integer</seqNiv>
        <tipDur>Integer</tipDur>
        <temDur>Integer</temDur>
        <chrCuf>String</chrCuf>
        <conWeb>String</conWeb>
      </parameters>
    </ser:CursosFormacao>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
tipOpe Obrigatório String Tipo de operação


Valores:
I - Inclusão
A - Alteração
E - Exclusão
numEmp Obrigatório Integer Código da empresa que será utilizada na integração.
codCuf Opcional Integer Código do curso de formação.

- Chave

Observações:
Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre.
nomCuf Opcional String Descrição do curso de formação.
Exemplo: 1º grau incompleto, 1º grau completo, 2º completo.


-Obrigatório
nomRed Opcional String Nome reduzido do curso de formação.
Exemplo: Primário, Ginásio.

-Obrigatório
codAss Opcional Integer Assunto no qual se refere o curso de formação.
Exemplo: Engenharias, profissionalizante, ensino básico.

-Obrigatório
nivCuf Opcional Integer Nível de cada curso de formação.

-Obrigatório
seqNiv Opcional Integer Sequência do nível de curso de formação. Para um mesmo nível é possível cadastrar várias sequências, caso sejam oferecidos cursos de um mesmo nível com o número de fases diferentes.

-Obrigatório
tipDur Opcional Integer Indicar o tipo de duração do curso:
1 - Horas
2 - Dias
3 - Meses
4 - Anos
5 - Semestre

-Opcional

Quando executado pelo CS ou RS, deixar a informação deste campo nula.
temDur Opcional Integer Quantidade do tipo de duração que foi informado no campo anterior.
Exemplo: Se foi indicado 3-Meses no campo anterior, e este curso tem duração de 6 meses, indicar 6 neste campo.

-Opcional

Quando executado pelo CS ou RS, deixar a informação deste campo nula.
chrCuf Opcional Time Carga horária correspondente para o curso em questão.

-Opcional

Quando executado pelo CS ou RS, deixar a informação deste campo nula.
conWeb Opcional String Identifica se o curso será disponibilizado no currículo web.
Valores:
- S (Sim)
- N (Não)

-Obrigatório

Quando executado pelo CS ou TR, deixar a informação deste campo nula.

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:CursosFormacaoResponse>
      <result>
        <codCuf>Integer</codCuf>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:CursosFormacaoResponse>
  </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.
codCuf Opcional Integer Código do curso de formação.

- Chave

Observações:
Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre.

CursosAperfeicoamento_2

Este web service nos possibilita incluir cursos exigidos a título de aperfeiçoamento do ocupante do cargo. Também podemos cadastrar os cursos ministrados na empresa e os cursos que os colaboradores trazem em seu currículo.

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:CursosAperfeicoamento_2>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <nomRed>String</nomRed>
        <tipOpeGrid2>String</tipOpeGrid2>
        <tipOpeGrid3>String</tipOpeGrid3>
        <tipOpeGrid4>String</tipOpeGrid4>
        <tipOpeGrid5>String</tipOpeGrid5>
        <tipOpeGrid6>String</tipOpeGrid6>
        <tipOpeGrid7>String</tipOpeGrid7>
        <tipOpeGrid8>String</tipOpeGrid8>
        <tipOpeGrid9a>String</tipOpeGrid9a>
        <tipOpeGrid9b>String</tipOpeGrid9b>
        <tipOpeGrid0>String</tipOpeGrid0>
        <datAlt>String</datAlt>
        <tipOpeGrid12>String</tipOpeGrid12>
        <qtdRecDis>String</qtdRecDis>
        <numEmp>Integer</numEmp>
        <codAss>Integer</codAss>
        <wGD128RCF>
          <curso>Integer</curso>
        </wGD128RCF>
        <wGD128RCA>
          <curso>Integer</curso>
        </wGD128RCA>
        <wGD128RCN>
          <familia>String</familia>
          <conhecimento>String</conhecimento>
        </wGD128RCN>
        <wGD128FAS>
          <fase>String</fase>
          <descricao>String</descricao>
        </wGD128FAS>
        <wGD128CUR>
          <recurso>Integer</recurso>
          <quantidade>Integer</quantidade>
        </wGD128CUR>
        <wGD128HOR>
          <codigo>Integer</codigo>
        </wGD128HOR>
        <wGD128TES>
          <teste>String</teste>
          <qtdPerguntas>Integer</qtdPerguntas>
        </wGD128TES>
        <wGD128CUN>
          <itemNota>Integer</itemNota>
          <peso>Integer</peso>
        </wGD128CUN>
        <wGD128COM>
          <codigo>Integer</codigo>
        </wGD128COM>
        <obsRev>String</obsRev>
        <wGD128COA>
          <familia>String</familia>
          <conhecimento>Integer</conhecimento>
        </wGD128COA>
        <codCua>Integer</codCua>
        <tipCua>String</tipCua>
        <tipOpeGrid11>String</tipOpeGrid11>
        <nomCua>String</nomCua>
        <emiCer>String</emiCer>
        <wGD128PAN>
          <itemNota>Integer</itemNota>
          <peso>Integer</peso>
        </wGD128PAN>
        <valCua>Integer</valCua>
        <conFre>Integer</conFre>
        <tipDur>Integer</tipDur>
        <temDur>Integer</temDur>
        <chrCua>String</chrCua>
        <freCua>Double</freCua>
        <medCua>Double</medCua>
        <tipCer>String</tipCer>
        <codTst>String</codTst>
        <iniEfi>Integer</iniEfi>
        <praAva>Integer</praAva>
        <metEfi>Integer</metEfi>
        <praARe>Integer</praARe>
        <tipRea>Integer</tipRea>
        <turCua>String</turCua>
        <codFlt>Integer</codFlt>
        <regInc>Integer</regInc>
        <regExc>Integer</regExc>
        <regTrf>Integer</regTrf>
        <regSub>Integer</regSub>
        <perRsv>String</perRsv>
        <codUsu>Integer</codUsu>
        <desCon>String</desCon>
        <desObu>String</desObu>
        <metCua>String</metCua>
        <pubAlv>String</pubAlv>
        <nomArq>String</nomArq>
        <conWeb>String</conWeb>
        <conPdi>String</conPdi>
        <criRep>Integer</criRep>
        <datExp>String</datExp>
        <curTlt>Integer</curTlt>
        <abrLoc>String</abrLoc>
        <avaTlt>Integer</avaTlt>
      </parameters>
    </ser:CursosAperfeicoamento_2>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
tipOpe Opcional String Tipo da operação a ser efetuada na integração


Valores:
I - Inclusão
A - Alteração
E - Exclusão
nomRed Opcional String Nome reduzido do curso.
Exemplo: Curso de Inglês.


-Obrigatório
tipOpeGrid2 Opcional String  
tipOpeGrid3 Opcional String  
tipOpeGrid4 Opcional String  
tipOpeGrid5 Opcional String  
tipOpeGrid6 Opcional String  
tipOpeGrid7 Opcional String  
tipOpeGrid8 Opcional String  
tipOpeGrid9a Opcional String  
tipOpeGrid9b Opcional String  
tipOpeGrid0 Opcional String  
datAlt Opcional DateTime  
tipOpeGrid12 Opcional String Ação a ser efetuada na integração


Valores:
I - Inclusão
A - Alteração
E - Exclusão
qtdRecDis Opcional String Informar se deseja proceguir quando a quantidade digitada for maior que a quantidade de recurso disponível
Valores:
S - Sim
N - Não
numEmp Obrigatório Integer Código da empresa que será utilizada na integração.
codAss Opcional Integer Informar o código do assunto que será abordado no curso.
wGD128RCF Opcional Set  
wGD128RCF.curso Opcional Integer  
wGD128RCA Opcional Set  
wGD128RCA.curso Opcional Integer  
wGD128RCN Opcional Set  
wGD128RCN.familia Opcional String  
wGD128RCN.conhecimento Opcional String  
wGD128FAS Opcional Set  
wGD128FAS.fase Opcional String  
wGD128FAS.descricao Opcional String  
wGD128CUR Opcional Set  
wGD128CUR.recurso Opcional Integer  
wGD128CUR.quantidade Opcional Integer  
wGD128HOR Opcional Set  
wGD128HOR.codigo Opcional Integer  
wGD128TES Opcional Set  
wGD128TES.teste Opcional String  
wGD128TES.qtdPerguntas Opcional Integer  
wGD128CUN Opcional Set Informar os ítens de avaliação do curso.
wGD128CUN.itemNota Opcional Integer Indicar o código do item nota referente ao ítens de avaliação dos participantes.
wGD128CUN.peso Opcional Integer Indicar o peso referente ao item nota.
wGD128COM Opcional Set Informar as disciplinas que serão ministradas no curso.
wGD128COM.codigo Opcional Integer Indicar o código da disciplina a ser ministrada no curso.
obsRev Opcional String  
wGD128COA Opcional Set Informar os conhecimentos adquiridos.
Identificar a família e conhecimento.
wGD128COA.familia Opcional String Indicar o código da família referente aos conhecimento adquiridos que serão informados.


OBS.: Este campo é obrigatório mesmo quando definido família padrão.
wGD128COA.conhecimento Opcional Integer Indicar o código do curso de conhecimento adquirido referente a família escolhida.
codCua Opcional Integer Código do curso de aperfeiçoamento.

- Chave

Observações:
Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre.
tipCua Opcional String Neste item deve ser indicado se o curso é modular ou não.
Na pasta Disciplinas, serão informados os cursos que compõem o curso modular.
Exemplo: Curso modular: Mecânica e como Disciplinas: Interpretação de Desenho, Matemática básica, Práticas em Mecânica, etc.

S-Sim, este curso será utilizado como modular
N-Não, o tratamento para este curso será o padrão


-Obrigatório
tipOpeGrid11 Opcional String  
nomCua Opcional String Descrição completa do curso de aperfeiçoamento.
Exemplo: Técnico em Segurança do Trabalho.


-Obrigatório
emiCer Opcional String Informações válidas:

S-Sim, os certificados para cada disciplina serão emitidos
N-Não, somente o certificado do curso modular será emitido


-Obrigatório
wGD128PAN Opcional Set Informar os ítens de avaliação dos participantes.
wGD128PAN.itemNota Opcional Integer Indicar o código do item nota referente ao ítens de avaliação dos participantes.
wGD128PAN.peso Opcional Integer Indicar o peso referente ao item nota.
valCua Opcional Integer Informar o número de meses de validade do curso, se não houver, deixar em branco. É com base nesta informação comparada com a data do fim do curso no histórico do colaborador ou candidato que o curso é considerado válido ou vencido.


conFre Opcional Integer Este campo define a forma de controlar a frequência no curso.

0 - Quantidade de aulas
1 - Carga horária

tipDur Opcional Integer Indicar o tipo de duração do curso, conforme a seguir:

1-Horas
2-Dias
3-Meses
4-Anos
5-Semestre
Quando for informado tipo de duração horas, não será necessário o registro da duração, pois a informação carga horária será suficiente.

temDur Opcional Integer Indicar a quantidade do tipo de duração que foi informado no dado anterior.
Exemplo: Se foi indicado 3=meses no dado anterior, e este curso tem duração de 06 meses, indicar 6 neste campo.

-Opcional
chrCua Opcional Time Informar a carga horária total do curso.
Este valor será sugerido no cadastramento de uma turma, no histórico de curso do colaborador e no histórico geral de cursos.
freCua Opcional Double Informar o percentual de frequência necessário para aprovação no curso.
Este percentual será considerado na avaliação do participante.

medCua Opcional Double Informar a média mínima para aprovação no curso.
tipCer Opcional String Identifica qual o tipo de certificado será emitido ao participantes que fizeram este curso.

A-Aproveitamento - será gerado para o colaborador um histórico de curso com o tipo A
P-Participação - será gerado para o colaborador um histórico de curso com o tipo P
N-Nenhum - não será gerado o histórico de curso para o colaborador


-Opcional
codTst Opcional String Informar o código do questionário que será utilizado na avaliação de eficácia do treinamento. Este questionário deverá estar previamente cadastrado em Treinamento/Turmas/Avaliação de Eficácia/Questionário.

iniEfi Opcional Integer Informar a quantidade de dias que será utilizado para a contagem da data que a avaliação ficará disponível para o usuário responder.
Será contado a partir do dia seguinte da data de término do treinamento.

praAva Opcional Integer Informar a quantidade de dias que o avaliador possui para executar a avaliação de eficácia.
Será utilizada para a contagem do prazo, que inicia no dia seguinte da data de término do treinamento.

metEfi Opcional Integer Informar a meta para avaliação de eficácia.
É um percentual de 0 a 100 que indica qual percentual mínimo dos avaliadores devem avaliar evento como eficaz para o evento como um todo ser considerado eficaz.

praARe Opcional Integer Informar a quantidade de dias que o participante possui para responder a avaliação de reação.
Será utilizada para a contagem do prazo, que inicia no dia seguinte da data de término do treinamento.

tipRea Opcional Integer Informar a forma de realização do curso de aperfeiçoamento. Exemplos:

Interno
Externo Aberto
Externo Fechado
Efeito Multiplicador Externo Fechado
Efeito Multiplicador Externo Aberto
No Exterior - Aberto
No Exterior - Fechado
E-Learning Síncrono
E-Learning Assíncrono


-Obrigatório
turCua Opcional String Informar o período de realização do curso, conforme abaixo:

M - Matutino
V - Vespertino
N - Noturno
D - Diurno


-Obrigatório
codFlt Opcional Integer Informar o código da regra a ser utilizado em cada curso de aperfeiçoamento, para pré-requisitos não previstos pelo sistema.

regInc Opcional Integer Informar o código da regra que será utilizada na Inclusão de participantes e/ou integrantes da lista de espera.
Esta regra somente terá validade para a versão WEB.

regExc Opcional Integer Informar o código da regra que será utilizada na exclusão de participantes e/ou integrantes da lista de espera.
Esta regra somente terá validade para a versão WEB.

regTrf Opcional Integer Informar o código da regra que será utilizada na transferência de participantes desta turma para a lista de espera de uma outra turma.
Esta regra terá validade somente na versão WEB.

regSub Opcional Integer Informar o código da regra que será utilizada na substituição de participante para este curso/turma.
Esta regra terá validade somente na versão WEB.

O substituto ficará relacionado na lista de espera da turma do substituído e este será excluído da sua turma voltando para a lista de espera.


perRsv Opcional String Informar quem possui permissão para efetuar reservas em cursos de aperfeiçoamento:

T - Todos
C - Coordenador do Curso

Se informar T=Todos, qualquer pessoa da empresa poderá efetuar reserva em cursos de aperfeiçoamento, caso informar C=Coordenador do Curso, somente o coordenador indicado na tela do Curso de Aperfeiçoamento poderá efetuar esta reserva.


-Obrigatório
codUsu Opcional Integer Informar o código do coordenador do curso.
Existe uma associação entre o código de usuário e um colaborador cadastrado (empregado, terceiro ou parceiro) através da ficha cadastral.


desCon Opcional String Espaço para registro do conteúdo programático de cada curso.

desObu Opcional String Espaço para registrar os objetivos de cada curso.


metCua Opcional String Espaço para registrar a metodologia utilizada ou exigida para o curso.


pubAlv Opcional String Espaço para informar o público alvo do curso.


nomArq Opcional String Espaço para informar caminho do arquivo


conWeb Opcional String Considerar no preenchimento do currículo Web.
Este campo só está disponível no módulo RS.


conPdi Opcional String Define se o curso será considerado na rotina de Plano de Desenvolvimento Individual (PDI).
Apenas poderá informar 'S' quando o assunto associado ao curso de aperfeiçoamento estiver cadastrado com o campo Auxilia Avaliação = 'S'.


criRep Opcional Integer Define se a reprovação será por média ou frequência quando ambas estiverem abaixo do mínimo.

0 - Reprovar por média
1 - Reprovar por frequência


datExp Opcional DateTime - Permite informar a data de expiração do curso.

- Ao alterar, a data de expiração não deve ser inferior a data de início ou térnmino do curso.

curTlt Opcional Integer - Permite informar se o curso será um TLT.

1 - Sim
2 - Não

abrLoc Opcional String - Permite especificar a abrangência dos locais que utilizam o TLT.

Obs: Somente ficará habilitado caso o campo Treinamento Local Trabalho esteja com "1".

avaTlt Opcional Integer - Permite informar se o TLT terá avaliação.

Obs: Somente ficará habilitado caso o campo Treinamento Local Trabalho esteja com "1".

1 - Sim
2 - Não

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:CursosAperfeicoamento_2Response>
      <result>
        <codCua>Integer</codCua>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:CursosAperfeicoamento_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.
codCua Opcional Integer Código do curso de aperfeiçoamento.

- Chave

Observações:
Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre.

Este artigo ajudou você?