Este conteúdo não recebe atualizações, pois é referente a uma versão do sistema que foi descontinuada. Acesse a documentação da versão 6.10.3 aqui
Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Administração de Pessoal > Com.senior.g5.rh.fp.valeTransporte

Web service com.senior.g5.rh.fp.valeTransporte

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

Portas

DigitarReferencia

Web service responsável pela manutenção da aba Referência da tela de Vale Transporte - Digitar Passes

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:DigitarReferencia>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <wGDDIGPVT>
          <tipOpe>String</tipOpe>
          <data>String</data>
          <linha>Integer</linha>
          <valor>Double</valor>
          <qtde>Integer</qtde>
          <mltiplos>Integer</mltiplos>
          <status>String</status>
        </wGDDIGPVT>
        <perIni>String</perIni>
        <perFim>String</perFim>
        <iniFal>String</iniFal>
        <fimFal>String</fimFal>
        <solIni>String</solIni>
        <solFim>String</solFim>
        <tipCol>Integer</tipCol>
        <numCad>Integer</numCad>
        <recalc>String</recalc>
      </parameters>
    </ser:DigitarReferencia>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
numEmp Obrigatório Integer Código da empresa que será utilizada na integração.

- Chave
- Máscara: 9999
wGDDIGPVT Opcional Set Passes.
wGDDIGPVT.tipOpe Opcional String Tipo da operação a ser efetuada para um lançamento (uma linha).

- Máscara: U
- Valores:
"I" - Inclusão
"A" - Alteração
"E" - Exclusão
- Obs.: Se não for informado, será considerado "Alteração".
wGDDIGPVT.data Opcional DateTime Dia do período que haverá distribuição de passes.

- Chave
- Máscara: DD/MM/YYYY
wGDDIGPVT.linha Opcional Integer Código da linha que será utilizada.

- Chave
- Máscara: 9[5]
wGDDIGPVT.valor Opcional Double Valor do passe.

- Máscara: ZZZZZ9,99
- Obs.: Se não for informado, o sistema tentará encontrar o valor do passe, de acordo com a linha.
wGDDIGPVT.qtde Opcional Integer Quantidade de passes no dia.

- Máscara: 9999
wGDDIGPVT.mltiplos Opcional Integer Quantidade de múltiplos

- Chave
- Máscara: 99
wGDDIGPVT.status Opcional String Status:
- Indicação da situação do passe:
- E (Entregue): são os vales pagos ao colaborador;
- D (Faltas Descontada): são os afastamentos e faltas já descontadas na geração do vale transporte;
- Máscara: U


Obs: Caso não informado na Inclusão, será considerado como 'E - Entregue'.
perIni Obrigatório DateTime Data de início do período que será alterado.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
perFim Obrigatório DateTime Data de fim do período que será alterado.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
iniFal Opcional DateTime Data de início para consideração dos afastamentos que perdem para vale transporte.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
fimFal Opcional DateTime Data de fim para consideração dos afastamentos que perdem para vale transporte.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
solIni Opcional DateTime Data de início para consideração das solicitações de vale transporte do CP.

- Máscara: DD/MM/YYYY

Este parâmetro só poderá ser informado se alguma das seguintes condições for verdadeira:
- Sistema integrado com Controle de Ponto e Refeitório .
- Campo "Tratar Solicitações Ronda", nas definições de vale transporte estiver igual a "S" - Sim.

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o período de referência.
solFim Opcional DateTime Data de fim para consideração das solicitações de vale transporte do CP.

- Máscara: DD/MM/YYYY

Este parâmetro só poderá ser informado se alguma das seguintes condições for verdadeira:
- Sistema integrado com Controle de Ponto e Refeitório .
- Campo "Tratar Solicitações Ronda", nas definições de vale transporte estiver igual a "S" - Sim.

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o período de referência.
tipCol Obrigatório Integer Tipo de colaborador.

- Chave
- Máscara: 9

Valores:
1 - Empregado
2 - Terceiro
3 - Parceiro
numCad Obrigatório Integer Código do Colaborador.

- Chave
- Máscara: 999999999
recalc Obrigatório String Permite recalcular ou não a distribuição de vales.

- Máscara: U

Valores:
"S" - Sim: Serão recalculados todos os valores gravados.
"N" - Não Digitados: Serão recalculados apenas os valores calculados pela própria rotina de vale transporte.
"D" - Desconsiderar Recálculo: Demonstra o que já foi calculado.

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

DigitarFaltas

