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 ejecución
Para cada tipo de ejecución, existen diferentes parámetros que pueden ser comunes a todos los puertos.
Autenticación
Si se utiliza alguna forma de autenticación para la integración de información a través de web services, es necesario identificar el tipo en el parámetro <encryption>, según sus valores posibles.
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:
Observación
Sobre SOAP de respuesta de solicitudes sincrónicas. Para las solicitudes asincrónicas o las programadas, la respuesta es sólo una cadena llamada "result" con el valor "OK", si se ejecutó correctamente o, de lo contrario, el mensaje del error ocurrido.
<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 errores ocurridos en el servidor al ejecutar el servicio, pudiendo contener los siguientes valores: - Vacío o nulo, indicando que la ejecución fue realizada con éxito; - El mensaje del error ocurrido en el 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:
Observación
Sobre SOAP de respuesta de solicitudes sincrónicas. Para las solicitudes asincrónicas o las programadas, la respuesta es sólo una cadena llamada "result" con el valor "OK", si se ejecutó correctamente o, de lo contrario, el mensaje del error ocurrido.
<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 errores ocurridos en el servidor al ejecutar el servicio, pudiendo contener los siguientes valores: - Vacío o nulo, indicando que la ejecución fue realizada con éxito; - El mensaje del error ocurrido en el 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 Observación 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 - Somente informar quando integrado com Portaria 1510 ou o assinalamento "Justificar Marcações Digitadas" estiver com valor "S". |
| tMarDat.obsJMa | Opcional | String | - Justificativa da marcação informar quando integrado com Portaria 1510 para 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:
Observación
Sobre SOAP de respuesta de solicitudes sincrónicas. Para las solicitudes asincrónicas o las programadas, la respuesta es sólo una cadena llamada "result" con el valor "OK", si se ejecutó correctamente o, de lo contrario, el mensaje del error ocurrido.
<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 errores ocurridos en el servidor al ejecutar el servicio, pudiendo contener los siguientes valores: - Vacío o nulo, indicando que la ejecución fue realizada con éxito; - El mensaje del error ocurrido en el 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 Observación 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 - Somente informar quando integrado com Portaria 1510 ou o assinalamento "Justificar Marcações Digitadas" estiver com valor "S". |
| tMarDat.obsJMa | Opcional | String | - Justificativa da marcação informar quando integrado com Portaria 1510 para 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 o módulo Captura Ponto Portaria 373 na proprietária.
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> <codDsp>Integer</codDsp> <excPon>String</excPon> </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 |
| codDsp | Opcional | Integer | Código do dispositivo |
| excPon | Opcional | String | Excluído do Ponto Valor padrão - E |
Resposta:
Observación
Sobre SOAP de respuesta de solicitudes sincrónicas. Para las solicitudes asincrónicas o las programadas, la respuesta es sólo una cadena llamada "result" con el valor "OK", si se ejecutó correctamente o, de lo contrario, el mensaje del error ocurrido.
<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 errores ocurridos en el servidor al ejecutar el servicio, pudiendo contener los siguientes valores: - Vacío o nulo, indicando que la ejecución fue realizada con éxito; - El mensaje del error ocurrido en el servidor. |
English
Español


