Senior

📘

Informações importantes

• O processo admissional na Senior é facilitado quando o cliente configura os códigos e opções na Gupy (exemplos: código de departamentos, cargos, centros de custo, etc.), para gerar a menor necessidade de manutenção possível.

• O Fluxo de integração com a Gupy contempla apenas a inclusão da pessoa admitida, e não a alteração dos dados no sistema de folha. Ou seja, o campo tipOpe é sempre igual à "I".

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

A Senior utiliza autenticação básica através de *usuário e senha.

Conectividade

• Para integrar com a Senior é comum utilizar os webservices padrão. Caso seja customizado, as regras de integração dependem de quem montou o webservice. Porém, a troca de dados sempre é em formato XML;
• O fechamento de VPN com os webservices do ambiente de homologação é necessário;
• VPN não é necessária para ambiente de produção se não for utilizado webservice customizado.
• Se for utilizado webservice customizado, o dicionário de campos do webservice e as URLs de conexão devem ser disponibilizados.

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, definida no passo anterior deste guia: Fluxo de Admissão para Sistema de Folha;
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 de XML postagem no webservice da Ficha Básica e coleta numCad através da resposta do endpoint;
6. Montagem do XML e postagem no webservice da Ficha Complementar;
7. Montagem do XML e postagem no webservice da Ficha Dependentes;

Envio das informações

Para essa integração, serão utilizadas três fichas da Senior:

• Ficha básica
• Ficha complementar
• Ficha dependentes

Pontos de atenção

• Existem campos que podem se tornar obrigatórios dependendo da informação colocada em outros campos. Atente-se à documentação modelo planilizada para identificação desses campos.

Exemplo de dados da Ficha Básica

<parameters>
<numEmp>14</numEmp>
<numCad>0</numCad>
<datAdm>21/06/2022</datAdm>
<codEsc>3</codEsc>
<codTap>1</codTap>
<cateSo>101</cateSo>
<tipOpe>I</tipOpe>
<admeSo>1</admeSo>
<conRho>2</conRho>
<posTra>014.174.004</posTra>
<codMotHca>1</codMotHca>
<codTmaHes>1</codTmaHes>
<apuPonApu>1</apuPonApu>
<tipAdmHfi>2</tipAdmHfi>
<nomFun>Ana da Silva </nomFun>
<modPacks</modPack>
<motos>1</motos>
<apeFun>Ana da Silva</apeFun>
<codMotHsa>1</codMotHsa>
<codBan>85</codBan>
<socSinHsi>S</socSinHsi>
<possBHHsi>S</possBHHsi>
<tipSalHsa>1</tipSalHsa>
<numCpf>99999999999</numCpf>
<codAge>101</codAge>
<tipSex>F</tipSex>
<numPis>99999999</numPis>
<tpCtBa>1</tpCtBa>
<estCiv>1</estCiv>
<conBan>886487</conBan>
<graIns>10</graIns>
<tipOpc>S</tipOpc>
<digBan>0</digBan>
<datNas>15/09/1997</datNas>
<valSalHsa>1480.37</valSalHsa>
<perPag>M</perPag>
<codNac>10</codNac>
<recAdi>S</recAdi>
<rec13S>S</rec13S>
<lisRai>S</lisRai>
<benRea>N</benRea>
<racCor>1</racCor>
<catSef>1</catSef>
<numCtp>1040182</numCtp>
<serCtp>9928</serCtp>
<estCtp>SC</estCtp>
<dexCtp>16/01/2013</dexCtp>
<dcdPis>16/01/2013</dcdPis>
</parameters>

Exemplo de dados da Ficha Complementar

<parameters>
<numEmp>11</numEmp>
<tipOpe>I</tipOpe>
<tipCol>1</tipCol>
<numCad>42955</numCad>
<tipLgr>R</tipLgr>
<endRua>Rua das nuvens</endRua>
<endNum>201</endNum>
<endCpl>casa</endCpl>
<codPai>1</codPai>
<codEst>SC</codEst>
<codCid>42059082</codCid>
<codBai>Margem Esquerda</codBai>
<endCep>02394084</endCep>
<ddiTel>55</ddiTel>
<emaPar>[email protected]</emaPar>
<paiNas>1</paiNas>
<estNas>RS</estNas>
<cciNas>4317509</cciNas>
<numCid>8037593327</numCid>
<emiCid>ssp/rs</emiCid>
<estCid>RS</estCid>
<dexCid>13/01/1998</dexCid>
<numEle>0940103940128</numEle>
<zonEle>064</zonEle>
<secEle>0170</secEle>
<numRes>990348012</numRes>
<catRes>26461</catRes>
<claAss>N</claAss>
<ultExm>04/07/2022</ultExm>
<proExm>04/07/2024</proExm>
</parameters>

Exemplo de dados da Ficha Dependentes

<parameters>
<tipOpe>I</tipOpe>
<tipCol>1</tipCol>
<numEmp>11</numEmp>
<numCad>42947</numCad>
<codDep>4</codDep>
<nomDep>Ana da Silva</nomDep>
<nomCom>Ana da Silva</nomCom>
<graPar>1</graPar>
<tipDep>3</tipDep>
<tipSex>M</tipSex>
<datNas>15/09/2018</datNas>
<numCpf>99999999999</numCpf>
<nomMae>Maria da Silva </nomMae>
<nomPai>José da Silva </nomPai>
<penJud>N</penJud>
<aviImp>S</aviImp>
<auxCre>S</auxCre>
<nomCre>83</nomCre>
<depRPP>N</depRPP>
<limIrf>21</limIrf>
</parameters>

Possíveis erros

Ficha Complementar e Ficha Dependentes não integram

É necessário integrar a Ficha Básica antes de integrar as demais.

Dados faltantes

Se houver sucesso no envio da Ficha Básica, mas não na Ficha Complementar, a pessoa admitida será cadastrada com dados faltantes.

Dependência de campos

Existem muitas relações e dependências entre campos na Senior, fazendo com que alguns campos tornem-se obrigatórios dependendo do dado que for colocado nele. Importante mapear todos esses casos, pois retornará um erro se os campos não forem preenchidos corretamente.

Matrícula não é gerada automaticamente

Caso não seja gerado automaticamente, o campo numCad (matrícula), precisa ser enviado na Ficha Básica de forma manual com um campo na Gupy que tenha essa informação ou com alguma outra regra fixa de escolha do cliente.