Guias Práticos

RM TOTVS

Este guia procura apresentar as principais premissas relacionadas à integração do Gupy Admissão com o sistema de folha RM TOTVS.

Na RM TOTVS podem ser trafegados dados de admissão de CLT com dependentes, sendo brasileiros ou estrangeiros. Também é possível integrar campos relacionados à estagiários e jovem aprendiz.

Suggest Edits

📘

Requisitos mínimos para uma conexão de sucesso

  • Endpoints dos ambientes;
  • Dados para utilização da VPN (caso seja utilizado);
  • Payload para validação, com as tags XML e dados válidos

Infraestrutura e segurança

Antes de iniciar a integração, é importante validar:

  • Se há alguma restrição de acesso para construção de VPN entre um ambiente externo e os pontos de conexão disponibilizados;
  • Se haverá uma comunicação fluida e facilitada com o time dedicado à segurança e infraestrutura, principalmente se eles não operarem no Brasil;
  • Se existe alguma restrição na criação de diretório, servidor SFTP ou conta de e-mail que será acessada por um serviço externo;
  • Se há entraves gerados a partir da LGPD que a integração deve atender;
  • Se os padrões de segurança permitam a criação de usuário com permissão de escrita nas tabelas que serão utilizadas.

Autenticação

  • Geralmente, uma VPN é utilizada para garantir maior segurança;
  • A RM TOTVS utiliza método de autenticação básica com Usuário e Senha;

Conectividade

  • O formato do arquivo utilizado é o XML;
  • A TOTVS trabalha com webservices utilizando o TOTVS Business Connector (TBC);
  • Com o TBC, conseguimos inserir as tabelas mostradas abaixo PPESSOA, PFUNC e PFDEPEND;
  • Caso a chapa não seja gerada automaticamente, será necessário configurar uma query SQL para trazer a última chapa. Assim, é possível fazer uma requisição no serviço RealizarConsultaSQL através de algum parâmetro definido pelo cliente, retornar a última chapa para incrementar +1 e utilizá-la.

Fluxo de Integração

  1. Webhook pre-employee.moved da Gupy é recebido;
  2. Os dados são filtrados de acordo com o admission.status, coletando informações apenas dos candidatos que estão na etapa definida como gatilho;
  3. Utilização dos dados do webhook para realizar enriquecimento de dados com consultas a API da Gupy;
  4. Realização de/para e transformações de dados;
  5. Montagem do XML e postagem no endpoint disponibilizado pelo barramento ou envio para SFTP;
  6. Validação do retorno do envio (status 200) para finalizar.

Envio das informações

A RM TOTVS espera receber um arquivo XML como o modelo abaixo:
Apesar da seperação entre "Pessoa" e "Funcionário", é possível mandar os dados somente na tabela de "Funcionário".

RhuPessoa:

