RH - RM - PTO - Web Service PtoProcImportacaoBatidas

Tempo aproximado para leitura: 00:01:20 min

Dúvida
Como funciona e como utilizar o Web Service PtoProcImportacaoBatidas para a importação de batidas no sistema RM?

Ambiente
TOTVS RH - RH (Linha RM) - TOTVS Automação de Ponto - Todas as versões

Solução
O Web Service PtoProcImportacaoBatidas é responsável por automatizar e gerir o fluxo de entrada de marcações de ponto dentro do sistema RM.

As suas atribuições dividem-se em cinco pilares principais:

• Importação de Batidas.

• Integrações.

• Processamento de Regras.

• Pós-Processamento (Recálculo de espelho de ponto).

• Auditoria (Gravação de logs).

O processo é executado de forma assíncrona com base nos parâmetros enviados. Este processamento assíncrono evita timeouts em requisições que contenham volumes massivos de dados. Em caso de falha de validação crítica no payload de entrada, o método arremessa uma Exception de forma síncrona antes de iniciar a execução do Job em plano de fundo.

Endpoints e obtenção do contrato (WSDL):

• Endpoint do Serviço: http://:/RM.Pto.Server/PtoProcImportacaoBatidas.svc

• Obtenção do Contrato (WSDL): http://:/RM.Pto.Server/PtoProcImportacaoBatidas.svc?ws

É possível enviar ficheiros utilizando este WebService sem restrições, através dos métodos de requisição ExecuteWithXmlParams e ExecuteWithXmlParamsAsync.

Passos

1. Aceda ao contrato de integração utilizando o URL de Obtenção do Contrato (WSDL) mencionado na Solução.

2. Escolha o método de requisição ExecuteWithXmlParams ou ExecuteWithXmlParamsAsync.

3. Construa o payload da requisição em formato XML (protocolo SOAP 1.1/S).

4. Insira os parâmetros de envio dentro da tag <tot:strXmlParams>, conforme o exemplo de estrutura PtoImportacaoBatidaParam disponibilizado na documentação.

5. Envie a requisição para o Endpoint do Serviço para iniciar o processamento.

Saiba Mais
Web Service PtoProcImportacaoBatidas - Linha RM