Web service com.senior.g5.rh.tr.cursoaperfeicoamento
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/tr_Synccom_senior_g5_rh_tr_cursoaperfeicoamento?wsdl
- Assíncrono: http://example.com/g5-senior-services/tr_Asynccom_senior_g5_rh_tr_cursoaperfeicoamento?wsdl
- Agendado: http://example.com/g5-senior-services/tr_Scheduledcom_senior_g5_rh_tr_cursoaperfeicoamento?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 | Obrigatório | 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 | Opcional | 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:
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: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. |