<PPessoa>  
    <CODIGO>1</CODIGO>  
    <NOME>ITAMAR MENDES DA SILVEIRA</NOME>  
    <DTNASCIMENTO>1965-08-10T00:00:00</DTNASCIMENTO>  
    <ESTADONATAL>MG</ESTADONATAL>  
    <NATURALIDADE>Belo Horizonte</NATURALIDADE>  
    <APELIDO>asdf</APELIDO>  
    <SEXO>M</SEXO>  
    <NACIONALIDADE>10</NACIONALIDADE>  
    <GRAUINSTRUCAO>9</GRAUINSTRUCAO>  
    <RUA>Rua Mata Atlantica</RUA>  
    <NUMERO>333</NUMERO>  
    <BAIRRO>Planalto</BAIRRO>  
    <ESTADO>MG</ESTADO>  
    <CIDADE>Belo Horizonte</CIDADE>  
    <CEP>30100020</CEP>  
    <PAIS>Brasil</PAIS>  
    <REGPROFISSIONAL>Reg-00098</REGPROFISSIONAL>  
    <CPF>51427362653</CPF>  
    <IDIMAGEM>844</IDIMAGEM>  
    <TELEFONE1>4613636</TELEFONE1>  
    <CARTIDENTIDADE>M 267392</CARTIDENTIDADE>  
    <UFCARTIDENT>MG</UFCARTIDENT>  
    <ORGEMISSORIDENT>SSP</ORGEMISSORIDENT>  
    <DTEMISSAOIDENT>1993-04-25T00:00:00</DTEMISSAOIDENT>  
    <TITULOELEITOR>123.334</TITULOELEITOR>  
    <ZONATITELEITOR>0012</ZONATITELEITOR>  
    <SECAOTITELEITOR>0006</SECAOTITELEITOR>  
    <CARTEIRATRAB>015116</CARTEIRATRAB>  
    <SERIECARTTRAB>00001</SERIECARTTRAB>  
    <UFCARTTRAB>MG</UFCARTTRAB>  
    <DTCARTTRAB>1993-03-01T00:00:00</DTCARTTRAB>  
    <NIT>0</NIT>  
    <CARTMOTORISTA>13.344.543</CARTMOTORISTA>  
    <TIPOCARTHABILIT>A</TIPOCARTHABILIT>  
    <DTVENCHABILIT>1997-02-05T00:00:00</DTVENCHABILIT>  
    <CERTIFRESERV>12856945678</CERTIFRESERV>  
    <CATEGMILITAR>CDI</CATEGMILITAR>  
    <CONJUGEBRASIL>0</CONJUGEBRASIL>  
    <NATURALIZADO>0</NATURALIZADO>  
    <FILHOSBRASIL>0</FILHOSBRASIL>  
    <NROFILHOSBRASIL>0</NROFILHOSBRASIL>  
    <EMAIL>[email protected]</EMAIL>  
    <INVESTTREINANT>2300.00</INVESTTREINANT>  
    <CORRACA>0</CORRACA>  
    <DEFICIENTEFISICO>0</DEFICIENTEFISICO>  
    <CODUSUARIO>simone</CODUSUARIO>  
    <TELEFONE3>21229000</TELEFONE3>  
    <EMPRESA>RM SISTEMAS S.A</EMPRESA>  
    <CODOCUPACAO>10</CODOCUPACAO>  
    <BRPDH>0</BRPDH>  
    <FUMANTE>0</FUMANTE>  
    <AJUSTATAMANHOFOTO>0</AJUSTATAMANHOFOTO>  
    <DEFICIENTEAUDITIVO>0</DEFICIENTEAUDITIVO>  
    <DEFICIENTEFALA>0</DEFICIENTEFALA>  
    <DEFICIENTEVISUAL>0</DEFICIENTEVISUAL>  
    <DEFICIENTEMENTAL>0</DEFICIENTEMENTAL>  
    <DATAAPROVACAOCURR>2005-04-01T09:36:02.66</DATAAPROVACAOCURR>  
<IMAGEM>/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wAARCACgAIIDASIAAhEBAxEB/8QAHwAAA</IMAGEM>  
    <ESTADOROW>0</ESTADOROW>  
    <ROWVALIDA>0</ROWVALIDA>  
    <ALUNO>1</ALUNO>  
    <PROFESSOR>1</PROFESSOR>  
    <CANDIDATO>1</CANDIDATO>  
    <USUARIOBIBLIOS>1</USUARIOBIBLIOS>  
    <FUNCIONARIO>1</FUNCIONARIO>  
    <EXFUNCIONARIO>0</EXFUNCIONARIO>  
    <DEFICIENTEINTELECTUAL>0</DEFICIENTEINTELECTUAL>  
    <FALECIDO>0</FALECIDO>  
    <IDADE>53</IDADE>  
  </PPessoa>  
  <VPCompl>  
    <CODPESSOA>1</CODPESSOA>  
    <IDADE>34</IDADE>  
    <PESO>75</PESO>  
  </VPCompl>  
</RhuPessoa>

FopFunc:

