Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Controle de Ponto e Refeitório > Com.senior.g5.rh.hr.cargos

Web service com.senior.g5.rh.hr.cargos

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

Porta

Cargo_4

Web service para manutenção do cadastro de Cargos.

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 4

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Cargo>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <titRed>String</titRed>
        <datAlt>DateTime</datAlt>
        <numEmp>Integer</numEmp>
        <titCar>String</titCar>
        <acuCar>Integer</acuCar>
        <estCar>Integer</estCar>
        <graCpx>String</graCpx>
        <conEsp>Integer</conEsp>
        <codCar>String</codCar>
        <carAlf>String</carAlf>
        <dedExc>String</dedExc>
        <tipOpe>String</tipOpe>
        <codCbo>String</codCbo>
        <leiCar>String</leiCar>
        <codCb2>String</codCb2>
        <datLei>DateTime</datLei>
        <supIme>String</supIme>
        <sitLei>Integer</sitLei>
        <codHie>Integer</codHie>
        <sCTpQu>Integer</sCTpQu>
        <codHwf>Integer</codHwf>
        <horMes>Time</horMes>
        <natDes>Integer</natDes>
        <sisCar>Integer</sisCar>
        <areAtu>Integer</areAtu>
        <datCri>DateTime</datCri>
        <datExt>DateTime</datExt>
        <perFnc>Integer</perFnc>
        <carCom>String</carCom>
        <codSig>String</codSig>
        <carMap>String</carMap>
        <nomArq>String</nomArq>
        <arqCri>String</arqCri>
        <arqExt>String</arqExt>
        <desSum>String</desSum>
        <cnhObr>String</cnhObr>
        <oclObr>String</oclObr>
      </parameters>
    </ser:Cargo>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
titRed Opcional String Nome do cargo, com até 30 posições.
-Obrigatório
- Máscara: A[30]
datAlt Opcional DateTime Indicar a data de alteração do cargo de órgão público.

- Máscara: DD/MM/YYYY


Observação:

Se o tipo de operação for "E" (Exclusão) e somente este campo for preenchido, somente será excluído o registro referente a guia "Orgão Público" da tela de Cargos.
numEmp Obrigatório Integer Código da empresa que será utilizado na integração
- Obrigatório
- Chave
- Máscara: 9[4]
titCar Opcional String Informar o nome completo do cargo, sem abreviações.
Não é utilizado no Módulo: PLR
- Opcional
- Máscara: A[60]
acuCar Opcional Integer Preencher com o código correspondente à possibilidade de acumulação de cargos:
1 - Não acumulável;
2 - Profissional de Saúde;
3 - Professor;
4 - Técnico/Científico.
Valores Válidos: 1, 2, 3, 4.

- Máscara: 9
estCar Obrigatório Integer Código da Estrutura de Cargos
- Campo Chave
- Obrigatório
- Máscara: 9[4]
graCpx Opcional String Informar o código da complexidade do cargo, podendo ser: B-Baixa, M-Média ou E-Elevada.
De acordo com a complexidade é possível definir os requisitos de treinamento, escolaridade e outros.
Não é utilizado nos Módulos: BS, JR, QL, PLR, RS, TR, AP, SM)
- Opcional
- Máscara: U[1]
conEsp Opcional Integer Preencher com o código correspondente a possibilidade de contagem de tempo especial:
1 - Não;
2 - Professor (Infantil, Fundamental e Médio);
3 - Professor de Ensino Superior, Magistrado, Membro de Ministério Público, Membro do Tributnal de Contas (com ingresso anterior a 16/12/2008 EC nr. 20/98).
Valores Válidos: 1, 2, 3.

- Máscara: 9
codCar Obrigatório String Informar o código do cargo.
- Obrigatório
- Chave
- Máscara: U[24]
carAlf Opcional String Se a empresa utiliza códigos alfanuméricos no cadastro dos cargos, preencha este dado.

Não é utilizado nos Módulos: BS, JR, QL, PLR, RS, TR, AP, SM.

- Máscara: A[10]
dedExc Opcional String Indicar se é cargo de dedicação exclusiva:
S - Sim;
N - Não.
Valores Válidos: S, N

- Máscara: U
tipOpe Opcional String Tipo da operação a ser efetuada na integração
- Obrigatório

"I" - Inclusão
"A" - Alteração
"E" - Exclusão

Se não for informado, será considerado "inclusão"
codCbo Opcional String Informar o código deste cargo, de acordo com o Código Brasileiro de Ocupações.
Não é utilizado no Módulo: PLR
- Máscara: A[5]
leiCar Opcional String Número da Lei que criou/extingiu/reestruturou o cargo

