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

Tipo de execução

Para cada tipo de execução, existem parâmetros específicos, alguns dos quais podem ser comuns a todas as portas de web service.

Autenticação

Quando for utilizada alguma forma de autenticação na integração de informações por meio de web services, é necessário informar o tipo correspondente no parâmetro <encryption>, conforme os valores possíveis.

WSDL

Porta

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>
<codTce>Integer</codTce>
</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
codTce	Opcional	Integer	Código do treinamento conforme tabela do eSocial. Habilitado somente quando o campo eSocial do cadastro do assunto for igual a S - Sim. Valores: Tabela de códigos de treinamento do eSocial. Máscara: 9[4]

Resposta:

Nota

O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, 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.

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.

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