<PFunc>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CHAPA>999999</CHAPA>
    <NROFICHAREG>999999</NROFICHAREG>
    <CODRECEBIMENTO>M</CODRECEBIMENTO>
    <CODSITUACAO>A</CODSITUACAO>
    <HSTSIT_DATAMUDANCA>2022-05-25T00:00:00</HSTSIT_DATAMUDANCA>
    <HSTSIT_MOTIVO>01</HSTSIT_MOTIVO>
    <CODTIPO>N</CODTIPO>
    <CODSECAO>01.02.05.1.10.01</CODSECAO>
    <DTMUDANCASECAO>2022-05-25T00:00:00</DTMUDANCASECAO>
    <MOTMUDANCASECAO>01</MOTMUDANCASECAO>
    <CODFUNCAO>000182</CODFUNCAO>
    <DTMUDANCAFUNCAO>2022-05-25T00:00:00</DTMUDANCAFUNCAO>
    <MOTMUDANCAFUNCAO>01</MOTMUDANCAFUNCAO>
    <CODSINDICATO>06</CODSINDICATO>
    <CODHORARIO>002C2</CODHORARIO>
    <DTMUDANCAHORARIO>2022-05-25T00:00:00</DTMUDANCAHORARIO>
    <NRODEPIRRF>1</NRODEPIRRF>
    <NRODEPSALFAM>0</NRODEPSALFAM>
    <DTBASE>2022-05-25T00:00:00</DTBASE>
    <SALARIO>17764.63</SALARIO>
    <DTMUDANCASALARIO>2022-05-25T00:00:00</DTMUDANCASALARIO>
    <MOTMUDANCASALARIO>01</MOTMUDANCASALARIO>
    <SITUACAOFGTS>1</SITUACAOFGTS>
    <DTOPCAOFGTS>2022-05-25T00:00:00</DTOPCAOFGTS>
    <CONTAFGTS>44106</CONTAFGTS>
    <SALDOFGTS>452813.36</SALDOFGTS>
    <!--DTSALDOFGTS>2019-09-01T00:00:00</DTSALDOFGTS-->
    <HSTSEFIP_DTMUDANCA>2022-05-25T00:00:00</HSTSEFIP_DTMUDANCA>
    <CONTRIBSINDICAL>X</CONTRIBSINDICAL>
    <APOSENTADO>1</APOSENTADO>
    <TEMMAIS65ANOS>1</TEMMAIS65ANOS>
    <DATAADMISSAO>2022-05-25T00:00:00</DATAADMISSAO>
    <TIPOADMISSAO>R</TIPOADMISSAO>
    <MOTIVOADMISSAO>01</MOTIVOADMISSAO>
    <TEMPRAZOCONTR>1</TEMPRAZOCONTR>
    <!--DTVENCFERIAS>2022-04-03T00:00:00</DTVENCFERIAS-->
    <QUERABONO>0</QUERABONO>
    <QUER1APARC13O>0</QUER1APARC13O>
    <FERIASCOLETIVAS>0</FERIASCOLETIVAS>
    <!--NRODIASABONO>0.00</NRODIASABONO-->
    <!--SALDOFERIAS>0.00</SALDOFERIAS-->
    <NDIASLICREM1>0.00</NDIASLICREM1>
    <NDIASLICREM2>0.00</NDIASLICREM2>
    <SITUACAORAIS>1</SITUACAORAIS>
    <CONTAPAGAMENTO>010470909</CONTAPAGAMENTO>
    <MEMBROSINDICAL>0</MEMBROSINDICAL>
    <VINCULORAIS>1</VINCULORAIS>
    <!--DIASUTEISMES>6</DIASUTEISMES-->
    <!--DIASUTMEIOEXP>0</DIASUTMEIOEXP-->
    <!--DIASUTPROXMES>22</DIASUTPROXMES-->
    <MUDOUENDERECO>0</MUDOUENDERECO>
    <MUDOUCARTTRAB>0</MUDOUCARTTRAB>
    <ANTIGACARTTRAB>0070737</ANTIGACARTTRAB>
    <ANTIGASERIECART>0002</ANTIGASERIECART>
    <MUDOUNOME>0</MUDOUNOME>
    <MUDOUPIS>0</MUDOUPIS>
    <ANTIGOPIS>20049542924</ANTIGOPIS>
    <MUDOUCHAPA>0</MUDOUCHAPA>
    <!--ANTIGACHAPA>400008</ANTIGACHAPA-->
    <!--MUDOUADMISSAO>0</MUDOUADMISSAO-->
    <MUDOUDTOPCAO>0</MUDOUDTOPCAO>
    <MUDOUSECAO>0</MUDOUSECAO>
    <!--ANTIGASECAO>01.02.05.1.10.00</ANTIGASECAO-->
    <MUDOUDTNASCIM>0</MUDOUDTNASCIM>
    <PISPARAFGTS>12005355312</PISPARAFGTS>
    <!--ULTIMORECALCULODATA>2022-03-24T00:00:00</ULTIMORECALCULODATA-->
    <!--ULTIMORECALCULOHORA>2022-03-24T14:45:35</ULTIMORECALCULOHORA-->
    <DESCONTAAVISOPREVIO>0</DESCONTAAVISOPREVIO>
    <CODFILIAL>2</CODFILIAL>
    <NOME>TION GE NG</NOME>
    <INDINICIOHOR>1</INDINICIOHOR>
    <PISPASEP>12005955312</PISPASEP>
    <CODPESSOA>524</CODPESSOA>
    <CODBANCOFGTS>104</CODBANCOFGTS>
    <CODBANCOPAGTO>033</CODBANCOPAGTO>
    <CODAGENCIAPAGTO>0040</CODAGENCIAPAGTO>
    <HSTBANCO_DTMUDANCA>2022-05-25T00:00:00</HSTBANCO_DTMUDANCA>
    <CODBANCOPIS>104</CODBANCOPIS>
    <RESCISAOCALCULADA>0</RESCISAOCALCULADA>
    <MEMBROCIPA>0</MEMBROCIPA>
    <USASALCOMPOSTO>0</USASALCOMPOSTO>
    <REGATUAL>1</REGATUAL>
    <JORNADAMENSAL>13200</JORNADAMENSAL>
    <CODOCORRENCIA>0</CODOCORRENCIA>
    <CODCATEGORIA>1</CODCATEGORIA>
    <ESUPERVISOR>0</ESUPERVISOR>
    <USACONTROLEDESALDO>0</USACONTROLEDESALDO>
    <MUDOUCI>0</MUDOUCI>
    <PERIODORESCISAO>0</PERIODORESCISAO>
    <CODGRPQUIOSQUE>Chefes</CODGRPQUIOSQUE>
    <FGTSMESANTRECOLGRFP>0</FGTSMESANTRECOLGRFP>
    <TRABALHOUNADEMISSAO>0</TRABALHOUNADEMISSAO>
    <NRODIASFERIASJORNRED>0</NRODIASFERIASJORNRED>
    <POSSUIALVARAMENOR16>0</POSSUIALVARAMENOR16>
    <SITUACAOINSS>1</SITUACAOINSS>
    <DTAPOSENTADORIA>2015-12-31T00:00:00</DTAPOSENTADORIA>
    <CODTABELASALARIAL>001</CODTABELASALARIAL>
    <TEMDEDUCAOCPMF>1</TEMDEDUCAOCPMF>
    <NRODIASFERIASCORRIDOS>0</NRODIASFERIASCORRIDOS>
    <NRODIASABONOCORRIDOS>0</NRODIASABONOCORRIDOS>
    <POSICAOABONO>1</POSICAOABONO>
    <QUERADIANTAMENTO>0</QUERADIANTAMENTO>
    <CODCOLFORNEC>0</CODCOLFORNEC>
    <SEXO>M</SEXO>
    <NACIONALIDADE>10</NACIONALIDADE>
    <GRAUINSTRUCAO>9</GRAUINSTRUCAO>
    <NATURALIDADE>ITA</NATURALIDADE>
    <APELIDO>TION</APELIDO>
    <EMAIL>[email protected]</EMAIL>
    <DTNASCIMENTO>1955-01-13T00:00:00</DTNASCIMENTO>
    <CARTIDENTIDADE>941646</CARTIDENTIDADE>
    <ORGEMISSORIDENT>SSP</ORGEMISSORIDENT>
    <DTEMISSAOIDENT>1979-01-11T00:00:00</DTEMISSAOIDENT>
    <UFCARTIDENT>SP</UFCARTIDENT>
    <CARTEIRATRAB>0070737</CARTEIRATRAB>
    <SERIECARTTRAB>00002</SERIECARTTRAB>
    <UFCARTTRAB>SP</UFCARTTRAB>
    <NIT>0</NIT>
    <TITULOELEITOR>109097</TITULOELEITOR>
    <SECAOTITELEITOR>239</SECAOTITELEITOR>
    <ZONATITELEITOR>1</ZONATITELEITOR>
    <CERTIFRESERV>35493</CERTIFRESERV>
    <CPF>91129800820</CPF>
    <RUA>VIGÁRIO JOAO JOSE RODRIGUE</RUA>
    <NUMERO>624</NUMERO>
    <COMPLEMENTO>AP 92</COMPLEMENTO>
    <BAIRRO>CENTRO</BAIRRO>
    <CIDADE>Jundiaí</CIDADE>
    <ESTADO>SP</ESTADO>
    <PAIS>BRASIL</PAIS>
    <CEP>13201001</CEP>
    <TELEFONE2>11998163952</TELEFONE2>
    <NOMEBANCOPGTO>Banco Santander Banespa</NOMEBANCOPGTO>
    <NOMEAGENCIAPGTO>JUNDIAI</NOMEAGENCIAPGTO>
    <NOMEPAI>NG THEI SING</NOMEPAI>
    <NOMEMAE>CHAN KON KENG</NOMEMAE>
    <CODIGO>524</CODIGO>
    <Jornada_Mensal>220,00</Jornada_Mensal>
    <Hora>80.75</Hora>
    <PAISORIGEM>China</PAISORIGEM>
    <TIPOAPOSENTADORIA>1</TIPOAPOSENTADORIA>
    <DEFICIENTEFISICO>0</DEFICIENTEFISICO>
    <DEFICIENTEAUDITIVO>0</DEFICIENTEAUDITIVO>
    <DEFICIENTEFALA>0</DEFICIENTEFALA>
    <DEFICIENTEVISUAL>0</DEFICIENTEVISUAL>
    <DEFICIENTEMENTAL>0</DEFICIENTEMENTAL>
    <BRPDH>0</BRPDH>
    <HSTAFT_ESTTEMPOSERVICO>false</HSTAFT_ESTTEMPOSERVICO>
    <NOMEFUNC>TION GE NG</NOMEFUNC>
    <CORRACA>2</CORRACA>
    <!--CODUSUARIO>000008</CODUSUARIO-->
    <ESTADOCIVIL>C</ESTADOCIVIL>
    <ESTADONATAL>IT</ESTADONATAL>
    <CANDIDATO>1</CANDIDATO>
    <CODCOLIGADAORIGEM>1</CODCOLIGADAORIGEM>
    <!--CHAPAORIGEM>000008</CHAPAORIGEM-->
    <CODTIPOBAIRRO>1</CODTIPOBAIRRO>
    <CODTIPORUA>1</CODTIPORUA>
    <TPREGIMEPREV>1</TPREGIMEPREV>
    <INDADMISSAO>1</INDADMISSAO>
    <DEFICIENTEINTELECTUAL>0</DEFICIENTEINTELECTUAL>
    <CODMUNICIPIO>25904</CODMUNICIPIO>
    <SITUACAOIRRF>1</SITUACAOIRRF>
    <NROFILHOSBRASIL>0</NROFILHOSBRASIL>
    <CODIGORECEITA3533>0</CODIGORECEITA3533>
    <!--MATRICULAESOCIAL>C01S001655</MATRICULAESOCIAL-->
    <TIPOREGIMEJORNADA>3</TIPOREGIMEJORNADA>
    <IDADE>67</IDADE>
    <TEMPOPARCIAL>0</TEMPOPARCIAL>
    <CODCATEGORIAESOCIAL>101</CODCATEGORIAESOCIAL>
    <ESOCIALNATATIVIDADE>1</ESOCIALNATATIVIDADE>
    <REFERENCIA_MENSAL>000:00</REFERENCIA_MENSAL>
    <!--TIPOADESAOBEM>1</TIPOADESAOBEM-->
    <!--DTACORDOBEM>2020-04-13T00:00:00</DTACORDOBEM-->
    <!--PERCENTUALREDUCAOBEM>25.00</PERCENTUALREDUCAOBEM-->
    <!--DURACAOBEM>90</DURACAOBEM-->
    <!--VALORREDUZIDOBEM>4085.70</VALORREDUZIDOBEM-->
    <!--DIASPRORROGACAOBEM>150</DIASPRORROGACAOBEM-->
    <!--ENVIORESCISAOCONSIGNADO>1</ENVIORESCISAOCONSIGNADO-->
    <FUMANTE>0</FUMANTE>
    <DEFICIENTEMOBREDUZIDA>0</DEFICIENTEMOBREDUZIDA>
    <!--Periodo_Aquisitivo>De 04/04/2021 a 03/04/2022</Periodo_Aquisitivo!-->
    <!--Limite_Ferias_Dobro>04/03/2023 00:00:00</Limite_Ferias_Dobro!-->
    <!--DiasFaltasFeriasNormais>0</DiasFaltasFeriasNormais-->
    <DATACHEGADA>1958-01-12T00:00:00</DATACHEGADA>
    <CARTMODELO19>1</CARTMODELO19>
    <CONJUGEBRASIL>0</CONJUGEBRASIL>
    <NATURALIZADO>1</NATURALIZADO>
    <FILHOSBRASIL>0</FILHOSBRASIL>
    <INVESTTREINANT>0.00</INVESTTREINANT>
    <AJUSTATAMANHOFOTO>0</AJUSTATAMANHOFOTO>
    <DATAAPROVACAOCURR>1983-04-04T00:00:00</DATAAPROVACAOCURR>
    <ESTADOROW>0</ESTADOROW>
    <ROWVALIDA>0</ROWVALIDA>
    <ALUNO>0</ALUNO>
    <PROFESSOR>0</PROFESSOR>
    <USUARIOBIBLIOS>0</USUARIOBIBLIOS>
    <FUNCIONARIO>1</FUNCIONARIO>
    <EXFUNCIONARIO>0</EXFUNCIONARIO>
    <FALECIDO>0</FALECIDO>
    <TIPOPRAZORESIDENCIA>0</TIPOPRAZORESIDENCIA>
  </PFunc>

