PORTAL DE DOCUMENTAÇÃO
Gestão de Pessoas | HCM - versão 6.10.4

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

A execução deste web service não valida as permissões da tela Calcular (FRCALAPU), em Cálculos > Apuração. Assim, mesmo se não possuir permissão para esta tela, será possível executar esse web service. Portanto, é necessário remover o assinalamento da opção Permite calcular apuração das permissões de cálculo.

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

Calcular

Web service de integração de cálculo da apuração para os colaboradores, terceiros e parceiros. Ele está disponível no módulo CP - Controle de Ponto e Refeitório.

É recomendável não utilizar esse web service de cálculo de apuração em regras de apuração, visto que o sistema irá executar a regra e depois o web service, e assim por diante, repetitivamente. Esse procedimento pode prejudicar a performance do cálculo da apuração.

Nota

No modo de execução local, ao utilizar esse web service através de uma regra de apuração, o sistema tentará abrir a tela de cálculo de apuração na mesma seção e, se estiver com a tela de acertos aberta, o web service não será executado.

Quando utilizado no modo de execução síncrono, o sistema abre uma nova seção no Middleware, em que abre a tela de cálculo de apuração e preenche as informações conforme definidas. Desta maneira o web service será executado.

**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:Calcular>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<datIni>DateTime</datIni>
<datFim>DateTime</datFim>
<proApu>String</proApu>
<reaMar>String</reaMar>
<desAce>String</desAce>
<diaVer>String</diaVer>
<motDRe>String</motDRe>
<leiMar>String</leiMar>
<numEmp>Integer</numEmp>
<codCal>Integer</codCal>
<qtdIte>String</qtdIte>
<gerCal>String</gerCal>
<diaDes>Integer</diaDes>
<diaRec>Integer</diaRec>
<gruEmp>Integer</gruEmp>
<codLot>Integer</codLot>
<abrEmp>String</abrEmp>
<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>
<abrTrb>String</abrTrb>
<abrEsc>String</abrEsc>
<abrTma>String</abrTma>
<abrCes>String</abrCes>
<abrOem>String</abrOem>
</parameters>
</ser:Calcular>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

datIni

Opcional

DateTime

Data inicial do processamento


o código de cálculo diferente de 0



Máscara:


DD/MM/AAAA



Esse parâmetro é opcional somente se o código de cálculo for zero. O código de cálculo apenas pode ficar com zero, se o web service for executado em modo agendado. Ou seja, o parâmetro se torna obrigatório ao ser executado por regra LSP.

datFim

Opcional

DateTime

Data final do processamento


o código de cálculo diferente de 0



Máscara:


DD/MM/AAAA




Esse parâmetro é opcional somente se o código de cálculo for zero. O código de cálculo apenas pode ficar com zero, se o web service for executado em modo agendado. Ou seja, o parâmetro se torna obrigatório ao ser executado por regra LSP.

proApu

Opcional

String

Selecionar uma opção de cálculo




Valores:


0 - Calcular Apuração e Refeitório


1 - Recalcular Apuração


2 - Recalcular Refeitório


3 - Calcular Refeitório em Dias Já calculados


4 - Recalcular Apuração em Dias Alterados



Valor Padrão:


0

reaMar

Opcional

String

Informar a realocação de marcações:

* Somente informar se o parâmetro TipPro = 1 (Recálculo da Apuração)

  • Este campo deve permanecer vazio para que seja possível realizar o processo de cálculo da apuração.

    Valores:
    S - Sim. Para que o sistema realoque as marcações já lidas.
    N - Não. Para que o sistema não realoque as marcações já lidas.

    Valor Padrão:
    N

desAce

Opcional

String

Informar o Desfazer Acertos

* Somente informar se o parâmetro TipPro = 1 (Recálculo da Apuração)

  • Este campo deve permanecer vazio para que seja possível realizar o processo de cálculo da apuração.

    Valores:
    S - Sim. Para que o sistema desconsidere os acertos individuais e recalcule o colaborador.
    N - Não. Para que o sistema faça prevalecer os acertos individuais.

    Valor Padrão:
    N

diaVer

Opcional

String

Desfazer dias verificados

* Somente informar e nas definições de apuração estiver assinalado o Controle de Dias Verficados diferente de 0

  • Este campo deve permanecer vazio para que seja possível realizar o processo de cálculo da apuração.

    Valores:
    S - Sim
    N - Não

motDRe

