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

Este web service serve para inclusão/alteração/exclusão de instrutores em históricos de cursos previamente cadastrados.

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

InstrutoresCursoAperfeicoamentoColaborador

**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:InstrutoresCursoAperfeicoamentoColaborador>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<registro>
<sequencia>Integer</sequencia>
<campo>
<nome>String</nome>
<valor>String</valor>
<status>Integer</status>
<mensagem>String</mensagem>
</campo>
<status>
<codigo>String</codigo>
<mensagem>String</mensagem>
</status>
</registro>
<operacao>String</operacao>
</parameters>
</ser:InstrutoresCursoAperfeicoamentoColaborador>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

operação

Obrigatório

String

Informe a operação que se deseja realizar:

I = Inserir

A = Alterar

E = Excluir

registro

Obrigatório

Set

Cada ocorrência deste elemento representa uma operação a ser executada pelo sistema.

registro.sequencia

Obrigatório

Integer

Identificador para facilitar a recuperação do resultado. Deve ser informado pelo solicitante.

campo

Obrigatório

Set

Campos da tabela Colaborador - Cursos Aperfeiçoamento - Profissionais Responsáveis (R124PCR) que serão utilizados na operação.

Cada ocorrência deste elemento representa um campo.

Nome	Chave	Obr.	Tipo	Tamanho	Máscara	Descrição	Observações
NUMEMP	Sim	Sim	Número	4		Código da empresa
TIPCOL	Sim	Sim	Número	1		Tipo do colaborador
NUMCAD	Sim	Sim	Número	9		Número do cadastro do colaborador
CODCUA	Sim	Sim	Número	9		Código do Curso
SEQHCR	Sim	Sim	Número	6		Sequência do Curso Aperfeiçoamento
CPFPRO	Sim	Sim	Número	11	999.999.999-99	CPF do profissional
NOMPRO	Não	Sim	Alfa	70		Nome do Profissional responsável pelo treinamento/capacitação
TIPPRO	Não	Sim	Número	1		Tipo do profissional responsável pelo treinamento/capacitação Profissional empregado do declarante; Profissional sem vínculo de emprego/estatutáiro com o declarante.
MATPRO	Não	Não	Alfa	30		Matrícula do Profissional responsável pelo treinamento/capacitação	Obrigatório quando TIPPRO for igual a 1, caso contrário não deve ser informado.
FORPRO	Não	Não	Alfa	255		Formação do Profissional responsável pelo treinamento/capacitação
CODCBO	Não	Sim	Número	6		CBO	Deve existir na tabela CBOs (R024CB2)
INDNAC	Não	Sim	Número	1		Indicativo de Nacionalidade Brasileiro; 2)Estrangeiro

Observação:

campos de usuário não são suportados.

campo.nome

Opcional

String

Nome do campo

campo.valor

Opcional

String

Valor do campo

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:InstrutoresCursoAperfeicoamentoColaboradorResponse>
<result>
<registro>
<sequencia>Integer</sequencia>
<campo>
<nome>String</nome>
<valor>String</valor>
<status>Integer</status>
<mensagem>String</mensagem>
</campo>
<status>
<codigo>String</codigo>
<mensagem>String</mensagem>
</status>
</registro>
<erroAposExecucao>String</erroAposExecucao>
<erroExecucao>String</erroExecucao>
</result>
</ser:InstrutoresCursoAperfeicoamentoColaboradorResponse>
</soapenv:Body>
</soapenv:Envelope>

Atributos da resposta:

Nome	Preenchimento	Tipo	Descrição
registro	Obrigatório	Set	Repete as operações enviadas na requisição, com o retorno para cada uma. Cada ocorrência deste elemento representa uma operação.
registro.sequencia	Obrigatório	Integer	Identificador para facilitar a recuperação do resultado.
campo	Obrigatório	Set	Repete os campos enviados na requisição, com um retorno para cada um. Cada ocorrência deste elemento representa um campo.
campo.nome	Obrigatório	String	Nome do campo.
campo.valor	Obrigatório	String	Valor referente ao campo informado.
Campo.Status	Obrigatório	Integer	Status do retorno da requisição ao web service. 0: OK 1: Consistência de negócio 2: Consistência customizados 3: Erro nos campos 4: Erro não mapeado 5: Registro inexistente 6: Parâmetro inválido 7: Aviso 8: Registro já cadastrado
campo.mensagem	Obrigatório	String	Mensagem de consistência do campo. Se o valor estiver consistente retornará OK. Caso o contrário, retornará a mensagem de erro.
status	Obrigatório	Set	Mensagens de retorno da operação. Cada ocorrência deste elemento representa uma mensagem de retorno.
status.codigo	Obrigatório	Integer	Código da mensagem. 0: OK 1: Consistência de negócio 2: Consistência customizados 3: Erro nos campos 4: Erro não mapeado 5: Registro inexistente 6: Parâmetro inválido 7: Aviso 8: Registro já cadastrado
status.mensagem	Obrigatório	Integer	Mensagem de retorno da operação. Se a operação for executada corretamente retornará OK. Caso o contrário, retornará a mensagem de erro.

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