Web service com.senior.g5.rh.sm.distribuicaoEPI

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

Distribuir

Web service usado para cadastrar a distribuição de EPIs.

**Necessita autenticação: **Sim

**Situação de versão: ** Atual

**Versão: **2

**Requisição: **

<soapenv:Envelope xmlns:ser=“http://services.senior.com.br” xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/”>
<soapenv:Body>
<ser:Distribuir>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<tipOpe>String</tipOpe>
<numEmp>Integer</numEmp>
<tipCol>Integer</tipCol>
<numCad>Integer</numCad>
<codEpi>Integer</codEpi>
<datEnt>DateTime</datEnt>
<seqDie>Integer</seqDie>
<cerApr>String</cerApr>
<medEpi>String</medEpi>
<codOem>Integer</codOem>
<qtdEnt>Integer</qtdEnt>
<datDev>DateTime</datDev>
<qtdDev>Integer</qtdDev>
<qtdDan>Integer</qtdDan>
<insUso>String</insUso>
<assPro>String</assPro>
<codMtv>Integer</codMtv>
<obsDis>String</obsDis>
</parameters>
</ser:Distribuir>
</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. Valores: I - Inclusão A - Alteração E - Exclusã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	Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro. Chave
codEpi	Obrigatório	Integer	Informar o código do EPI a ser entregue. Chave
datEnt	Obrigatório	DateTime	Informar a data de entrega do EPI, para manter um histórico. Chave Máscara: DD/MM/YYYY
seqDie	Obrigatório	Integer	Informe a sequência de entrega do EPI na mesma data.
cerApr	Opcional	String	Informar o código do Certificado de Aprovação. Observação: O campo deve ser informado quando a tela de Distribuição de EPI está configurada para utilizar o Certificação Aprovação.
medEpi	Opcional	String	Informar o tamanho de EPI usado pelo colaborador.
codOem	Opcional	Integer	Informar o código do fornecedor do EPI. Observações: Somente será permitido informar o EPI que estiver previamente informado na pasta Fornecedores do cadastro do EPI. Esta informação é obrigatória quando o controle de saldo do EPI estiver relacionado ao fornecedor. Ao alterar o fornecedor de uma distribuição de EPI, será ajustado o saldo de seu estoque e também para aquele EPI de outro fornecedor ou EPI sem fornecedor.
qtdEnt	Obrigatório	Integer	Informar a quantidade de EPIs entregues ao colaborador nesta data.
datDev	Opcional	DateTime	Informar a data da devolução do EPI. Máscara: DD/MM/YYYY Observação: Para EPIs do mesmo grupo de equivalência que foram distribuídos na mesma data, não serão considerados na busca pelo EPI anterior pois a data de entrega sempre deve ser menor. Para informar a data de devolução nestes EPIs, deverá ser feito manualmente se necessário for. Ex: Grupo EPI 1: Epi: 1 - Luva 1 Dt.Entrega: 01/01/2000 Dt.Devolução: 07/08/2007 Grupo EPI 1: Epi: 1 - Luva 1 Dt.Entrega: 07/08/2007 Dt.Devolução: 00/00/0000 Grupo EPI 1: Epi: 2 - Luva 2 Dt.Entrega: 07/08/2007 Dt.Devolução: 00/00/0000 Somente buscará o EPI anterior quando a data de entrega for MENOR Ex: Grupo EPI 1: Epi: 1 - Luva 1 Dt.Entrega: 07/08/2007 Dt.Devolução: 17/08/2007 Grupo EPI 1: Epi: 1 - Luva 1 Dt.Entrega: 17/08/2007 Dt.Devolução: 00/00/0000 Se existir mais de um EPI na mesma data de entrega e com devolução zerada, a data de devolução será preenchida nos registros com a data de entrega também.
qtdDev	Opcional	Integer	Informar a quantidade de EPI devolvidos na data. Observações: Só poderá ser informado caso for informado uma data de devolução.
qtdDan	Opcional	Integer	Informar a quantidade de EPI devolvidos na data. Observações: Só poderá ser informado caso for informado uma data de devolução.
insUso	Obrigatório	String	Quanto ao treinamento exigido para orientar o melhor uso do EPI. Valores: S - Já foi treinado N - Não teve treinamento
assPro	Obrigatório	String	Quanto ao controle de entrega do EPI. Valores: S - Sim, assinou o protocolo de entrega. N - Não, recebeu o EPI sem assinar o protocolo.
codMtv	Obrigatório	Integer	Informar o motivo da distribuição do EPI.
obsDis	Opcional	String	Espaço reservado para qualquer informação adicional referente a distribuição de EPI.

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