Opcional

String

Manter motivos de dias recalculados



  • Somente informar e nas definições de apuração estiver assinalado o Controle de Motivos de Acerto = ‘S’

leiMar

Opcional

String

Informar a leitura de arquivos off-line. Caso o cálculo seja efetuado com base em arquivos coletados de relógios off-line, deve ser assinalado como sim esta opção. Note que o arquivo deve ter sido coletado anteriormente, e a localização do mesmo deve estar informado corretamente no Controle de Ponto e Refeitório nas configurações do Coletor.




Valores:


S - Sim


N - Não



Valor Padrão:


N

numEmp

Obrigatório

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



  • Em processos agendados utilizar a opção 0, para busca automaticamente o cálculo referente a data do processamento


O parâmetro torna-se obrigatório quando o web service é executado por regra LSP.

qtdIte

Opcional

String

Campo de controle do sistemas.


  • Não informar este campo

gerCal

Opcional

String

Indica se deve gerar um novo código de cálculo quando não for encontrado um relativo a data do processamento




Valores:


S - Sim, gerar um código de cálculo quando não for encontrado


N - Não gerar



Valor Padrão:


N

diaDes

Opcional

Integer

Dias a desconsiderar a partir da data da execução



  • Quando for informado código de cálculo diferente de 0 este parâmetro será ignorado


Exemplo: Supondo que o processo esteja agendado para o dia 05/05/2005.


Se o valor deste campo for igual a 3, estes dias serão subtraídos da data final do período de apuração.


Ou seja, 05/05/2005 - 3 dias = 02/05/2005.



  • Se não for informado valor para este campo, a data final do período será a data do processamento.


Valor Padrão:


0

diaRec

Opcional

Integer

Dias a recalcular a partir da data da execução



  • Quando for informado código de cálculo diferente de 0 este parâmetro será ignorado


Exemplo: Supondo que o processo esteja agendado para o dia 10/05/2005.


Se o valor deste campo for igual a 2, estes dias serão subtraídos da data inicial do período de apuração.


Ou seja, 10/05/2005 - 2 dias = 08/05/2005.



  • Se não for informado valor para este campo, a data final do período será o dia anterior a data do processamento.

Data do processamento - 1 dia



Valor Padrão:


0

gruEmp

Opcional

Integer

Código do Grupo de Empresas

codLot

Opcional

Integer

Código do Lote de Colaboradores

abrEmp

Opcional

String

Abrangência de Empresa

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

abrTrb

Opcional

String

Abrangência de Turno

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

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:CalcularResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:CalcularResponse>
</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 cálculo da apuração para os colaboradores, terceiros e parceiros.
Ele está disponível no módulo CP - Controle de Ponto e Refeitório.

A execução desse web service, tanto no modo síncrono quanto no assíncrono, não funciona para o escalonamento quando o banco de dados utilizado é SQL Server.

**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>
<datIni>DateTime</datIni>
<datFim>DateTime</datFim>
<proApu>String</proApu>
<reaMar>String</reaMar>
<desAce>String</desAce>
<diaVer>String</diaVer>
<motDRe>String</motDRe>
<leiMar>String</leiMar>
<numEmp>Integer</numEmp>
<codCal>Integer</codCal>
<qtdIte>String</qtdIte>
<gerCal>String</gerCal>
<diaDes>Integer</diaDes>
<diaRec>Integer</diaRec>
<gruEmp>Integer</gruEmp>
<codLot>Integer</codLot>
<abrEmp>String</abrEmp>
<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>
<abrTrb>String</abrTrb>
<abrEsc>String</abrEsc>
<abrTma>String</abrTma>
<abrCes>String</abrCes>
<abrOem>String</abrOem>
</parameters>
</ser:Escalonar>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

datIni

Opcional

DateTime

Data inicial do processamento


o código de cálculo diferente de 0



Máscara:


DD/MM/AAAA

datFim

Opcional

DateTime

Data final do processamento


o código de cálculo diferente de 0



Máscara:


DD/MM/AAAA

proApu

Opcional

String

Selecionar uma opção de cálculo




Valores:


0 - Calcular Apuração e Refeitório


1 - Recalcular Apuração


2 - Recalcular Refeitório


3 - Calcular Refeitório em Dias Já calculados


4 - Recalcular Apuração em Dias Alterados



Valor Padrão:


0

reaMar

Opcional

String

