Web service com.senior.g5.rh.sm.distribuicaoEPI
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/sm_Synccom_senior_g5_rh_sm_distribuicaoEPI?wsdl
- Assíncrono: http://example.com/g5-senior-services/sm_Asynccom_senior_g5_rh_sm_distribuicaoEPI?wsdl
- Agendado: http://example.com/g5-senior-services/sm_Scheduledcom_senior_g5_rh_sm_distribuicaoEPI?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:
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: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. |