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 > Controle de Ponto e Refeitório > Com.senior.g5.rh.hr.calculoApuracao

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

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)

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

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

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.

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:

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: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:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Gravar>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <numCra>String</numCra>
        <datAcc>String</datAcc>
        <horAcc>String</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>String</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
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 Opcional 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


Valores possíveis
R- Regularizada
G- Gerada
D - Digitada
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
tipCol Opcional Integer Tipo do Colaborador


Valores possíveis
1 - Empregado
2 - Terceiro
3 - Parceiro
numCad Opcional Integer Código do Colaborador
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
fusMar Opcional Integer Código do Fuso Horário

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