Informar a realocação de marcações:



  • Somente informar se o parâmetro TipPro = 1 (Recálculo da Apuração)


Valores:


S - Sim. Para que o sistema realoque as marcações já lidas.


N - Não. Para que o sistema não realoque as marcações já lidas.



Valor Padrão:


N

desAce

Opcional

String

Informar o Desfazer Acertos



  • Somente informar se o parâmetro TipPro = 1 (Recálculo da Apuração)


Valores:


S - Sim. Para que o sistema desconsidere os acertos individuais e recalcule o colaborador.


N - Não. Para que o sistema faça prevalecer os acertos individuais.



Valor Padrão:


N

diaVer

Opcional

String

Desfazer dias verificados



  • Somente informar e nas definições de apuração estiver assinalado o Controle de Dias Verficados diferente de 0


Valores:


S - Sim


N - Não

motDRe

Opcional

String

Manter motivos de dias recalculados



  • Somente informar e nas definições de apuração estiver assinalado o Controle de Motivos de Acerto = ‘S’

leiMar

Opcional

String

Informar a leitura de arquivos off-line. Caso o cálculo seja efetuado com base em arquivos coletados de relógios off-line, deve ser assinalado como sim esta opção. Note que o arquivo deve ter sido coletado anteriormente, e a localização do mesmo deve estar informado corretamente no Controle de Ponto e Refeitório nas configurações do Coletor.




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



  • Em processos agendados utilizar a opção 0, para busca automaticamente o cálculo referente a data do processamento

qtdIte

Opcional

String

Campo de controle do sistemas.


  • Não informar este campo

gerCal

Opcional

String

Indica se deve gerar um novo código de cálculo quando não for encontrado um relativo a data do processamento




Valores:


S - Sim, gerar um código de cálculo quando não for encontrado


N - Não gerar



Valor Padrão:


N

diaDes

Opcional

Integer

Dias a desconsiderar a partir da data da execução



  • Quando for informado código de cálculo diferente de 0 este parâmetro será ignorado


Exemplo: Supondo que o processo esteja agendado para o dia 05/05/2005.


Se o valor deste campo for igual a 3, estes dias serão subtraídos da data final do período de apuração.


Ou seja, 05/05/2005 - 3 dias = 02/05/2005.



  • Se não for informado valor para este campo, a data final do período será a data do processamento.


Valor Padrão:


0

diaRec

Opcional

Integer

Dias a recalcular a partir da data da execução



  • Quando for informado código de cálculo diferente de 0 este parâmetro será ignorado


Exemplo: Supondo que o processo esteja agendado para o dia 10/05/2005.


Se o valor deste campo for igual a 2, estes dias serão subtraídos da data inicial do período de apuração.


Ou seja, 10/05/2005 - 2 dias = 08/05/2005.



  • Se não for informado valor para este campo, a data final do período será o dia anterior a data do processamento.

Data do processamento - 1 dia



Valor Padrão:


0

gruEmp

Opcional

Integer

Código do Grupo de Empresas

codLot

Opcional

Integer

Código do Lote de Colaboradores

abrEmp

Opcional

String

Abrangência de Empresa

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

abrTrb

Opcional

String

Abrangência de Turno

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

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.

Acertar

Web service de integração de acerto de ponto para os colaboradores, terceiros e parceiros. Ele está disponível no módulo CP - Controle de Ponto e Refeitório. Para que o web service execute corretamente, é necessário que o assinalamento Permitir Gravar Marcações sem Apurar esteja com o valor “S - Sim” nas definições da apuração (FR060DAP).

**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:Acertar>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<numEmp>Integer</numEmp>
<tipCol>Integer</tipCol>
<expPes>Integer</expPes>
<datAce>DateTime</datAce>
<tipOpe>String</tipOpe>
<marGer>String</marGer>
<tMarDat>
<linha>Integer</linha>
<tipOpe>String</tipOpe>
<datMar>String</datMar>
<horMar>String</horMar>
<codPlt>Integer</codPlt>
<codRlg>Integer</codRlg>
<codFnc>Integer</codFnc>
<dirMar>String</dirMar>
<oriMar>String</oriMar>
<usoMar>Integer</usoMar>
<codJMa>Integer</codJMa>
<obsJMa>String</obsJMa>
<seqAcc>Integer</seqAcc>
<marcOri>String</marcOri>
</tMarDat>
<tApuDat>
<qtdHor>String</qtdHor>
<codSit>Integer</codSit>
<codRat>Integer</codRat>
<motSit>Integer</motSit>
<desObs>String</desObs>
</tApuDat>
<conVer>String</conVer>
</parameters>
</ser:Acertar>
</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