FopDepend

<PFDepend>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CHAPA>888888</CHAPA>
    <NRODEPEND>1</NRODEPEND>
    <NOME>JULIANE APARECIDA DA C NG</NOME>
    <CPF>35429953806</CPF>
    <DTNASCIMENTO>1988-02-02T00:00:00</DTNASCIMENTO>
    <SEXO>F</SEXO>
    <ESTADOCIVIL>S</ESTADOCIVIL>
    <INCIRRF>0</INCIRRF>
    <INCINSS>1</INCINSS>
    <INCASSISTMEDICA>0</INCASSISTMEDICA>
    <INCPENSAO>0</INCPENSAO>
    <GRAUPARENTESCO>1</GRAUPARENTESCO>
    <CARTAOVACINA>0</CARTAOVACINA>
    <PERCENTUAL>0.00</PERCENTUAL>
    <RESPONSAVEL>0</RESPONSAVEL>
    <BRUTO>0</BRUTO>
    <FREQESCOLAR>0</FREQESCOLAR>
    <UNIVERSITARIO>0</UNIVERSITARIO>
    <INCSALFAM>0</INCSALFAM>
    <OBSERVACAO>0</OBSERVACAO>
    <OPBANCARIA>000</OPBANCARIA>
  </PFDepend>
  <PFDEPENDCOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CHAPA>888888</CHAPA>
    <NRODEPEND>1</NRODEPEND>
    <!--RECCREATEDBY>M4267</RECCREATEDBY-->
    <!--RECCREATEDON>2016-02-12T08:51:15</RECCREATEDON-->
    <!--RECMODIFIEDBY>M4267</RECMODIFIEDBY-->
    <!--RECMODIFIEDON>2016-02-12T08:51:15</RECMODIFIEDON-->
    <AUXCRECHE>0</AUXCRECHE>
  </PFDEPENDCOMPL>
</FopDepend>]]>

Possíveis erros

Updated 7 months ago