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
- Síncrono: http://example.com/g5-senior-services/ronda_Synccom_senior_g5_rh_hr_calculoApuracao?wsdl
- Assíncrono: http://example.com/g5-senior-services/ronda_Asynccom_senior_g5_rh_hr_calculoApuracao?wsdl
- Agendado: http://example.com/g5-senior-services/ronda_Scheduledcom_senior_g5_rh_hr_calculoApuracao?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:
Nota
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:
Nota
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
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
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
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
|
| fusMar | Opcional | Integer | Código do Fuso Horário |
Resposta:
Nota
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. |
English
Español
English
Español