tipCol

Obrigatório

Integer

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



  • Chave


Valores:


1 - Empregado


2 - Terceiro


3 - Parceiro

expPes

Obrigatório

Integer

Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.



  • Chave

datAce

Obrigatório

DateTime

Data do Acerto que será usado na apuração das marcações

tipOpe

Obrigatório

String

Tipo da operação a ser efetuada na tela de acertos na data.




Valores:


A - Apurar


G - Gravar

marGer

Opcional

String

Tratamento a ser aplicado quando existirem Marcações Digitadas e Geradas.


Informar se deve apurar somente as marcações da tela.




Valores:


S - Sim


N - Não

tMarDat

Opcional

Set

tMarDat.linha

Opcional

Integer

  • Número da linha da marcação.

  • Chave (obrigatório)

tMarDat.tipOpe

Opcional

String

  • Tipo da operação da linha



Valores


A - Alteração


I - Inclusão


E- Exclusão




  • Se não informando, seu valor padrão será “A”.

tMarDat.datMar

Opcional

String

  • Data da marcação



  • dd/mm/yyyy

tMarDat.horMar

Opcional

String

  • Hora da Marcação



  • hh:mm

tMarDat.codPlt

Opcional

Integer

  • Código da Site



  • Somente informar quando o assinalamento “Diversos/Assinalamentos/Ponto” o campo Site Padrão estiver com valor 0.

tMarDat.codRlg

Opcional

Integer

  • Código do Relógio

tMarDat.codFnc

Opcional

Integer

  • Código da Função

tMarDat.dirMar

Opcional

String

  • Direção da marcação

tMarDat.oriMar

Opcional

String

  • Origem da Marcação


    Valores
    D - Digitada
    G - Gerada
    E - Eletrônica
    R - Regularizada
Observação

Neste parâmetro, a marcação será incluída com a origem D - Digitada. Quando houver integração com a Portaria 1.510, este parâmetro não assume a configuração do web servisse (mesmo quando informado a origem E - Eletrônica no Controle de Ponto e Refeitório, assume D - Digitada). Ou seja, o módulo Controle de Ponto e Refeitório compreende que, quando há uma justificativa, deve ser inserida uma marcação como D - Digitada, mesmo que no web service seja identificado que a origem é do tipo E - Eletrônica.

tMarDat.usoMar

Opcional

Integer

  • Uso da marcação



Valores


2 - 4 - 6 - 7 - 8 -10 - 12 - 13 - 14 - 15 - 16 - 18

tMarDat.codJMa

Opcional

Integer

-Código da Justificativa



  • Informar para marcações incluir marcações digitadas e para excluir marcações eletrônicas.

tMarDat.obsJMa

Opcional

String

  • Justificativa da marcação

Informar para marcações incluir marcações digitadas e para excluir marcações eletrônicas.

tMarDat.seqAcc

Opcional

Integer

  • Sequência da marcação


  • Não deverá informar nenhum valor. Será consistido pelo sistema.

tMarDat.marcOri

Opcional

String

  • Marcações Originais da tela.



  • Indica se é uma nova marcação que está sendo incluída ou é uma

marcação que já consta na base



  • Valores

  • S : Indica que é uma marcação que já consta em base;

  • N : Indica que é uma nova marcação.



Observação : Esse parâmetro deverá ser passado somente quando o Tipo Operação for “A - Apurar”. Porém, até a versão atual, esta operação ainda não funciona


adequadamente. Somente “AG - Apurar/Gravar” e “G” - Gravar

tApuDat

Opcional

Set

tApuDat.qtdHor

Opcional

String

  • Quantidade de horas



  • hhh:mm

tApuDat.codSit

Opcional

Integer

  • Código da Situação

tApuDat.codRat

Opcional

Integer

  • Código do Rateio



  • Somente informar quando a empresa utiliza rateio.

tApuDat.motSit

Opcional

Integer

  • Código do motivo



  • Somente informar quando o assinalamento “Controlar Motivos Acertos” estiver com valor “S”.

tApuDat.desObs

Opcional

String

  • Observação na apuração



  • Somente informar quando o assinalamento “Controlar Observação” estiver

marcado com “S” nas definições da apuração.

