TagguiRH
Integração · Senior G5 · Admissão digital
Documentação de integração · confidencial cliente

Admissão digital TagguiRH na folha Senior

Quando a admissão digital é completamente finalizada na TagguiRH, o colaborador é criado no Gestão de Pessoas HCM (Senior G5 / Rubi) — o sistema de folha do cliente — com as informações coletadas no processo, via Web Services SOAP/XML da Administração de Pessoal.

TagguiRH · admissão digital Senior G5 · folha SOAP 1.1 · XML HCM 6.10.4 Agosto 2026
02 — Fronteira

O que cada sistema faz

A TagguiRH conduz a admissão. A Senior permanece como folha e cadastro oficial do colaborador.

TagguiRH

Admissão digital

Convite, coleta de dados e documentos, conta bancária ou PIX, dependentes quando houver, assinaturas e revisão do RH. A integração com a folha dispara somente após a finalização completa.

Senior G5 · Rubi

Folha e cadastro oficial

Ficha do colaborador, dados para pagamento, documentos e demais cadastros da Administração de Pessoal. Continua sendo o sistema de RH e folha do cliente.

03 — Sequência

Da finalização na TagguiRH até o cadastro na folha

O disparo ocorre uma única vez, depois que o processo está concluído: passos do colaborador, documentos, assinaturas e encerramento do RH.

04 — Contrato SOAP

Como o G5 expõe os Web Services

Cada serviço tem três WSDLs no host do cliente. A TagguiRH usa o síncrono na finalização (resposta imediata com numCad e erroExecucao).

Padrão de URL · substituir host e porta do ambiente
http://{host}:{porta}/g5-senior-services/rubi_Synccom_senior_g5_rh_fp_{servico}?wsdl
http://{host}:{porta}/g5-senior-services/rubi_Asynccom_senior_g5_rh_fp_{servico}?wsdl
http://{host}:{porta}/g5-senior-services/rubi_Scheduledcom_senior_g5_rh_fp_{servico}?wsdl

Envelope comum a todas as portas

<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>
CampoPapelNotas oficiais
userUsuário do Gerenciador SeniorConta de integração, não de pessoa física. Precisa de permissão nos módulos AP (folha).
passwordSenha da conta de integraçãoEnviada no envelope SOAP. O tráfego exige TLS.
encryptionTipo de autenticaçãoNo padrão da Senior: 0 para senha. Outros valores seguem a configuração do ambiente do cliente.
tipOpeOperaçãoI inclusão · A alteração · E exclusão. Obrigatório na Ficha Básica.
erroExecucaoResultadoVazio/nulo = sucesso. Qualquer texto = falha no servidor Senior.
Rede. O G5 costuma estar on-premise. A TagguiRH precisa de rota (VPN, IP allowlist ou reverse proxy) até /g5-senior-services/. Sem isso o XML não chega.
05 — Orquestração

Ordem das chamadas na finalização

A Ficha Básica cria a pessoa. As demais portas enriquecem o mesmo numCad. Não há um único XML que carregue tudo.

Idempotência por CPF

Consulta nas tabelas da Senior filtrando CPF. Se o cadastro já existir, a TagguiRH atualiza em vez de incluir de novo.

Criar / atualizar ficha básica

FichaBasica_7 com tipOpe=I e numCad=0 (Senior gera a matrícula) ou A se já existir. Resposta devolve numEmp e numCad.

Complemento civil e contato

FichaComplementar_7: endereço, telefones, e-mails, RG, título, CNH, nome social, certidões, passaporte, contrato de experiência.

Pagamento

Se o cliente usa histórico de contas: portas ContaBancaria e ChavePix. Caso contrário, banco/PIX podem ir na própria Ficha Básica (codBan, chvPix, modPag=P).

Família e PcD

Dependente_2 para IR/salário-família/e-Social. Deficiencias quando houver laudo. Estrangeiro_2 para imigrante.

Anexos (opcional)

Porta Documento da ficha complementar envia blob (arqDoc) com tipo cadastrado em Tabelas → Tipos de Documentos.

06 — Catálogo

Endpoints SOAP relevantes à admissão

