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