Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Administração de Pessoal > Com.senior.g5.rh.fp.cadastro.estagiario

Web service com.senior.g5.rh.fp.cadastro.Estagiario

Este web service serve para o cadastro de estagiários.

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

Síncrono: http://servidor:1234/g5-senior-services/rubi_Synccom_senior_g5_rh_fp_cadastro?wsdl
Assíncrono: http://servidor:1234/g5-senior-services/rubi_Asynccom_senior_g5_rh_fp_cadastro?wsdl
Agendado: http://servidor:1234/g5-senior-services/rubi_Schedulecom_senior_g5_rh_fp_cadastro?wsdl

Porta

Estagiario

Necessita autenticação: Sim

Situação da versão: Atual

Versão: 1

Versão atual: 1

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Estagiario>
      <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:Estagiario>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

registro

Opcional

Set

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

registro.sequencia

Opcional

Integer

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

campo

Opcional

Set

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 Colaborador	Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro
numCad	Sim	Sim	Número	9	-	Código Colaborado	-
datRef	Sim	Sim	Data	10	DD/MM/YYYY	Data de Referência	-
natEtg	Não	Sim	Alfa	1	-	Natureza do Estágio	Valores: O - Obrigatório N - Não Obrigatório
nivEtg	Não	Sim	Número	1	-	Nível do Estágio	Valores: 1 - Fundamental 2 - Médio 3 - Formação Profissional 4 - Superior 8 - Especial 9 - Mãe social. (Lei 7644, de 1987)
areAtu	Não	Não	Alfa	50	-	Área de atuação do estagiário	-
apoSeg	Não	Não	Alfa	30	-	Apólice de seguro	-
valBol	Não	Não	Double	13,4	9,9999	Valor da Bolsa	Caso não informado, será sugerido o salário corrente do colaborador.
preTer	Não	Sim	Data	10	DD/MM/YYYY	Data prevista para o término do estágio	-
insEns	Não	Sim	Número	8	-	Instituição de Ensino	No cadastro de outra empresa, a instituição de ensino deverá ter um dos seguintes tipos de uso: 3, 12, 14, 16.
ageInt	Não	Não	Número	8	-	Agente de Integração	No cadastro de outra empresa, o agente de integração deverá ter o seguinte tipo de uso: 19.
empCoo	Não	Não	Número	4	-	Empresa do Supervisor	-
tipCoo	Não	Não	Número	1	-	Tipo Supervisor	-
numCoo	Não	Não	Número	9	-	Cadastro do Supervisor	-
numCoo	Não	Não	Alfa	70	-	Nome do Supervisor	Caso não informado, será sugerido de acordo com as informações do supervisor informadas.
cpfCoo	Não	Não	Alfa	14	999.999.999-99	Número do CPF do Supervisor	Caso não informado, será sugerido de acordo com as informações do supervisor informadas.

campo.nome

Opcional

String

Nome do campo.

campo.valor

Opcional

String

Valor referente ao campo informado.

campo.status

Opcional

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

Opcional

String

Mensagem de consistência do campo. Se o valor consistente, retornará OK. Caso contrário, retornará a mensagem de erro.

status.codigo

Opcional

String

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

Opcional

String

Mensagem de retorno da operação. Se a operação for executada corretamente, retornará OK. Caso contrário, retornará a mensagem de erro.

operacao

Opcional

String

Informe a operação que se deseja realizar:
I = Inserir
A = Alterar
E = Excluir

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:EstagiarioResponse>
      <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:EstagiarioResponse>
  </soapenv:Body>
</soapenv:Envelope>

Atributos da resposta:

Nome	Preenchimento	Tipo	Descrição
registro	Opcional	Set	Cada ocorrência deste elemento representa uma operação a ser executada pelo sistema.
registro.sequencia	Opcional	Integer	Identificador para facilitar a recuperação do resultado. Deve ser informado pelo solicitante.
campo	Opcional	Set	Repete os campos enviados na requisição, com um retorno para cada um. Cada ocorrência deste elemento representa um campo.
campo.nome	Opcional	String	Nome do campo.
campo.valor	Opcional	String	Valor referente ao campo informado.
campo.status	Opcional	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	Opcional	String	Mensagem de consistência do campo. Se o valor consistente, retornará OK. Caso contrário, retornará a mensagem de erro.
status	Opcional	Set	Mensagens de retorno da operação. Cada ocorrência deste elemento representa uma mensagem de retorno.
status.codigo	Opcional	String	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	Opcional	String	Mensagem de consistência do campo. Se o valor consistente, retornará OK. Caso contrário, retornará a mensagem de erro.
erroAposExecucao	Opcional	String	-
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 no ocorrido no servidor.

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