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

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

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:

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

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.