Todos no 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
fichaBasica · FichaBasica_7 rubi_Synccom_senior_g5_rh_fp_fichaBasica Criar o colaborador. Preferir _7 (CNPJ alfanumérico). _6 é a versão anterior, mesmos dados de admissão.
Portas da mesma WSDL ContaBancaria, ChavePix, Deficiencias, Estrangeiro_2, Filhos, Ponto, Sindicato… Complementos da ficha. Filhos só grava datas de nascimento; dependentes fiscais usam o serviço abaixo.
fichaComplementar · FichaComplementar_7 rubi_Synccom_senior_g5_rh_fp_fichaComplementar Endereço, documentos civis, e-mail, telefone, nome social, experiência.
Documento mesma WSDL complementar Upload de imagens/PDF para R034DOC (RG, CTPS, comprovantes).
dependentes · Dependente_2 rubi_Synccom_senior_g5_rh_fp_dependentes Filhos, cônjuge, IR, salário-família, e-Social do dependente.
consultarColaborador rubi_Synccom_senior_g5_rh_fp_consultarColaborador Ler um cadastro por empresa + tipo + numCad (pós-criação ou reconciliação).
integracoes · ConsultarTabelas rubi_Synccom_senior_g5_rh_fp_integracoes Ler tabelas (cargos, filiais, centros de custo, CPF em R034FUN). Configurar quais tabelas o WS pode devolver em Recursos → Web Services → Cadastro Integrações.
ConsultarPendencias / ConfirmarPendencias mesma WSDL integracoes Fila de pendências da Senior. Fora do fluxo padrão desta integração; disponível se o projeto exigir.
Outros módulos. Existem fichaBasica em Ponto (hr), R&S (rs), PLR etc. Para folha do cliente o contrato é o da Administração de Pessoal (fp).
07 — Contrato de dados

Campos da primeira entrega

O recorte abaixo é o núcleo para criar o colaborador na folha. O mapeamento cresce conforme o escopo de cada projeto: o que a admissão digital já coleta na TagguiRH pode ser incluído na Senior quando o cliente pedir.

Escopo evolutivo. Esta integração começa no cadastro essencial e pode incorporar, no mesmo desenho SOAP, dependentes, documentos anexos, PIX, PcD, imigração, CNH, título de eleitor e demais guias da ficha. O que entra em cada fase é definido no projeto.

Núcleo — identidade, contrato e pagamento

TagguiRHSeniorO que trafega
NomenomFunNome civil do colaborador.
CPFnumCpfIdentificação única na folha.
Data de admissãodatAdmObrigatória na inclusão.
Data de nascimento e sexodatNas · tipSexDados pessoais básicos.
Empresa / filialnumEmp · codFilDe-para com os códigos da Senior.
Cargo, local, centro de custocodCar · numLoc · codCcuCadastros já existentes na folha.
Tipo de contrato / vínculotipCon · codVinHviEx.: empregado, estagiário, aprendiz.
Categoria eSocialcateSoEx.: 101 empregado, 103 aprendiz, 901 estagiário.
SaláriovalSalHsaValor e tipo (mensalista, horista etc.).
E-mail e telefoneemaCom · numTelContato profissional.
EndereçoendRua · endCep · UF / cidadeResidência na ficha complementar.
RG / CTPS / PISnumCid · numCtp · numPisDocumentos principais, quando coletados.
Conta bancária ou PIXcodBan / chvPixForma de pagamento combinada no projeto.
Matrícula SeniornumCadGerada na inclusão (0) e devolvida na resposta.

Crescimento conforme o projeto

A Senior já expõe portas SOAP para o restante da ficha. A TagguiRH liga cada bloco quando o escopo do cliente incluir aquele dado na admissão digital.

Contato e documentos civis

Ficha complementar

Nome social, e-mail pessoal, endereço completo, RG, título de eleitor, CNH, certidões, passaporte e prazo de experiência.

Pagamento

Conta e PIX

Histórico de contas bancárias, tipo de conta e chave PIX — além da conta simples já prevista no núcleo.

Família

Dependentes

Nome, nascimento, parentesco, CPF e flags de IR / salário-família, quando a admissão digital coletar dependentes.

Complementos

PcD, imigração e anexos

Deficiências e cota, dados de trabalhador imigrante, e upload de documentos (RG, CTPS, comprovantes) para o cadastro na Senior.

08 — Domínios

Códigos que o XML exige (não texto livre)

tipCon · tipo de contrato

1 Empregado · 2 Diretor não empregado · 3 Rural · 4 Aposentado · 5 Estagiário · 6 Aprendiz · 7 Prazo determinado · 8 Diretor aposentado · 9 Agente público · 10 Professor · 11 Cooperado · 12 Doméstico.

estCiv · estado civil

1 Solteiro · 2 Casado · 3 Divorciado · 4 Viúvo · 5 Concubinato · 6 Separado · 9 Outros.

graIns · escolaridade RAIS

1 Analfabeto … 5 1º grau completo · 7 2º grau completo · 9 superior completo · 10 pós · 11 mestrado · 12 doutorado · 13 Ph.D.

modPag · pagamento

C cheque · R relação bancária · D dinheiro · O ordem · P Pix.

cateSo · eSocial (recorte)

101 empregado · 103 aprendiz · 104 doméstico · 901 estagiário · 721 diretor com FGTS. Lista completa na documentação FichaBasica.

