Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Quadro de Vagas e Orçamento > Com.senior.g5.rh.ql.dependentes

Web service com.senior.g5.rh.ql.dependentes

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/ql_Synccom_senior_g5_rh_ql_dependentes?wsdl
Assíncrono: http://example.com/g5-senior-services/ql_Asynccom_senior_g5_rh_ql_dependentes?wsdl
Agendado: http://example.com/g5-senior-services/ql_Scheduledcom_senior_g5_rh_ql_dependentes?wsdl

Dependente_2

Web service de integração que permite cadastrar informações dos dependentes e familiares dos colaboradores.
Disponível nos módulos BS, JR, QL, RS, AP, SM e TR.

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 2

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Dependente_2>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <tipCol>Integer</tipCol>
        <numCad>Integer</numCad>
        <codDep>Integer</codDep>
        <nomDep>String</nomDep>
        <datNas>String</datNas>
        <nomMae>String</nomMae>
        <graPar>Integer</graPar>
        <tipDep>Integer</tipDep>
        <penJud>String</penJud>
        <tipSex>String</tipSex>
        <numCpf>String</numCpf>
        <estCiv>Integer</estCiv>
        <graIns>Integer</graIns>
        <limIrf>Integer</limIrf>
        <limSaf>Integer</limSaf>
        <datInv>String</datInv>
        <iniTut>String</iniTut>
        <datTut>String</datTut>
        <aviImp>String</aviImp>
        <auxCre>String</auxCre>
        <nomCre>Integer</nomCre>
        <codFic>String</codFic>
        <nomCom>String</nomCom>
        <codFor>Integer</codFor>
      </parameters>
    </ser:Dependente_2>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
