TagguiRH × Senior G5 — Integração de Ponto

02 — Fronteira

O que cada sistema faz

A Senior permanece como motor de apuração e registro oficial das marcações. A TagguiRH oferece marcação (app/web), espelho, fluxos de gestão e experiência do colaborador.

TagguiRH

Módulo Ponto

Marcação no app e na web, espelho de ponto, banco de horas na interface, aprovações e alertas. Importa batidas e jornada da Senior; pode exportar marcações aprovadas conforme escopo.

Senior G5 · Ronda

Controle de Ponto oficial

Marcações (R070ACC), apuração, escalas, afastamentos, coletores e cálculo de jornada. Continua sendo o sistema de ponto e folha do cliente.

03 — Sequência

Da Senior até o espelho na TagguiRH

O vínculo usa numEmp + tipCol + numCad e, quando aplicável, o número do crachá (numCra).

TagguiRH

Senior G5 SOAP · hr

Agendamento / competência Job de importação de batidas

ConsultarTabelas R070ACC (marcações)

hr.integracoes · ConsultarTabelas

Histórico de escala / afastamento

hr.historicos · Escala / Afastamento

alt · carga ou tempo real

Lote diário Filtro DATAPU na competência

Incremental ConsultarPendencias R070ACC

TagguiRH Espelho e Minhas batidas atualizados

opt · batida na TagguiRH → Senior

Colaborador marca no app TagguiRH

calculoApuracao · Gravar

04 — Contrato SOAP

Como o G5 expõe os Web Services de Ponto

Os serviços do Controle de Ponto usam o prefixo ronda_ no WSDL. Consultas de tabela passam por hr.integracoes; gravação de marcações por hr.calculoApuracao.

Padrão de URL · módulo hr (ponto)

http://{host}:{porta}/g5-senior-services/ronda_Synccom_senior_g5_rh_hr_{servico}?wsdl

Coletor Web Service. A porta Gravar exige coletor cadastrado com modelo 97 — Web service. Sem isso a Senior rejeita a inclusão de marcação.

Envelope comum

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:{Porta}>
      <user>usuario.integracao</user>
      <password>••••••••</password>
      <encryption>0</encryption>
      <parameters>…</parameters>
    </ser:{Porta}>
  </soapenv:Body>
</soapenv:Envelope>

05 — Orquestração

Ordem das chamadas na integração

Vínculo colaborador ↔ crachá

Resolver numCad e numCra via CPF (consultarColaboradorPorCPF) ou de-para do projeto.

Importar marcações

ConsultarTabelas em R070ACC com filtro por empresa, cadastro e DATAPU (data de apuração) no intervalo da competência.

Contexto de jornada

historicos.Escala e Afastamento para montar escala esperada e afastamentos no espelho TagguiRH.

Incremental

ConsultarPendencias na integração de ponto; confirmar após processar cada lote.

Exportar batidas (opcional)

calculoApuracao.Gravar com oriAcc=E (eletrônica) ou Acertar para ajustes com justificativa.

06 — Catálogo

Endpoints SOAP relevantes ao Ponto

Módulo Controle de Ponto e Refeitório (com.senior.g5.rh.hr.*), HCM 6.10.4.

Serviço / porta	WSDL síncrono	Uso na TagguiRH
`hr.integracoes` · ConsultarTabelas	ronda_Synccom_senior_g5_rh_hr_integracoes	Leitura principal. Marcações R070ACC (data, hora, origem, sequência, crachá).
`hr.integracoes` · ConsultarPendencias	ronda_Synccom_senior_g5_rh_hr_integracoes	Detectar novas/alteradas marcações sem varrer toda a base.
`hr.calculoApuracao` · Gravar	ronda_Synccom_senior_g5_rh_hr_calculoApuracao	Write-back. Inserir batida do app TagguiRH na Senior (coletor 97).
`hr.calculoApuracao` · Acertar	ronda_Synccom_senior_g5_rh_hr_calculoApuracao	Incluir/alterar/excluir marcação com justificativa na tela de acertos.
`hr.calculoApuracao` · Calcular	ronda_Synccom_senior_g5_rh_hr_calculoApuracao	Disparar apuração na Senior após lote de marcações (uso pontual; cuidado com performance).
`hr.historicos` · Escala · Afastamento_5 · Apuracao_4	ronda_Synccom_senior_g5_rh_hr_historicos	Escala vigente, afastamentos e forma de apuração do colaborador.
`hr.consultarColaboradorPorCPF`	ronda_Synccom_senior_g5_rh_hr_consultarColaboradorPorCPF	Resolver matrícula e crachá a partir do CPF.

Não confundir módulos. O serviço fichaBasica do módulo fp tem uma porta Ponto para cadastro na folha — é outro contexto. Para batidas e apuração use hr.

07 — Contrato de dados

Da R070ACC para a TagguiRH

TagguiRH	Senior · R070ACC	O que trafega
Data da batida	`DATACC`	Data civil da marcação.
Hora da batida	`HORACC`	Horário hh:mm.
Data de apuração	`DATAPU`	Dia de competência ao qual a marcação pertence na jornada.
Sequência	`SEQACC`	Ordem da batida no dia (chave junto com crachá e data).
Origem	`ORIACC`	D digitada · E eletrônica · G gerada · R regularizada.
Crachá	`NUMCRA`	Identificador físico/lógico do colaborador no ponto Senior.
Coletor	`CODRLG`	Relógio ou coletor que registrou (ou 97 para Web Service).
Colaborador	`NUMEMP` · `TIPCOL` · `NUMCAD`	Chave na folha.