graPar · parentesco

1 Filho · 2 Cônjuge · 11 Enteado · 14 Adotivo · 16 Companheiro · 17 Tutelado · 18 Menor sob guarda · 99 Outros.

09 — Exemplo

Inclusão mínima de um CLT

Ilustrativo. Códigos de filial, cargo, local, vínculo e escala são os do ambiente do cliente.

FichaBasica_7 · tipOpe I · numCad 0
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:FichaBasica>
      <user>TAGGUI.INTEGRACAO</user>
      <password>********</password>
      <encryption>0</encryption>
      <parameters>
        <numEmp>1</numEmp>
        <numCad>0</numCad>
        <tipOpe>I</tipOpe>
        <nomFun>ANA CLARA SOUZA</nomFun>
        <numCpf>123.456.789-09</numCpf>
        <datAdm>01/09/2026</datAdm>
        <datNas>14/03/1998</datNas>
        <tipSex>F</tipSex>
        <codFil>1</codFil>
        <codCar>ANALISTA</codCar>
        <numLoc>0101</numLoc>
        <codCcu>1000</codCcu>
        <codVinHvi>1</codVinHvi>
        <tipCon>1</tipCon>
        <cateSo>101</cateSo>
        <indAdm>1</indAdm>
        <admeSo>1</admeSo>
        <tipAdmHfi>1</tipAdmHfi>
        <sitAfa>1</sitAfa>
        <estCiv>1</estCiv>
        <graIns>9</graIns>
        <tipOpc>S</tipOpc>
        <modPag>P</modPag>
        <tpcPix>3</tpcPix>
        <valSalHsa>4500,00</valSalHsa>
        <tipSalHsa>1</tipSalHsa>
        <recAdi>S</recAdi>
        <rec13S>S</rec13S>
        <pagSin>N</pagSin>
        <socSinHsi>N</socSinHsi>
      </parameters>
    </ser:FichaBasica>
  </soapenv:Body>
</soapenv:Envelope>
Resposta de sucesso
<ser:FichaBasicaResponse>
  <result>
    <numEmp>1</numEmp>
    <numCad>88421</numCad>
    <erroExecucao></erroExecucao>
  </result>
</ser:FichaBasicaResponse>
10 — De-para

A Senior trabalha com códigos já cadastrados

Antes do go-live a TagguiRH recebe a tabela de tradução do cliente. Filial, cargo, local e centro de custo na TagguiRH apontam para os códigos correspondentes na Senior.

Na TagguiRHNa SeniorParâmetro
Empresa / CNPJEmpresas do RubinumEmp
FilialFiliaiscodFil
CargoCargos (com CBO)codCar
Local / organogramaLocaisnumLoc
Centro de custoC.CustocodCcu
VínculoVínculoscodVinHvi
SindicatoSindicatoscodSinHsi
Escala / horárioEscalas e horárioscodEsc / horBas
Cidade / bairroMunicípios e bairros SeniorcodCid codBai
Banco / agênciaBancos e agênciascodBan codAge
Tipo de documento (anexo)Tabelas / Tipos de documentostipDoc
DeficiênciaTabela de deficiênciascodDef
NacionalidadeTabela RAIScodNac
Tabelas de apoio. A Senior permite consultar cargos, filiais e centros de custo via Web Service, depois que o cliente libera essas tabelas no cadastro de integrações.
11 — Go-live

O que o cliente precisa entregar

Acesso

Endpoint e credencial

Host e porta de g5-senior-services, usuário de integração, senha, e rota de rede até a TagguiRH.

Cadastros

De-para

Planilha: filial TagguiRH → codFil, cargo → codCar, centro de custo, local, vínculo e bancos.

Negócio

Regras de folha

Categoria eSocial padrão, 1º emprego vs reemprego, PIX vs conta, se usa histórico bancário, se anexa documentos no G5.

Falhas e reprocessamento

  • Sucesso com erroExecucao vazio. A TagguiRH guarda a matrícula (numCad) devolvida para não duplicar.
  • Falha de tabela (cargo ou filial inexistente) não cria a pessoa: o RH ajusta o de-para e reprocessa.
  • Se a ficha nascer e um complemento falhar (PIX, dependente), o reprocesso atualiza o cadastro já criado.
  • A TagguiRH usa o WSDL síncrono na finalização, para receber a matrícula na hora.
Escopo. Criar ou atualizar o colaborador na folha Senior quando a admissão digital na TagguiRH estiver finalizada. Ponto, férias, rescisão e demais rotinas da folha permanecem na Senior. O volume de campos enviados cresce com o escopo do projeto.
12 — Fontes

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

Referência dos Web Services públicos da Senior utilizados nesta integração.