Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Controle de Ponto e Refeitório > Com.senior.g5.rh.hr.geracaoEventos

Web service com.senior.g5.rh.hr.geracaoEventos

Importante

Este web service não pode ser utilizado de maneira que a chamada ocorra durante o cálculo da rescisão. Atualmente, algumas das informações necessárias para o cálculo da rescisão já são carregadas antes da execução da regra por processo, e isso é necessário para realizar outros comandos importantes. Consequentemente, os registros carregados no banco de dados através do web service não serão lidos.

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

Gerar

Web service de integração de geração de eventos - Gerar.
Disponível no módulo CP - Controle de Ponto e Refeitório.

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 2

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>
        <calRes>String</calRes>
        <datDem>DateTime</datDem>
        <iniGer>DateTime</iniGer>
        <fimGer>DateTime</fimGer>
        <fimPrj>DateTime</fimPrj>
        <terSem>String</terSem>
        <perPag>String</perPag>
        <eveDup>String</eveDup>
        <monVal>String</monVal>
        <numEmp>Integer</numEmp>
        <codCal>Integer</codCal>
        <qtdIte>Integer</qtdIte>
        <tipCal>Integer</tipCal>
        <perCal>Integer</perCal>
        <adiAbo>String</adiAbo>
        <abrBhr>String</abrBhr>
        <perAbo>Integer</perAbo>
        <limAbo>Time</limAbo>
        <perBhr>Integer</perBhr>
        <calPrg>String</calPrg>
        <codLot>Integer</codLot>
        <abrTcl>String</abrTcl>
        <abrCad>String</abrCad>
        <abrFil>String</abrFil>
        <abrLoc>String</abrLoc>
        <abrCcu>String</abrCcu>
        <abrSin>String</abrSin>
        <abrTco>String</abrTco>
        <abrTsa>String</abrTsa>
        <abrVin>String</abrVin>
        <abrCar>String</abrCar>
        <abrEsc>String</abrEsc>
        <abrTma>String</abrTma>
        <abrCes>String</abrCes>
        <abrOem>String</abrOem>
        <abrEve>String</abrEve>
        <gruEmp>Integer</gruEmp>
      </parameters>
	  </ser:Gerar>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
calRes Opcional String - Calcular para Rescisão Rubi:

Valores:
S - Sim
N - Não

- Se nas Definições de Integração o campo "Gerar Demitidos Período=N" este campo não deverá ser preenchido.
datDem Opcional DateTime Data de demissão


Máscara:
DD/MM/YYYY

- Se nas Definições de Integração o campo "Gerar Demitidos Período=N" este campo não deverá ser preenchido.
- Se o campo "Calcular Para Rescisão Rubi=N", este campo não deverá ser preenchido.
iniGer Opcional DateTime Data inicial do período de integração


Máscara:
DD/MM/YYYY

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
fimGer Opcional DateTime Data final do período de integração


Máscara:
DD/MM/YYYY

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
fimPrj Opcional DateTime Projetar até a data indicada


Máscara:
DD/MM/YYYY

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
terSem Opcional String Gerar até o término da última semana


Valores:
S - Sim
N - Não

Valor padrão:
S

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
perPag Opcional String Definir o período de pagamento


Valores:
M - Mensal
S - Semanal
Q - Quinzenal
T - Todos

Valor Padrão:
T

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
eveDup Opcional String Definir tratamento dos eventos duplos


Valores:
M - Manter lançado e gerado
D - Desprezar gerado

Valor padrão:
M
monVal Opcional String

Monitora valores da integração

Valores:
S - Sim
N - Não

Valor padrão:
N

numEmp Opcional Integer Código da empresa que será utilizada no escalonamento
codCal Opcional Integer Código de Cálculo que será usado no cálculo da folha

Somente se os parâmetros PerCal e TipCal forem iguais a 0
qtdIte Opcional Integer Campo de controle
* Não informar este campo
tipCal Opcional Integer Tipo de Cálculo para o Cálculo da Folha
se Código de Cálculo = 0

Valores:
11 - Cálculo Mensal
12 - Folha Complementar
21 - Primeira Semana
22 - Semana Intermediária
23 - Última Semana
31 - Adiantamento 13º Salário
32 - 13º Salário Integral
41 - Primeira Quinzena
42 - Segunda Quinzena
91 - Adiantamento Salarial
92 - Participação nos Lucros
93 - Especiais
94 - Reclamatória Trabalhista
perCal Opcional Integer Define como será calculado o processo referente a data da execução
se código de cálculo = 0

