Web service com.senior.g5.rh.tr.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
- Síncrono: http://example.com/g5-senior-services/tr_Synccom_senior_g5_rh_tr_cargos?wsdl
- Assíncrono: http://example.com/g5-senior-services/tr_Asynccom_senior_g5_rh_tr_cargos?wsdl
- Agendado: http://example.com/g5-senior-services/tr_Scheduledcom_senior_g5_rh_tr_cargos?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. |