conVer

Opcional

String

Marca ou desmarcar o dia como verificado



Valores


S - Sim


N - Nã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:AcertarResponse>
<result>
<msgRet>String</msgRet>
<tMarDat>
<linha>Integer</linha>
<tipOpe>String</tipOpe>
<datMar>String</datMar>
<horMar>String</horMar>
<codPlt>Integer</codPlt>
<codRlg>Integer</codRlg>
<codFnc>Integer</codFnc>
<dirMar>String</dirMar>
<oriMar>String</oriMar>
<usoMar>Integer</usoMar>
<codJMa>Integer</codJMa>
<obsJMa>String</obsJMa>
<seqAcc>Integer</seqAcc>
<marcOri>String</marcOri>
</tMarDat>
<tApuDat>
<qtdHor>String</qtdHor>
<codSit>Integer</codSit>
<codRat>Integer</codRat>
<motSit>Integer</motSit>
<desObs>String</desObs>
</tApuDat>
<erroExecucao>String</erroExecucao>
</result>
</ser:AcertarResponse>
</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.

msgRet

Opcional

String

Parâmetro que retorna os erros gerados durante a apuração/gravação das marcações/situações.


Este retorno deve ser tratado no fluxo no workflow.

tMarDat

Opcional

Set

tMarDat.linha

Opcional

Integer

  • Número da linha da marcação.

  • Chave (obrigatório)

tMarDat.tipOpe

Opcional

String

  • Tipo da operação da linha



Valores


A - Alteração


I - Inclusão


E- Exclusão




  • Se não informando, seu valor padrão será “A”.

tMarDat.datMar

Opcional

String

  • Data da marcação



  • dd/mm/yyyy

tMarDat.horMar

Opcional

String

  • Hora da Marcação



  • hh:mm

tMarDat.codPlt

Opcional

Integer

  • Código da Site



  • Somente informar quando o assinalamento “Diversos/Assinalamentos/Ponto” o campo Site Padrão estiver com valor 0.

tMarDat.codRlg

Opcional

Integer

  • Código do Relógio

tMarDat.codFnc

Opcional

Integer

  • Código da Função

tMarDat.dirMar

Opcional

String

  • Direção da marcação

tMarDat.oriMar

Opcional

String

  • Origem da Marcação


    Valores
    D - Digitada
    G - Gerada
    E - Eletrônica
    R - Regularizada
Observação

Neste parâmetro, a marcação será incluída com a origem D - Digitada. Quando houver integração com a Portaria 1.510, este parâmetro não assume a configuração do web servisse (mesmo quando informado a origem E - Eletrônica no Controle de Ponto e Refeitório, assume D - Digitada). Ou seja, o módulo Controle de Ponto e Refeitório compreende que, quando há uma justificativa, deve ser inserida uma marcação como D - Digitada, mesmo que no web service seja identificado que a origem é do tipo E - Eletrônica.

tMarDat.usoMar

Opcional

Integer

  • Uso da marcação



Valores


2 - 4 - 6 - 7 - 8 -10 - 12 - 13 - 14 - 15 - 16 - 18

tMarDat.codJMa

Opcional

Integer

-Código da Justificativa



  • Informar para marcações incluir marcações digitadas e para excluir marcações eletrônicas.

tMarDat.obsJMa

Opcional

String

  • Justificativa da marcação

Informar para marcações incluir marcações digitadas e para excluir marcações eletrônicas.

tMarDat.seqAcc

Opcional

Integer

  • Sequência da marcação


  • Não deverá informar nenhum valor. Será consistido pelo sistema.

tMarDat.marcOri

Opcional

String

  • Marcações Originais da tela.



  • Indica se é uma nova marcação que está sendo incluída ou é uma

marcação que já consta na base



  • Valores

  • S : Indica que é uma marcação que já consta em base;

  • N : Indica que é uma nova marcação.



Observação : Esse parâmetro deverá ser passado somente quando o Tipo Operação for “A - Apurar”. Porém, até a versão atual, esta operação ainda não funciona


adequadamente. Somente “AG - Apurar/Gravar” e “G” - Gravar

tApuDat

Opcional

Set

tApuDat.qtdHor

Opcional

String

  • Quantidade de horas



  • hhh:mm

tApuDat.codSit

Opcional

Integer

  • Código da Situação

tApuDat.codRat

Opcional

Integer

  • Código do Rateio



  • Somente informar quando a empresa utiliza rateio.

