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

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

monValOpcionalString

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:

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: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:

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