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

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

EquipamentosHabilitacao

Através deste web service, nos é permitido informar habilitações de equipamentos para as rotinas de segurança.

**Necessita autenticação: **Sim

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

**Versão: **1

**Requisição: **

<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:EquipamentosHabilitacao> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <tipEqp>Integer</tipEqp> <codEqp>Integer</codEqp> <datIni>String</datIni> <necTre>String</necTre> <necExa>String</necExa> <datTer>String</datTer> <obsHab>String</obsHab> <tipOpe>String</tipOpe> </parameters> </ser:EquipamentosHabilitacao> </soapenv:Body> </soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

numEmp

Obrigatório

Integer

Código da empresa



  • Chave

tipCol

Obrigatório

Integer

Informar o tipo de colaborador, que poderá ser::



  • Edição 9[1]

  • 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


  • Edição 9[9]

tipEqp

Obrigatório

Integer

Tipo do equipamento


  • Campo obrigatório

  • Edição 9[3]

codEqp

Obrigatório

Integer

Código do equipamento


  • Campo obrigatório


A pesquisa desse campo somente apresentará os equipamentos que não são EPC.


Ao sair desse campo somente permitirá passar para o próximo campo se o equipamento não for EPC.



  • Edição 9[6]

datIni

Obrigatório

DateTime

Data de inicio


  • Campo obrigatório

  • Edição DD/MM/YYYY

necTre

Opcional

String

Informa se é treinamento



Se informar S-Sim, consiste com os cursos informados no cadastro de equipamento


(guia Cursos de Aperfeiçoamento) e do cadastro do colaborador, considerando a validade do curso


(constante no cadastro do curso).


Caso o colaborador não tenha feito ou falte a conclusão de algum curso, o sistema apresenta mensagem mas permite a continuação do cadastro.



ão


  • Edição U[1]

necExa

Opcional

String

Informa se é exame



Se informar S-Sim, para todos os exames indicados no cadastro do equipamento


(tabela R098EXA) verifica se possui resultado de exame válido conforme os meses indicados e se o


parecer é considerado normal.


Caso tenha algum exame que não foi feito ou tenha o parecer diferente de Normal,


o sistema apresenta mensagem mas permite a continuação do cadastro.




  • Edição U[1]

datTer

Opcional

DateTime

Data de término.



Não pode ser maior que a menor data de validade dos exames ou dos cursos.


A validade dos exames é obtida da paleta Exames da tela de cadastro de Equipamentos e deve ser somada a data de realização do exame.


Os cursos também possuem validade.


No cadastro de cursos (Tabelas\Cursos\Aperfeiçoamento) existe um campo para informar a validade (R128CUA.ValCua).


O sistema somente deve considerar a validade de Cursos quando o campo Treinamento estiver com valor S-Sim e a validade dos exames somente deve ser considerada quando o campo Exames estiver com valor S-Sim.




  • Edição DD/MM/YYYY

obsHab

Opcional

String

Observações sobre o registro inserido




  • Edição A[80]

tipOpe

Opcional

String

Tipo da operação a ser efetuada na integração



“I” - Inclusão


“A” - Alteração


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

Este artigo ajudou você?