TagguiRH × Senior G5 — Integração de Férias

02 — Fronteira

O que cada sistema faz

A Senior permanece como fonte oficial de cálculo e registro de férias na folha. A TagguiRH oferece a experiência de solicitação, aprovação e consulta de saldos para colaborador, gestor e RH.

TagguiRH

Módulo Férias

Solicitação, fluxo de aprovação, visão de saldos e períodos para colaborador e gestor, recibos e comunicações. Exibe os dados vindos da Senior e pode registrar na folha a programação aprovada, conforme escopo do projeto.

Senior G5 · Rubi

Folha e férias oficiais

Períodos aquisitivos (R040PER), programações (R040PRG), cálculo de saldo, recibo e integração com folha de pagamento. Continua sendo o sistema de RH e folha do cliente.

03 — Sequência

Da folha Senior até a experiência de Férias na TagguiRH

A sincronização parte do vínculo numEmp + tipCol + numCad (matrícula Senior), obtido na admissão digital ou no de-para de colaboradores.

TagguiRH

Senior G5 SOAP

Agendamento / gatilho Job de sincronização ou pendência

ConsultarPeriodoFerias por colaborador

ConsultarPeriodoFeriastabela R040PER

ConsultarTabelas R040PRG (programações)

ConsultarTabelas

alt · carga inicial ou incremental

Carga completa Consulta por lote de colaboradores datRef = hoje

Incremental ConsultarPendencias R040PER / R040PRG ConfirmarPendencias após processar

TagguiRH Atualiza saldos e períodos na tela

opt · write-back quando contratado

RH aprova solicitação na TagguiRH

ferias.Programacao

04 — Contrato SOAP

Como o G5 expõe os Web Services de Férias

Os serviços de consulta usam o prefixo rubi_ (Administração de Pessoal). A TagguiRH usa o WSDL síncrono para obter resposta imediata com erroExecucao.

Padrão de URL · módulo fp (folha)

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

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>

Campo	Papel	Notas
`numEmp` · `tipCol` · `numCad`	Chave do colaborador na Senior	Obrigatórios em todas as consultas de período. `tipCol`: 1 empregado, 2 terceiro, 3 parceiro.
`datRef`	Data de referência	Filtra períodos vigentes na data informada (ConsultarPeriodoFerias).
`campos`	Projeção	Lista de colunas R040PER separadas por vírgula; vazio retorna todas.
`erroExecucao`	Resultado	Vazio = sucesso. Texto = falha no servidor Senior.

Liberação de tabelas. Para ConsultarTabelas e ConsultarPendencias, o cliente precisa cadastrar R040PER, R040PRG e integrações em Recursos → Web Services → Cadastro Integrações.

05 — Orquestração

Ordem das chamadas na sincronização

Resolver vínculo do colaborador

CPF ou matrícula TagguiRH → numEmp, tipCol, numCad na Senior (admissão digital ou de-para manual).

Buscar períodos aquisitivos

ConsultarPeriodoFerias com datRef atual. Popula períodos abertos, vencidos e gozados na TagguiRH.

Buscar programações

ConsultarTabelas na R040PRG filtrando por empresa, tipo, cadastro e período aquisitivo (iniPer).

Manter atualizado

Job periódico ou ConsultarPendencias nas tabelas de férias; após processar, ConfirmarPendencias com status OK.

Write-back (opcional)

Quando o RH aprova na TagguiRH, ferias.Programacao ou GeracaoProgramacaoFerias.ProgramacaoFerias grava na folha com iniPer, datas de gozo e dias.

06 — Catálogo

Endpoints SOAP relevantes a Férias

Módulo Administração de Pessoal (com.senior.g5.rh.fp.*), versão pública HCM 6.10.4.

Serviço / porta	WSDL síncrono	Uso na TagguiRH
`integracoes` · ConsultarPeriodoFerias	rubi_Synccom_senior_g5_rh_fp_integracoes	Leitura principal. Períodos aquisitivos/concessivos do colaborador (R040PER): datas, saldo, situação.
`integracoes` · ConsultarTabelas	rubi_Synccom_senior_g5_rh_fp_integracoes	Programações de férias (R040PRG), tabelas auxiliares liberadas pelo cliente.
`integracoes` · ConsultarPendencias / ConfirmarPendencias	rubi_Synccom_senior_g5_rh_fp_integracoes	Sincronização incremental quando R040PER ou R040PRG mudam na folha.
`ferias` · Programacao	rubi_Synccom_senior_g5_rh_fp_ferias	Write-back. Incluir, alterar ou excluir programação na folha após aprovação na TagguiRH.
`GeracaoProgramacaoFerias` · ProgramacaoFerias	rubi_Synccom_senior_g5_rh_fp_GeracaoProgramacaoFerias	Alternativa com `apenasConsistir=S` para validar regras antes de gravar.
`consultarColaborador`	rubi_Synccom_senior_g5_rh_fp_consultarColaborador	Reconciliar matrícula e situação do colaborador antes de consultar férias.

07 — Contrato de dados

Do R040PER / R040PRG para a TagguiRH

Os nomes abaixo são os campos típicos retornados por ConsultarPeriodoFerias e ConsultarTabelas. O cliente pode restringir colunas via campos.

Período aquisitivo (R040PER)

