Web service com.senior.g5.rh.bs.valesGerados

Web service de histórico de assinalamento de vales gerados. É utilizado quando o assinalamento Usa Histórico de Vales Gerados no cadastramento da empresa for igual a “S”.

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)

Assinalamentos

Web service de Histórico de Assinalamento de Vales Gerados. É utilizado quando o assinalamento Usa Histórico de Vales Gerados no cadastramento da empresa for igual a “S”

Necessita autenticação: Sim.

Situação da versão: Atual

Versão: 1.

Versão atual: 1.

Requisição:

<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:Assinalamentos> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <TipOpe>String</TipOpe> <DatVal>DateTime</DatVal> <QtdVal>Integer</QtdVal> <NumEmp>Integer</NumEmp> <QtdUti>Double</QtdUti> <VlrVal>Double</VlrVal> <TipCol>Integer</TipCol> <QtdSab>Double</QtdSab> <PerSub>Double</PerSub> <NumCad>Integer</NumCad> <QtdDom>Double</QtdDom> <CodVal>Integer</CodVal> <QtdFer>Double</QtdFer> <DatSoc>DateTime</DatSoc> </parameters> </ser:Assinalamentos> </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.


  • Máscara: U

  • Valores:

“I” - Inclusão


“A” - Alteração


“E” - Exclusão


Se não for informado, será considerado “Alteração”.

datVal

Opcional

DateTime

Data de validade. Máscara: DD/MM/YYYY

qtdVal

Opcional

Double

Quantidade de vales que o colaborador receberá em dia útil, sábado, domingo e feriado.


  • Máscara: 999,99.

Este campo só pode ser informado quando o tipo base do vale informado no parâmetro CodVal for igual a “G” - Gerado.

numEmp

Obrigatório

Integer

Código da empresa que será utilizada na integração.


  • Chave

  • Máscara: 9999

qtdUti

Opcional

Double

Quantidade de vales para dia útil.


  • Máscara: 999,99.

Este campo só pode ser informado quando o tipo base do vale informado no parâmetro CodVal for “G” - Gerado.

vlrVal

Opcional

Double

Valor unitário do vale.


  • Máscara: ZZZZZZZZ9,99.

Este campo só pode ser informado quando o tipo base do vale informado no parâmetro CodVal for igual a “G” - Gerado.

tipCol

Obrigatório

Integer

Tipo de colaborador.


  • Chave

  • Máscara: 9

  • Valores:

1 - Empregado


2 - Terceiro


3 - Parceiro

qtdSab

Opcional

Double

Quantidade de vales para sábado.


  • Máscara: 999,99.

Este campo só pode ser informado quando o tipo base do vale informado no parâmetro CodVal for “G” - Gerado.

perSub

Opcional

Double

Percentual subsidiado pela empresa.


  • Máscara: ZZ9,9999.

numCad

Obrigatório

Integer

Código do Colaborador.


  • Chave

  • Máscara: 999999999

qtdDom

Opcional

Double

Quantidade de vales para feriado.


  • Máscara: 999,99.

Este campo só pode ser informado quando o tipo base do vale informado no parâmetro CodVal for “G” - Gerado.

codVal

Obrigatório

Integer

Código do tipo de vale que será assinalado.



  • Chave

  • Máscara: 9999

qtdFer

Opcional

Double

Quantidade de vales para feriado.



  • Máscara: 999


Este campo só pode ser informado quando o tipo base do vale informado no parâmetro CodVal for “G” - Gerado.

datSoc

Obrigatório

DateTime

Data da solicitação do vale.


  • Chave

  • Máscara: DD/MM/YYYY

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:AssinalamentosResponse> <result> <erroExecucao>String</erroExecucao> </result> </ser:AssinalamentosResponse> </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ê?