Gravar batida (TagguiRH → Senior)

TagguiRH	Senior · Gravar	Notas
Timestamp da marcação	`datAcc` · `horAcc`	Data e hora enviadas ao gravar.
Data de apuração	`datApu`	Dia de competência (pode diferir em virada de turno).
Origem eletrônica	`oriAcc` = E	Marcação vinda de app/dispositivo.
Coletor Web Service	`codRlg`	Deve apontar para coletor modelo 97.
Fuso	`fusMar`	Quando o colaborador está em fuso diferente (viagem).

08 — Domínios

Códigos usados nas marcações

oriAcc / oriMar

D Digitada · E Eletrônica · G Gerada · R Regularizada.

tipCol

1 Empregado · 2 Terceiro · 3 Parceiro.

apuPon (apuração)

1 Normal · 2 Dispensado · 4 Desconsidera todas · 5 Sem controle · 6 Dispensado parcial.

Acertar.tipOpe

G Gravar · A Apurar (recomendado na prática: G ou AG conforme ambiente).

09 — Exemplo

Consulta de marcações na competência

ConsultarTabelas · R070ACC

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarTabelas>
      <user>TAGGUI.INTEGRACAO</user>
      <password>********</password>
      <encryption>0</encryption>
      <parameters>
        <consulta>
          <id>marc-88421-092026</id>
          <tabela>R070ACC</tabela>
          <campos>NUMEMP,TIPCOL,NUMCAD,NUMCRA,DATACC,HORACC,DATAPU,SEQACC,ORIACC,CODRLG</campos>
          <filtro>
            <campo>NUMEMP</campo><condicao>=</condicao><valor>1</valor>
          </filtro>
          <filtro>
            <campo>NUMCAD</campo><condicao>=</condicao><valor>88421</valor>
          </filtro>
          <filtro>
            <campo>DATAPU</campo><condicao>>=</condicao><valor>01/09/2026</valor>
          </filtro>
          <filtro>
            <campo>DATAPU</campo><condicao><=</condicao><valor>30/09/2026</valor>
          </filtro>
        </consulta>
      </parameters>
    </ser:ConsultarTabelas>
  </soapenv:Body>
</soapenv:Envelope>

Gravar batida do app (recorte)

<ser:Gravar>
  <parameters>
    <numEmp>1</numEmp>
    <tipCol>1</tipCol>
    <numCad>88421</numCad>
    <numCra>88421</numCra>
    <datAcc>21/09/2026</datAcc>
    <horAcc>08:02</horAcc>
    <datApu>21/09/2026</datApu>
    <codRlg>97</codRlg>
    <oriAcc>E</oriAcc>
    <seqAcc>0</seqAcc>
  </parameters>
</ser:Gravar>

10 — De-para

Tabelas e cadastros liberados

Na TagguiRH	Na Senior	Parâmetro / tabela
Colaborador	Cadastro + crachá	`numCad` · `numCra`
Batida / marcação	R070ACC	`ConsultarTabelas` / `Gravar`
Escala	Histórico de escala	`historicos.Escala`
Afastamento	R038AFA	`historicos.Afastamento` ou tabela liberada
Coletor integração	Cadastro de relógios	Modelo 97 — Web service
Competência do espelho	`DATAPU`	Intervalo de datas no filtro da consulta

11 — Go-live

O que o cliente precisa entregar

Acesso

Endpoint e credencial

Host, porta, usuário com permissão CP (ponto) e rota até /g5-senior-services/.

Cadastros

Tabelas e coletor

R070ACC liberada em Consultar Tabelas; coletor 97 para write-back; de-para crachá ↔ colaborador.

Negócio

Modelo de integração

Só leitura (espelho espelha Senior) vs bidirecional (Taggui marca e Senior apura); tratamento de virada de turno e fuso.

Escopo. Importar batidas e contexto de jornada da Senior para o Ponto TagguiRH. Apuração oficial, banco de horas na folha e fechamento de competência permanecem na Senior, salvo acordo explícito de cálculo na TagguiRH.

12 — Fontes

Documentação pública Senior (HCM 6.10.4)

com.senior.g5.rh.hr.integracoes — ConsultarTabelas, ConsultarPendencias com.senior.g5.rh.hr.calculoApuracao — Gravar, Acertar, Calcular com.senior.g5.rh.hr.historicos — Escala, Afastamento, Apuracao com.senior.g5.rh.hr.consultarColaboradorPorCPF Índice Controle de Ponto e Refeitório

Ponto TagguiRH integrado ao Controle de Ponto Senior

O que cada sistema faz

Módulo Ponto

Controle de Ponto oficial

Da Senior até o espelho na TagguiRH

Como o G5 expõe os Web Services de Ponto

Envelope comum

Ordem das chamadas na integração

Vínculo colaborador ↔ crachá

Importar marcações

Contexto de jornada

Incremental

Exportar batidas (opcional)

Endpoints SOAP relevantes ao Ponto

Da R070ACC para a TagguiRH

Gravar batida (TagguiRH → Senior)

Códigos usados nas marcações

Consulta de marcações na competência

Tabelas e cadastros liberados

O que o cliente precisa entregar

Endpoint e credencial

Tabelas e coletor

Modelo de integração

Documentação pública Senior (HCM 6.10.4)