Valores:
0 - Utiliza o Código de Cálculo

1 - Válido Na Data Agendada
Selecionará o Código de Calculo compatível com o Tipo de Cálculo informado
e cuja data de execução do processo esteja dentro do período deste cálculo .

2 - Imediatamente Anterior
Selecionará o Código de Calculo imediatamente anterior ao Válido na Data
Agendada e compatível com o Tipo de Cálculo informado

3 - Imediatamente Posterior
Selecionará o Código de Calculo imediatamente posterior ao Válido na Data
Agendada e compatível com o Tipo de Cálculo informado
adiAbo Opcional String Adiantar Abono

* Somente informar estes valor se utilizar banco de horas

Valores
S - Sim
N - Não
abrBhr Opcional String Informar o código do banco de horas.

* Somente informar estes valor se o parâmetro AdiAbo = 'S' e utilizar banco de horas
perAbo Opcional Integer Informar percentual de abono

* Somente informar estes valor se o parâmetro AdiAbo = 'S' e utilizar banco de horas
limAbo Opcional Time Informar limite de abono

* Somente informar estes valor se o parâmetro AdiAbo = 'S' e utilizar banco de horas

Máscara:
HHHH:MM
perBhr Opcional Integer Informar percentual de anulação de débitos

* Somente informar estes valor se utilizar banco de horas
calPrg Opcional String Informar Cálculo de prorrogação

* Somente informar estes valor se utilizar banco de horas e se no banco estiver assinalado prorrogação de afastamento = 'S'

Valores:
S - Sim
N - Não
gruEmp Opcional Integer Código do Grupo de Empresas
codLot Opcional Integer Código do Lote de Colaboradores
abrTcl Opcional String Abrangência de Tipo de Colaborador
abrCad Opcional String Abrangência de Cadastro
abrFil Opcional String Abrangência de Filial
abrLoc Opcional String Abrangência de Local
abrCcu Opcional String Abrangência de Centro de Custo
abrSin Opcional String Abrangência de Sindicato
abrTco Opcional String Abrangência de Tipo de Contrato
abrTsa Opcional String Abrangência de Tipo de Salário
abrVin Opcional String Abrangência de Vínculo
abrCar Opcional String Abrangência de Cargo
abrEsc Opcional String Abrangência de Escalas
abrTma Opcional String Abrangência de Turmas
abrCes Opcional String Abrangência de Classe de Escala
abrOem Opcional String Abrangência de Outras Empresas
abrEve Opcional String Abrangência de Eventos

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>

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.

Escalonar

Web service de integração de geração de eventos - Escalonar.
Disponível no módulo CP - Controle de Ponto e Refeitório.

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>
        <calRes>String</calRes>
        <datDem>String</datDem>
        <iniGer>String</iniGer>
        <fimGer>String</fimGer>
        <fimPrj>String</fimPrj>
        <terSem>String</terSem>
        <perPag>String</perPag>
        <eveDup>String</eveDup>
        <numEmp>Integer</numEmp>
        <codCal>Integer</codCal>
        <qtdIte>Integer</qtdIte>
        <tipCal>Integer</tipCal>
        <perCal>Integer</perCal>
        <adiAbo>String</adiAbo>
        <abrBhr>String</abrBhr>
        <perAbo>Integer</perAbo>
        <limAbo>String</limAbo>
        <perBhr>Integer</perBhr>
        <calPrg>String</calPrg>
        <gruEmp>Integer</gruEmp>
        <codLot>Integer</codLot>
        <abrTcl>String</abrTcl>
        <abrCad>String</abrCad>
        <abrFil>String</abrFil>
        <abrLoc>String</abrLoc>
        <abrCcu>String</abrCcu>
        <abrSin>String</abrSin>
        <abrTco>String</abrTco>
        <abrTsa>String</abrTsa>
        <abrVin>String</abrVin>
        <abrCar>String</abrCar>
        <abrEsc>String</abrEsc>
        <abrTma>String</abrTma>
        <abrCes>String</abrCes>
        <abrOem>String</abrOem>
        <abrEve>String</abrEve>
      </parameters>
    </ser:Escalonar>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
calRes Opcional String - Calcular para Rescisão Rubi:

Valores:
S - Sim
N - Não

- Se nas Definições de Integração o campo "Gerar Demitidos Período=N" este campo não deverá ser preenchido.
datDem Opcional DateTime Data de demissão


Máscara:
DD/MM/YYYY

