Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Treinamento e Pesquisa > Com.senior.g5.rh.tr.cargos

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_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

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_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.

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