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

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

Cargo_5

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

**Necessita autenticação: **Sim

**Situação de versão: ** Atual

**Versão: **5

**Requisição: **

<soapenv:Envelope xmlns:ser=“http://services.senior.com.br” xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/”> <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> <tipMot>Integer</tipMot> </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[100]

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.

tipMot

Opcional

Integer

Informar quando se tratar de um cargo do Tipo Motorista. Caso não seja, pode ser deixado como “0” ou “1 - Não aplicável”.

Aplica-se apenas ao uso da rotina de motoristas no CP.

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:Cargo_5Response> <result> <erroExecucao>String</erroExecucao> </result> </ser:Cargo_5Response> </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ê?