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

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

AssuntosDeCurso

Através deste web service, nos é permitido informar os cursos de aperfeiçoamento 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:AssuntosDeCurso>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<numEmp>Integer</numEmp>
<tipCol>Integer</tipCol>
<numCad>Integer</numCad>
<codCua>Integer</codCua>
<nomCua>String</nomCua>
<seqHcr>Integer</seqHcr>
<perIni>DateTime</perIni>
<perFim>DateTime</perFim>
<codOem>Integer</codOem>
<nomOem>String</nomOem>
<sitCua>Integer</sitCua>
<codMin>Integer</codMin>
<idiCua>String</idiCua>
<tipCer>String</tipCer>
<carHor>Time</carHor>
<medCua>Double</medCua>
<freCua>Double</freCua>
<fasCua>String</fasCua>
<idiLei>String</idiLei>
<idiEsc>String</idiEsc>
<idiCon>String</idiCon>
<oriHcr>String</oriHcr>
<tmaCua>Integer</tmaCua>
<comCua>String</comCua>
<tipOpe>String</tipOpe>
<tipTre>Integer</tipTre>
</parameters>
</ser:AssuntosDeCurso>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
numEmp	Obrigatório	Integer	Código da empresa que será utilizado na integração Chave
tipCol	Obrigatório	Integer	Informar o tipo de colaborador, que poderá ser:: Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro -Edição 9[4]
numCad	Obrigatório	Integer	Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro. Chave Edição 9[9]
codCua	Obrigatório	Integer	Número (código) do curso. Campo obrigatório Edição 9[9]
nomCua	Opcional	String	Nome do curso O campo Nome do curso (NomCua) somente será habilitado quando o curso informado for o padrão (R000ASS.CUADEF).
seqHcr	Obrigatório	Integer	Informar a sequência de curso dentro do histórico de cursos de aperfeiçoamento. Esta sequência tem como objetivo permitir o cadastramento de históricos com a data de início zerada. Existe uma consistência para impedir o cadastramento de mais de uma sequência para o mesmo curso com a mesma data de início. Campo obrigatório Edição 9[4]
perIni	Opcional	DateTime	Data de início do período Máscara: DD/MM/YYYY
perFim	Opcional	DateTime	Data fim do período Máscara: DD/MM/YYYY
codOem	Opcional	Integer	Informar o código da entidade ou escola promotora do curso. Esta entidade deverá estar cadastrada em Empresas/Outras Empresas com indicador de uso 3,12,14 e 16 (Entidades de Ensino). -Opcional -Edição 9[8]
nomOem	Obrigatório	String	Nome da entidade O campo Entidade (NomOem) somente será habilitado quando o curso informado for o padrão (R000ASS.ENTDEF). -Opcional -Edição A[60]
sitCua	Opcional	Integer	Registrar em que situação encontra-se o colaborador no curso, conforme abaixo: 1 Andamento 2 Completo 3 Desistente 4 Suspenso temporariamente 5 Reprovado média 6 Reprovado frequência 8 Transferido -Obrigatório -Edição 9[2]
codMin	Opcional	Integer	Informar o motivo que levou a interrupção do curso. Este motivo pode ser por iniciativa da empresa ou do participante. Este campo ficará habilitado para os tipos de situação 3-Desistente, 4-Suspenso Temporariamente e 8-Transferido. -Opcional -Edição 9[3]
idiCua	Opcional	String	Forma de aquisição do Curso, conforme abaixo: C Curso T Teste de suficiência E Experiência O Outros -Obrigatório -Edição U[1]
tipCer	Opcional	String	Informar o tipo de certificado: A Aproveitamento P Participação -Opcional -Edição U[1]
carHor	Opcional	Time	Informar a carga horária do curso. -Opcional -Number(010]
medCua	Opcional	Double	Informar a média de aprovação do curso. -Opcional -Edição zz9,99
freCua	Opcional	Double	Informar a frequência no curso. -Opcional -Edição zz9,99
fasCua	Opcional	String	Informar a fase em que se encontra o colaborador. Esta fase deverá ser cadastrada na pasta Fases em Tabelas>Cursos>Curso Aperfeiçoamento. -Opcional -Edição A[3]
idiLei	Opcional	String	Identificar o nível de conhecimento com relação à leitura: N Não conhece R Razoável B Bem Os campos “Leitura”, “Escrita” e “Conversação”, da guia “Aperfeiçoamento”, estarão disponíveis somente quando o curso de aperfeiçoamento for do tipo “Idiomas” -Opcional -Edição U[1]
idiEsc	Opcional	String	Identificar o nível de conhecimento com relação à escrita: N Não conhece R Razoável B Bem Os campos “Leitura”, “Escrita” e “Conversação”, da guia “Aperfeiçoamento”, estarão disponíveis somente quando o curso de aperfeiçoamento for do tipo “Idiomas” -Opcional -Edição U[1]
idiCon	Opcional	String	Identificar o nível de conhecimento com relação à conversação: N Não conhece R Razoável B Bem Os campos “Leitura”, “Escrita” e “Conversação”, da guia “Aperfeiçoamento”, estarão disponíveis somente quando o curso de aperfeiçoamento for do tipo “Idiomas” -Opcional -Edição U[1]
oriHcr	Opcional	String	Identifica qual a origem do curso: D Digitado - este histórico foi digitado pelo usuário A Auxílio - este histórico foi proveniente da rotina de auxílio T Treinamento - este histórico foi proveniente da rotina de treinamento - turmas Os campos “Origem” e “Turma”, da guia “Aperfeiçoamento”, não estão disponíveis. -Opcional -Edição U[1]
tmaCua	Opcional	Integer	Apresenta o código da turma correspondente ao histórico de curso. Os campos “Origem” e “Turma”, da guia “Aperfeiçoamento”, não estão disponíveis. -Opcional -Edição 9[6]
comCua	Opcional	String	Espaço destinado para o registro de comentários inerentes ao curso de aperfeiçoamento. -Opcional -Edição A[250]
tipOpe	Opcional	String	Tipo da operação a ser efetuada na integração “I” - Inclusão “A” - Alteração “E” - Exclusão
tipTre	Opcional	Integer	Tipo Treinamento 1 - Inicial; 2 - Periódico; 3 - Reciclagem; 4 - Eventual; 5 - Outros;

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:AssuntosDeCursoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:AssuntosDeCursoResponse>
</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.

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.

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