- Se nas Definições de Integração o campo "Gerar Demitidos Período=N" este campo não deverá ser preenchido.
- Se o campo "Calcular Para Rescisão Rubi=N", este campo não deverá ser preenchido.
iniGer Opcional DateTime Data inicial do período de integração


Máscara:
DD/MM/YYYY

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
fimGer Opcional DateTime Data final do período de integração


Máscara:
DD/MM/YYYY

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
fimPrj Opcional DateTime Projetar até a data indicada


Máscara:
DD/MM/YYYY

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
terSem Opcional String Gerar até o término da última semana


Valores:
S - Sim
N - Não

Valor padrão:
S

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
perPag Opcional String Definir o período de pagamento


Valores:
M - Mensal
S - Semanal
Q - Quinzenal
T - Todos

Valor Padrão:
T

- Se o campo "Calcular Para Rescisão Rubi=S", este campo não deverá ser preenchido.
eveDup Opcional String Definir tratamento dos eventos duplos


Valores:
M - Manter lançado e gerado
D - Desprezar gerado

Valor padrão:
M
numEmp Opcional Integer Código da empresa que será utilizada no escalonamento
codCal Opcional Integer Código de Cálculo que será usado no cálculo da folha

Somente se os parâmetros PerCal e TipCal forem iguais a 0
qtdIte Opcional Integer Campo de controle
* Não informar este campo
tipCal Opcional Integer Tipo de Cálculo para o Cálculo da Folha
se Código de Cálculo = 0

Valores:
11 - Cálculo Mensal
12 - Folha Complementar
21 - Primeira Semana
22 - Semana Intermediária
23 - Última Semana
31 - Adiantamento 13º Salário
32 - 13º Salário Integral
41 - Primeira Quinzena
42 - Segunda Quinzena
91 - Adiantamento Salarial
92 - Participação nos Lucros
93 - Especiais
94 - Reclamatória Trabalhista
perCal Opcional Integer Define como será calculado o processo referente a data da execução
se código de cálculo = 0

Valores:
0 - Utiliza o Código de Cálculo

1 - Válido Na Data Agendada
Selecionará o Código de Calculo compatível com o Tipo de Cálculo informado
e cuja data de execução do processo esteja dentro do período deste cálculo .

2 - Imediatamente Anterior
Selecionará o Código de Calculo imediatamente anterior ao Válido na Data
Agendada e compatível com o Tipo de Cálculo informado

3 - Imediatamente Posterior
Selecionará o Código de Calculo imediatamente posterior ao Válido na Data
Agendada e compatível com o Tipo de Cálculo informado
adiAbo Opcional String Adiantar Abono

* Somente informar estes valor se utilizar banco de horas

Valores
S - Sim
N - Não
abrBhr Opcional String Informar o código do banco de horas.

* Somente informar estes valor se o parâmetro AdiAbo = 'S' e utilizar banco de horas
perAbo Opcional Integer Informar percentual de abono

* Somente informar estes valor se o parâmetro AdiAbo = 'S' e utilizar banco de horas
limAbo Opcional Time Informar limite de abono

* Somente informar estes valor se o parâmetro AdiAbo = 'S' e utilizar banco de horas

Máscara:
HHHH:MM
perBhr Opcional Integer Informar percentual de anulação de débitos

* Somente informar estes valor se utilizar banco de horas
calPrg Opcional String Informar Cálculo de prorrogação

* Somente informar estes valor se utilizar banco de horas e se no banco estiver assinalado prorrogação de afastamento = 'S'

Valores:
S - Sim
N - Não
gruEmp Opcional Integer Código do Grupo de Empresas
codLot Opcional Integer Código do Lote de Colaboradores
abrTcl Opcional String Abrangência de Tipo de Colaborador
abrCad Opcional String Abrangência de Cadastro
abrFil Opcional String Abrangência de Filial
abrLoc Opcional String Abrangência de Local
abrCcu Opcional String Abrangência de Centro de Custo
abrSin Opcional String Abrangência de Sindicato
abrTco Opcional String Abrangência de Tipo de Contrato
abrTsa Opcional String Abrangência de Tipo de Salário
abrVin Opcional String Abrangência de Vínculo
abrCar Opcional String Abrangência de Cargo
abrEsc Opcional String Abrangência de Escalas
abrTma Opcional String Abrangência de Turmas
abrCes Opcional String Abrangência de Classe de Escala
abrOem Opcional String Abrangência de Outras Empresas
abrEve Opcional String Abrangência de Eventos

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ê?