tipOpe	Obrigatório	String	Tipo da operação a ser efetuada na integração. - Obrigatório Valores: I - Inclusão A - Alteração E - Exclusão
numEmp	Obrigatório	Integer	Código da empresa que será utilizada na integração. - Obrigatório - Chave
tipCol	Obrigatório	Integer	Informar o tipo de colaborador. - Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro
numCad	Obrigatório	Integer	Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro. - Obrigatório - Chave
codDep	Obrigatório	Integer	Informar o código do dependente. - Obrigatório - Chave
nomDep	Opcional	String	Informar o nome do dependente. - Obrigatório para inclusão
datNas	Opcional	DateTime	Informar a data de nascimento do dependente. - Obrigatório para inclusão Máscara: DD/MM/AAAA * O preenchimento deste campo é obrigatório somente quando existir algum valor nos campos Idade Limite IR ou Idade Limite Salário Família ou quando o Grau de Parentesco for 1, 11, 14, 15, 17 ou 18.
nomMae	Opcional	String	Informar o nome da mãe. - Opcional * Somente disponível nos módulos BS e AP.
graPar	Opcional	Integer	Informar o código de parentesco do dependente. - Obrigatório para inclusão Valores: 1 - Filho(a) 2 - Cônjuge 3 - Pai / Mãe 4 - Avô / Avó 5 - Bisavô / Bisavó 6 - Sobrinho(a) 7 - Tio(a) 8 - Neto(a) 9 - Sogro(a) 10 - Genro / Nora 11- Enteado(a) 12- Irmão(ã) 14 - Filho(a) Adotivo(a) 15 - Pensionistas 16 - Companheiro(a) 17 - Tutelado 18 - Menor sob Guarda 19 - Madrasta 20 - Padrasto 21 - Tutor 26 - Curatelado(a) 99 - Outros
tipDep	Opcional	Integer	Informe o código de parentesco do dependente. Obrigatório para inclusão. Valores: 0 - Não levar Dependente para eSocial 1 - Cônjuge 2 - Companheiro(a) 3 - Filho(a) / Enteado(a) 4 - Irmão(ã) / Neto(a) / Bisneto(a) 5 - Pais / Avós / Bisavós 6 - Menor 7 - Pessoa Incapaz 8 - Filho / Enteado até 24 anos 15- Ex-Cônjuge 99- Agregado / Outros
penJud	Opcional	String	Informar se o dependente em questão deve ser considerado como dependente para cálculo de pensão judicial. - Opcional Valores: S - Sim N - Não
tipSex	Opcional	String	Informar o sexo do dependente. - Obrigatório para inclusão Valores: M - Masculino F - Feminino
numCpf	Opcional	String	Informar o número do CPF do dependente. - Opcional * No caso de informar esta opção assegurar-se que seja um CPF válido. ** Não é utilizado nos Módulos: SM, QL, RS,TR.
estCiv	Opcional	Integer	Informar o estado civil do dependente. - Opcional * Somente disponível no módulo Administração de Pessoal. Valores: 1 - Solteiro 2 - Casado 3 - Separado Judicialmente/Divorciado 4 - Viúvo 5 - Concubinado 6 - Separado 9 - Outros
graIns	Opcional	Integer	Informar o grau de instrução deste dependente, conforme o que fora definido no menu Tabelas/Gerais/Graus de Instrução. - Opcional * Somente disponível no módulo Administração de Pessoal.
limIrf	Opcional	Integer	Informar a idade limite final da dependência do dependente para IR. O módulo cancelará a dependência automaticamente, a partir do mês seguinte em que ele completar esta idade. Quando não houver limite informe 99 e para os que não forem dependentes indicar zeros. - Opcional * Somente disponível nos módulos AP e BS. Valor Padrão: 21
limSaf	Opcional	Integer	Informar a idade limite de dependência para SF. O módulo cancelará a dependência automaticamente, no mês seguinte ao da idade limite. Quando não houver limite informar 99 e para os que não forem dependentes informar zeros. - Opcional * Somente disponível nos módulos AP e BS. * Somente informar se o parâmetro GraPar for 1, 2, 11, 14, 15, 17 ou 18. Valor Padrão: 14
datInv	Opcional	DateTime	Informar a data do atestado de invalidez, quando houver. - Opcional * Somente disponível no módulo Administração de Pessoal. Máscara: DD/MM/AAAA
iniTut	Opcional	DateTime	Informar a data inicial da tutela. - Opcional * Somente informar se o parâmetro GraPar = 17 (Tutelado). * Somente disponível no módulo AP. Máscara: DD/MM/AAAA
datTut	Opcional	DateTime	Informar a data final da tutela. - Opcional * Somente informar se o parâmetro GraPar = 17 (Tutelado). * Somente disponível no módulo Administração de Pessoal. Máscara: DD/MM/AAAA
aviImp	Opcional	String	Informar o controle dos avisos emitidos aos colaboradores que possuem dependentes para salário família e não apresentaram o comprovante de vacinação obrigatória no primeiro ano de vida. - Obrigatório na inclusão * Somente informar se o parâmetro GraPar for 1, 14, 15, 17 ou 18. * Somente disponível no módulo Administração de Pessoal. S - Aviso caderneta de vacinação já emitido N - Aviso ainda não emitido
auxCre	Opcional	String	Indicar se é dependente de creche, em relação a algum benefício concedido pela empresa ou para geração de relatórios. - Opcional * Somente informar se o parâmetro GraPar for algum dos seguintes valores: 1, 6, 8, 11, 14, 15, 17 ou 18. * Somente disponível nos módulos BS e AP. Valores: S - Sim N - Não
nomCre	Opcional	Integer	informar até quantos meses, o dependente é considerado como dependente creche. - Opcional * Somente informar se o parâmetro GraPar for algum dos seguintes valores: 1, 6, 8, 11, 14, 15, 17 ou 18. * Somente disponível nos módulos BS e AP.
codFic	Opcional	String	Definir a geração da ficha médica para o dependente. * Somente informar se for integrado com o módulo SM. Se no SM em Medicina/Definições/Ficha Médica/Gerar Ficha Dependente estiver informado: N - não informar este parâmetro S - informar no parâmetro: AUTO C - informar no parâmetro: CONFIRMA - se quiser gerar a ficha médica CANCELA - se não quiser gerar a ficha médica U - informar no parâmetro: NOVO - se quiser que o SM gere um novo código da ficha médica - senão informe o código da ficha médica que quiser para o dependente
nomCom	Opcional	String	Informar o Nome Completo do Dependentente - Opcional
codFor	Opcional	Integer	informar o Código do Fornecedor. - Opcional Disponível somente no módulo Administração de Pessoal. O campo não está disponível quando a empresa ativa possuir integração com o ERP apenas contábil ou não possuir integração com o ERP.

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

Obito

Web service de integração que permite realizar manutenção na guia Óbito do cadastro de Dependentes.
Disponível nos módulos BS, JR, QL, RS, AP, SM e TR.