Web service com.senior.g5.rh.sm.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
- Síncrono: http://example.com/g5-senior-services/sm_Synccom_senior_g5_rh_sm_cursos?wsdl
- Assíncrono: http://example.com/g5-senior-services/sm_Asynccom_senior_g5_rh_sm_cursos?wsdl
- Agendado: http://example.com/g5-senior-services/sm_Scheduledcom_senior_g5_rh_sm_cursos?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:
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. |