- Máscara: A[12]
codCb2 Opcional String Informar o código deste cargo, de acordo com o Código Brasileiro de Ocupações.
- Máscara: A[6]
datLei Opcional DateTime Data da Lei que criou/extingiu/reestruturou o cargo

- Máscara: DD/MM/YYYY
supIme Opcional String Informar o código do cargo hierarquicamente superior ao cargo que está sendo cadastrado.
Não é utilizado nos Módulos: RS, BS, AP, SM

- Máscara: A[24]
sitLei Opcional Integer Situação gerada pela Lei. Preencher com uma das opções:
1 - Criação;
2 - Extinção;
3 - Reestruturação.
Valores Válidos: 1, 2, 3

- Máscara: 9
codHie Opcional Integer Indicar a qual nível hierárquico pertence o cargo.
Exemplo: chefia, supervisão, gerência.

Não é utilizado nos Módulos: BS, PLR, AP, SM.
- Máscara: 9[3]
sCTpQu Opcional Integer Tipo de Quadro para o e-Sfinge de Santa Catarina.

- Opções:
1 - Quadro Geral
2 - Quadro Específico
3 - Quadro Especial
codHwf Opcional Integer É através deste campo que o fluxo irá definir o nível hierárquico de um determinado usuário.
É através deste nível hierárquico que o fluxo toma a decisão de encerrar uma solicitação ou de criar uma pendência para o superior imediato do usuário que está fazendo o tratamento atual.
- Máscara: 9[3]
horMes Opcional Time Informar a quantidade de horas contratuais para este cargo.

Este campo só fica disponível se a empresa Controlar Horas Contratuais. Assinalamento disponível no cadastro da emrpesa.

Este campo só é exibido nos módulos CS e AP.

- Máscara: hhh:mm
natDes Opcional Integer Indicar a natureza de despesa do cargo.

- Máscara: 9[2]
sisCar Opcional Integer Efetua uma classificação dos cargos, através do tipo de Sistema de Cargos.
Não é utilizado nos Módulos: JR, PLR, SM
- Máscara: 9[2]
areAtu Opcional Integer Informar a área de atuação do cargo. Exemplo: Diretoria, Gerência, Supervisão, etc.

Utilizado somente no Módulo: RS

- Máscara: 9[3]
datCri Opcional DateTime Indicar a data de criação do cargo.

Não é utilizado nos Módulos: QL, PLR

- Máscara: DD/MM/YYYY
datExt Opcional DateTime Indicar a data de extinção do cargo.

Não é utilizado nos Módulos: QL, PLR

- Máscara: DD/MM/YYYY
perFnc Opcional Integer Informar o percentual que será considerado no cálculo do adicional de função.

Somente utilizado no Módulo: Administração de Pessoal

- Máscara: zzz9,99999
carCom Opcional String Este campo somente estará disponível quando na tela de Definições de Segurança estiver definido que a "Apresentação da Função" é conforme a definição do Cargo.

Somente está disponível nos módulos SM, CS e AP

Nos módulos CS e AP, o campo somente aparecerá se o módulo Segurança estiver integrado.

Valores:
- S = Sim
- N = Não

- Máscara: U[1]
codSig Opcional String Informar a sigla do conselho profissional referente ao cargo.

- Máscara: A[7]
carMap Opcional String Informar o código do cargo correspondente no sistema MAP (Mapeamento de Aptidão Comportamental).

Utilizado somente nos módulos: RS, CS

- Máscara: A[15]
nomArq Opcional String Informar um caminho para um arquivo. Este será aberto ao clicar no botão Descrição, no rodapé da tela.

- Máscara: A[250]
arqCri Opcional String Este campo possibilita anexar um arquivo ao cadastro do cargo. O arquivo informado neste campo poderá ser aberto através do botão Criação existente no rodapé da tela.

Disponível apenas no CS e RS

- Máscara: A[250]
arqExt Opcional String Este campo possibilita anexar um arquivo ao cadastro do cargo. O arquivo informado neste campo poderá ser aberto através do botão Extinção existente no rodapé da tela.

Disponível apenas no CS e RS.

Apenas habilitado quando houver cadastrada data de extinção do cargo.

- Máscara: A[250]
desSum Opcional String Neste campo pode ser acrescentada uma breve descrição sobre o cargo.

- Máscara: A[2000]
cnhObr Opcional String Informar se é obrigatório possuir CNH para ocupar o cargo.
oclObr Opcional String Informar se é obrigatório informar Órgão de Classe.

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

Este artigo ajudou você?