Web service com.senior.g5.rh.hr.matriculaesocial

Web service que permite cadastrar, alterar e excluir a matrícula dos colaboradores no eSocial.

Disponível nos módulos CP e SM.

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(s)

MatriculaESocial

MatriculaESocial

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Versão atual: 1.

Requisição:

<soapenv:Envelope xmlns:ser=“http://services.senior.com.br” xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/”>
<soapenv:Body>
<ser:MatriculaESocial>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<numEmp>Integer</numEmp>
<tipCol>Integer</tipCol>
<numCad>Integer</numCad>
<matEso>String</matEso>
<tipOpe>String</tipOpe>
</parameters>
</ser:MatriculaESocial>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome	Preenchimento	Tipo	Descrição
numEmp	Obrigatório	Integer	Código da empresa que será utilizado na integração. Chave
tipCol	Obrigatório	Integer	Informar o tipo de colaborador. Chave Valores 1 - Empregado; 2 - Terceiro; 3 - Parceiro.
numCad	Obrigatório	Integer	Informar o número de cadastro do colaborador, terceiro ou parceiro. Chave
matEso	Opcional	String	Matrícula do colaborador no eSocial. - Máscara: A[30]
tipOpe	Opcional	String	Tipo da operação a ser efetuada na integração: “I” - Inclusão; “A” - Alteração; “E” - Exclusão. Se não o parâmetro for informado, será considerado como “A” - Alteração.

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:ser=“http://services.senior.com.br” xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/”>
<soapenv:Body>
<ser:MatriculaESocialResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:MatriculaESocialResponse>
</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.

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