tApuDat.motSit

Opcional

Integer

  • Código do motivo



  • Somente informar quando o assinalamento “Controlar Motivos Acertos” estiver com valor “S”.

tApuDat.desObs

Opcional

String

  • Observação na apuração



  • Somente informar quando o assinalamento “Controlar Observação” estiver

marcado com “S” nas definições da apuração.

Gravar

Serviço de integração para gravar marcações diretamente nas tabelas R070ACC e R070CRI.
Disponível no módulo CP - Controle de Ponto e Refeitório.
Somente permite gravar se possuir um coletor de marcações cadastrado com o modelo 97- Web service.

**Necessita autenticação: **Sim

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

**Versão: **1

**Requisição: **

<soapenv:Envelope xmlns:ser=“http://services.senior.com.br” xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/”>
<soapenv:Body>
<ser:Gravar>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<numCra>String</numCra>
<datAcc>DateTime</datAcc>
<horAcc>Time</horAcc>
<seqAcc>Integer</seqAcc>
<tipAcc>Integer</tipAcc>
<codPlt>Integer</codPlt>
<codRlg>Integer</codRlg>
<codFnc>Integer</codFnc>
<dirAcc>String</dirAcc>
<qtdAcc>Double</qtdAcc>
<oriAcc>String</oriAcc>
<usoMar>Integer</usoMar>
<numEmp>Integer</numEmp>
<tipCol>Integer</tipCol>
<numCad>Integer</numCad>
<datApu>DateTime</datApu>
<codRef>Integer</codRef>
<usoRef>Integer</usoRef>
<valRef>Double</valRef>
<codSor>Integer</codSor>
<flaAcc>Integer</flaAcc>
<codBnf>Integer</codBnf>
<staRlg>Integer</staRlg>
<excPon>String</excPon>
<codDsp>Integer</codDsp>
<fusMar>Integer</fusMar>
</parameters>
</ser:Gravar>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

numCra

Opcional

String

Número do crachá do colaborador



Se não for informado, será utilizado o número do crachá do cadastro enviado como parâmetro.

datAcc

Opcional

DateTime

Data da Marcação


  • Se não informado será retornado a data do servidor


Formato:


dd/mm/yyyy

horAcc

Opcional

Time

Hora da Marcação


. Se não informar, será retornado a hora do servidor.

seqAcc

Obrigatório

Integer

Sequência da Marcação

tipAcc

Opcional

Integer

Tipo da Marcação

codPlt

Opcional

Integer

Código do Site

codRlg

Opcional

Integer

Código do Coletor


-Obrigatório



Somente permite informar coletor com tipo = 97

codFnc

Opcional

Integer

Código da Função

dirAcc

Opcional

String

Direção do Acesso




Valor padrão


  • E

qtdAcc

Opcional

Double

Quantidade no Acesso

oriAcc

Opcional

String

Origem da Marcação



E- Eletrônica

usoMar

Opcional

Integer

Uso da marcação


  • Não informar essa campo. Será calculado pelo sistema.

numEmp

Opcional

Integer

Código da Empresa



Se não for informado, o sistema buscará o valor conforme o cadastro associado ao usuário fornecido como parâmetro na execução do Web Service.

tipCol

Opcional

Integer

Tipo do Colaborador




Valores possíveis


1 - Empregado


2 - Terceiro


3 - Parceiro



Se não for informado, o sistema buscará o valor conforme o cadastro associado ao usuário fornecido como parâmetro na execução do Web Service.

numCad

Opcional

Integer

Código do Colaborador



Se não for informado, o sistema buscará o valor conforme o cadastro associado ao usuário fornecido como parâmetro na execução do Web Service.

datApu

Opcional

DateTime

Data da Apuração




Formato:


dd/mm/yyyy

codRef

Opcional

Integer

Código da Refeição

usoRef

Opcional

Integer

Uso da Refeição


-Opcional

valRef

Opcional

Double

Valor da Refeição

codSor

Opcional

Integer

Solicitação do Relógio

flaAcc

Opcional

Integer

Flag do Acesso

codBnf

Opcional

Integer

Código do Benefício

staRlg

Opcional

Integer

Status do Coletor

excPon

Opcional

String

Excluído do Ponto




Valor padrão


  • E

codDsp

Opcional

Integer

Código do dispositivo
fusMarOpcional IntegerCódigo do Fuso Horário

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

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).