Web service responsável pela manutenção da aba Faltas da tela de Vale Transporte - Digitar Passes

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:DigitarFaltas>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numEmp>Integer</numEmp>
        <wGDFALPVT>
          <tipOpe>String</tipOpe>
          <data>String</data>
          <linha>Integer</linha>
          <valor>Double</valor>
          <qtde>Integer</qtde>
          <mltiplos>Integer</mltiplos>
        </wGDFALPVT>
        <perIni>String</perIni>
        <perFim>String</perFim>
        <iniFal>String</iniFal>
        <fimFal>String</fimFal>
        <solIni>String</solIni>
        <solFim>String</solFim>
        <tipCol>Integer</tipCol>
        <numCad>Integer</numCad>
        <recalc>String</recalc>
      </parameters>
    </ser:DigitarFaltas>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
numEmp Obrigatório Integer Código da empresa que será utilizada na integração.

- Chave
- Máscara: 9999
wGDFALPVT Opcional Set Passes.
wGDFALPVT.tipOpe Opcional String Tipo da operação a ser efetuada para um lançamento (uma linha).

- Máscara: U
- Valores:
"I" - Inclusão
"A" - Alteração
"E" - Exclusão
- Obs.: Se não for informado, será considerado "Alteração".
wGDFALPVT.data Opcional DateTime Dia do período que haverá distribuição de passes.

- Chave
- Máscara: DD/MM/YYYY
wGDFALPVT.linha Opcional Integer Código da linha que será utilizada.

- Chave
- Máscara: 9[5]
wGDFALPVT.valor Opcional Double Valor do passe.

- Máscara: ZZZZZ9,99
- Obs.: Se não for informado, o sistema tentará encontrar o valor do passe, de acordo com a linha.
wGDFALPVT.qtde Opcional Integer Quantidade de passes no dia.

- Máscara: 9999
wGDFALPVT.mltiplos Opcional Integer Quantidade de múltiplos

- Chave
- Máscara: 99
perIni Opcional DateTime Data de início do período que será alterado.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
perFim Opcional DateTime Data de fim do período que será alterado.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
iniFal Opcional DateTime Data de início para consideração dos afastamentos que perdem para vale transporte.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
fimFal Opcional DateTime Data de fim para consideração dos afastamentos que perdem para vale transporte.

- Máscara: DD/MM/YYYY

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o cálculo ativo.
solIni Opcional DateTime Data de início para consideração das solicitações de vale transporte do CP.

- Máscara: DD/MM/YYYY

Este parâmetro só poderá ser informado se alguma das seguintes condições for verdadeira:
- Sistema integrado com Controle de Ponto e Refeitório.
- Campo "Tratar Solicitações Ronda", nas definições de vale transporte estiver igual a "S" - Sim.

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o período de referência.
solFim Opcional DateTime Data de fim para consideração das solicitações de vale transporte do CP.

- Máscara: DD/MM/YYYY

Este parâmetro só poderá ser informado se alguma das seguintes condições for verdadeira:
- Sistema integrado com Controle de Ponto e Refeitório.
- Campo "Tratar Solicitações Ronda", nas definições de vale transporte estiver igual a "S" - Sim.

Se este parâmetro não for informado, o sistema irá utilizar um período de acordo com o período de referência.
tipCol Obrigatório Integer Tipo de colaborador.

- Chave
- Máscara: 9

Valores:
1 - Empregado
2 - Terceiro
3 - Parceiro
numCad Obrigatório Integer Código do Colaborador.

- Chave
- Máscara: 999999999
recalc Obrigatório String Permite recalcular ou não a distribuição de vales.

- Máscara: U

Valores:
"S" - Sim: Serão recalculados todos os valores gravados.
"N" - Não Digitados: Serão recalculados apenas os valores calculados pela própria rotina de vale transporte.
"D" - Desconsiderar Recálculo: Demonstra o que já foi calculado.

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

Gerar

Web service responsável pela manutenção da aba Faltas da tela de Vale Transporte - Digitar Passes

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:Gerar>
			<user>String</user>
			<password>String</password>
			<encryption>Integer</encryption>
			<parameters>
				<numEmp>Integer</numEmp>
				<abrTcl>Integer</abrTcl>
				<codCal>Integer</codCal>
				<abrCad>String</abrCad>
				<iniPer>DateTime</iniPer>
				<abrTrb>String</abrTrb>
				<fimPer>DateTime</fimPer>
				<abrFil>String</abrFil>
				<iniAfa>DateTime</iniAfa>
				<abrLoc>String</abrLoc>
				<fimAfa>DateTime</fimAfa>
				<abrTCo>String</abrTCo>
				<iniRon>DateTime</iniRon>
				<abrSit>String</abrSit>
				<fimRon>DateTime</fimRon>
				<abrVtr>String</abrVtr>
				<digVal>String</digVal>
				<abrTsa>String</abrTsa>
			</parameters>
		</ser:Gerar>
	</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