TagguiRH (conceito)	Senior	O que trafega
Início do período aquisitivo	`iniPer`	Data que abre o período de direito a férias.
Fim do período aquisitivo	`fimPer`	Data de encerramento do período.
Limite concessivo	`datLim` / campos equivalentes	Último dia para iniciar o gozo sem perder direito (conforme regra da folha).
Dias de direito	`qtdDir`	Saldo total do período (ex.: 30 dias).
Dias gozados / abono	`qtdFer` · `qtdAbo`	Parcelas já consumidas ou vendidas.
Saldo disponível	derivado na Senior	Calculado na TagguiRH a partir dos campos do período ou regra acordada no projeto.
Situação do período	`sitPer`	Aberto, gozado, vencido, em programação — conforme domínio da folha.
Chave do colaborador	`numEmp` · `tipCol` · `numCad`	Vínculo com cadastro na folha.

Programação (R040PRG) — write-back

TagguiRH	Senior · Programacao	O que trafega
Data início das férias	`prgDat`	Primeiro dia de gozo aprovado.
Dias de férias	`prgDfe`	Quantidade de dias de gozo.
Abono pecuniário	`prgDAb`	Dias vendidos, se houver.
13º no recibo	`prg13s`	S ou N.
Período aquisitivo	`iniPer`	Qual período recebe a programação.
Status efetivo	`efePrg`	S efetiva · N provisória (conforme política do cliente).

08 — Domínios

Códigos que o XML exige

tipCol

1 Empregado · 2 Terceiro · 3 Parceiro.

programacoes.tipOpe

I Inclusão · A Alteração · E Exclusão.

prg13s · gerAdt · efePrg

S Sim · N Não — adiantamento 13º, adiantamento no recibo, programação efetiva.

pendencia.status

C Confirmado OK · E Confirmado com erro (ConfirmarPendencias).

09 — Exemplo

Consulta de períodos de férias

ConsultarPeriodoFerias · datRef hoje

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarPeriodoFerias>
      <user>TAGGUI.INTEGRACAO</user>
      <password>********</password>
      <encryption>0</encryption>
      <parameters>
        <consulta>
          <id>colab-88421</id>
          <campos>INIPER,FIMPER,QTDDIR,QTDFER,QTDABO,SITPER,DATLIM</campos>
          <numEmp>1</numEmp>
          <tipCol>1</tipCol>
          <numCad>88421</numCad>
          <datRef>21/09/2026</datRef>
        </consulta>
      </parameters>
    </ser:ConsultarPeriodoFerias>
  </soapenv:Body>
</soapenv:Envelope>

Resposta (recorte)

<ser:ConsultarPeriodoFeriasResponse>
  <result>
    <ocorrencia>
      <id>colab-88421</id>
      <resultado>
        <campo><nome>INIPER</nome><valor>01/03/2025</valor></campo>
        <campo><nome>FIMPER</nome><valor>28/02/2026</valor></campo>
        <campo><nome>QTDDIR</nome><valor>30</valor></campo>
        <campo><nome>QTDFER</nome><valor>0</valor></campo>
      </resultado>
    </ocorrencia>
    <erroExecucao></erroExecucao>
  </result>
</ser:ConsultarPeriodoFeriasResponse>

10 — De-para

Vínculos e tabelas liberadas

Na TagguiRH	Na Senior	Parâmetro / tabela
Colaborador	Cadastro Rubi	`numEmp` · `tipCol` · `numCad`
CPF (reconciliação)	R034FUN	`ConsultarTabelas` ou admissão digital
Período aquisitivo	R040PER	`ConsultarPeriodoFerias`
Programação de férias	R040PRG	`ConsultarTabelas` / `ferias.Programacao`
Empresa	Empresas do Rubi	`numEmp`

11 — Go-live

O que o cliente precisa entregar

Acesso

Endpoint e credencial

Host, porta, usuário de integração com permissão AP (férias) e rota de rede até /g5-senior-services/.

Cadastros

Integrações liberadas

R040PER e R040PRG em Consultar Tabelas; integração de pendências se usar carga incremental.

Negócio

Regras de férias

Quem aprova na TagguiRH vs na Senior, se há write-back, parcelamento, abono e tratamento de período vencido.

Escopo. Exibir saldos e períodos vindos da folha Senior no módulo Férias da TagguiRH. Write-back de programação é opcional e definido por projeto. Cálculo de recibo e folha permanecem na Senior.

12 — Fontes

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

com.senior.g5.rh.fp.integracoes — ConsultarPeriodoFerias, ConsultarTabelas, ConsultarPendencias com.senior.g5.rh.fp.ferias — Programacao com.senior.g5.rh.fp.GeracaoProgramacaoFerias — ProgramacaoFerias com.senior.g5.rh.fp.consultarColaborador

Férias TagguiRH sincronizadas com a folha Senior

O que cada sistema faz

Módulo Férias

Folha e férias oficiais

Da folha Senior até a experiência de Férias na TagguiRH

Como o G5 expõe os Web Services de Férias

Envelope comum

Ordem das chamadas na sincronização

Resolver vínculo do colaborador

Buscar períodos aquisitivos

Buscar programações

Manter atualizado

Write-back (opcional)

Endpoints SOAP relevantes a Férias

Do R040PER / R040PRG para a TagguiRH

Período aquisitivo (R040PER)

Programação (R040PRG) — write-back

Códigos que o XML exige

Consulta de períodos de férias

Vínculos e tabelas liberadas

O que o cliente precisa entregar

Endpoint e credencial

Integrações liberadas

Regras de férias

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