numEmp Obrigatório Integer Código da empresa que será utilizada no processo
- Máscara: 9999
abrTcl Opcional Integer Abrangência de tipos de colaborador
- Opcional

Valores:
1 - Empregado
2 - Terceiro
3 - Parceiro
codCal Obrigatório Integer Código de cálculo que será usado no processo
- Máscara: 9999
abrCad Opcional String Abrangência: Colaborador (+)
- Máscara: A[200]
iniPer Opcional DateTime Início do Período
- Máscara: DD/MM/YYYY
abrTrb Opcional String Abrangência: Local (+)
- Máscara: A[200]
fimPer Opcional DateTime Fim do Período
- Máscara: DD/MM/YYYY
abrFil Opcional String Abrangência: Filial (+)
- Máscara: A[200]
iniAfa Opcional DateTime Início do Afastamento
- Máscara: DD/MM/YYYY
abrLoc Opcional String Abrangência: Local ("+")
- Máscara: A[200]
fimAfa Opcional DateTime Fim do Afastamento
- Máscara: DD/MM/YYYY
abrTCo Opcional String Abrangência: Tipo de Contrato (+)
- Máscara: A[100]
iniRon Opcional DateTime Início perído Solicitações Ronda
- Máscara: DD/MM/YYYY
abrSit Opcional String Abrangência: Situação (+)
- Máscara: A[200]
fimRon Opcional DateTime Fim período Solicitações Ronda
- Máscara: DD/MM/YYYY
abrVtr Opcional String Abrangência: Escala Vlr (+)
- Máscara: A[200]
digVal Opcional String Recalcular Vales Digitados

Valores:
S - Sim
N - Não
abrTsa Opcional String Abrangência: Tipo de Salário (+)
- Máscara: A[100]

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:GerarResponse>
			<result>
				<erroExecucao>String</erroExecucao>
			</result>
		</ser:GerarResponse>
	</soapenv:Body>
</soapenv:Envelope>

Escalonar

Web service para realização de processamentos escalonados da Geração de Vales-transporte.

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:Escalonar>
			<user>String</user>
			<password>String</password>
			<encryption>Integer</encryption>
			<parameters>
				<numEmp>Integer</numEmp>
				<abrTcl>Integer</abrTcl>
				<codCal>Integer</codCal>
				<abrCad>String</abrCad>
				<iniPer>DateTime</iniPer>
				<abrTrb>String</abrTrb>
				<fimPer>DateTime</fimPer>
				<abrFil>String</abrFil>
				<iniAfa>DateTime</iniAfa>
				<abrLoc>String</abrLoc>
				<fimAfa>DateTime</fimAfa>
				<abrTCo>String</abrTCo>
				<iniRon>DateTime</iniRon>
				<abrSit>String</abrSit>
				<fimRon>DateTime</fimRon>
				<abrVtr>String</abrVtr>
				<digVal>String</digVal>
				<abrTsa>String</abrTsa>
			</parameters>
		</ser:Escalonar>
	</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
numEmp Obrigatório Integer Código da empresa que será utilizada no processo
- Máscara: 9999
abrTcl Opcional Integer Abrangência de tipos de colaborador

Valores:
1 - Empregado
2 - Terceiro
3 - Parceiro
codCal Obrigatório Integer Código de cálculo que será usado no processo
- Máscara: 9999
abrCad Opcional String Abrangência: Colaborador (+).
- Máscara: A[200]
iniPer Opcional DateTime Início do Período
- Máscara: DD/MM/YYYY
abrTrb Opcional String Abrangência: Local (+).
- Máscara: A[200]
fimPer Opcional DateTime Fim do Período
- Máscara: DD/MM/YYYY
abrFil Opcional String Abrangência: Filial (+).
- Máscara: A[200]
iniAfa Opcional DateTime Início do Afastamento
- Máscara: DD/MM/YYYY
abrLoc Opcional String Abrangência: Local ("+").
- Máscara: A[200]
fimAfa Opcional DateTime Fim do Afastamento
- Máscara: DD/MM/YYYY
abrTCo Opcional String Abrangência: Tipo de Contrato (+).
- Máscara: A[100]
iniRon Opcional DateTime Início perído Solicitações Ronda
- Máscara: DD/MM/YYYY
abrSit Opcional String Abrangência: Situação (+).
- Máscara: A[200]
fimRon Opcional DateTime Fim período Solicitações Ronda
- Máscara: DD/MM/YYYY
abrVtr Opcional String Abrangência: Escala Vlr (+).
- Máscara: A[200]
digVal Opcional String Recalcular Vales Digitados

Valores:
S - Sim
N - Não
abrTsa Opcional String Abrangência: Tipo de Salário (+).
- Máscara: A[100]

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