Guias Práticos

ADP

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

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

Suggest Edits

📘

Expert Connection

É necessário que o cliente tenha ativado e configurado o módulo do Expert Connection da ADP.

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

  • O sistema de folha da ADP trabalha com troca de arquivos via SFTP, AS2 ou Connect Direct
  • A comunicação se dá através de chave SSH.

Conectividade

  • Para realizar as admissões o cliente precisa ter um servidor SFTP para receber os arquivos de admissão gerados e posteriormente encaminhá-los para a ADP. Este servidor não é fornecido pela Gupy, sendo de responsabilidade do cliente configurar um servidor ou contratar um barramento para realizar a transmissão dos dados.
  • O processo admissional é facilitado quando o cliente já possui o fluxo de integração de criação de vagas, já que o arquivo gerado pelo WebReport contém informações que seguirão até o processo admissional.

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 ADP espera receber um arquivo XML como o modelo abaixo.

Seguem algumas orientações sobre as tags do XML:

  • Não precisam seguir nenhuma ordem específica no XML, visto que o modelo pode variar de acordo com a obrigatoriedade e regras das tags;
  • Tags vazias podem ser enviadas de duas formas distintas: Ex.: "" ou "";
  • A Tag empres deve ser enviada apenas com números e deve conter 14 dígitos.
  • A obrigatoriedade dos campos depende do tipo de tarefa enviada na admissão, que é variável de acordo com o tipo de contratação.
  • Na tag muend é passado o código de uma cidade em vez do nome dela. Esse código segue uma tabela da ADP, previamente cadastrada no ambiente do cliente.
  • As tags client e usupbo contém informações necessárias para conectividade com a ADP, que variam de acordo com o ambiente (Homologação e Produção). Ao realizar uma virada para produção precisamos alterar essas informações.
  • Todo campo de data deve ser preenchido da seguinte forma: DD/MM/AAAA
  • O número máximo de dependentes aceito é 10.
<?xml version="1.0" encoding="ISO-8859-1"?>
<root>
	<record>
		<client>9999</client>
		<empres>99999999999999</empres>
		<indcnp>1</indcnp>
		<acao>Gravar</acao>
		<tarefa>AD_CLT</tarefa>
		<datenv>07/10/2011</datenv>
		<horenv>09:12</horenv>
		<usuenv />
		<usubpo>9999-WEBSERVICE</usubpo>
		<reqmsg />
		<indide>2</indide>
		<datpro />
		<horpro />
		<nreqid>111007004</nreqid>
		<nreqpd />
		<idglob />
		<matric />
		<nomepf>DANIELA BONINI</nomepf>
		<sexopf>Feminino</sexopf>
		<dtnasc>06/10/1975</dtnasc>
		<estciv>CAS</estciv>
		<grinst>10</grinst>
		<munasc>3550308</munasc>
		<nacion>Brasileira</nacion>
		<emailp>[email protected]</emailp>
		<nrocpf>89981699858</nrocpf>
		<nropis>12991745361</nropis>
		<ctpsnr>22282</ctpsnr>
		<ctpssr>999</ctpssr>
		<ctpsuf>SP</ctpsuf>
		<nomend>Rua irajá</nomend>
		<nroend>45</nroend>
		<cplend></cplend>
		<nombai>Neighborhood</nombai>
		<nrocep>05763470</nrocep>
		<munend>3550308</munend>
		<datadm>13/10/2011</datadm>
		<regmtb />
		<nrodex>45</nrodex>
		<nrodre>45</nrodre>
		<vinsig>CLT</vinsig>
		<matsup />
		<empsup />
		<indche>Sim</indche>
		<inddir>Não</inddir>
		<codfun>154</codfun>
		<coduno>00000</coduno>
		<nroesc>4</nroesc>
		<nrotur>11</nrotur>
		<cracha>013155533</cracha>
		<horact />
		<ocsefi>00</ocsefi>
		<tppagt>Banco</tppagt>
		<codban>399</codban>
		<codagb>1652</codagb>
		<dgvagb />
		<codctb>875</codctb>
		<dgvctb>0</dgvctb>
		<tipsal>M</tipsal>
		<nrohct>220</nrohct>
		<salctr>6056,00</salctr>
		<numtar />
		<valtar />
		<incttr>Indeterminado</incttr>
		<incpmf>0</incpmf>
		<apelid />
		<inrsel>Não</inrsel>
		<intrbr>Sim</intrbr>
		<dtcheg />
		<dtsaid />
		<indnat>Não</indnat>
		<tpvist />
		<incnir>Sim</incnir>
		<docide>17811619-6</docide>
		<docido>SSP</docido>
		<docidu>SP</docidu>
		<datide>27/03/2008</datide>
		<doides />
		<dtides />
		<clvist />
		<dtctrb />
		<datpis />
		<titele>266287712141</titele>
		<titzon>002</titzon>
		<titsec>0289</titsec>
		<cerres />
		<crthab />
		<cathab />
		<nompai>JOSÉ ANTONIO</nompai>
		<nommae>MARIA BENEDITA</nommae>
		<priemp>Não</priemp>
		<pficor>1</pficor>
		<telaux>(11) 84698060 (cel.)</telaux>
		<indaps>Não</indaps>
		<dataps />
		<munvot>3550308</munvot>
		<inddfi>Não</inddfi>
		<nomcon>DANIELA</nomcon>
		<turdis>I</turdis>
		<tipaps>0</tipaps>
		<telefp>37914215</telefp>
		<dddtel>011</dddtel>
		<faxpfi />
		<dddfax />
		<nacpai>Brasileira</nacpai>
		<nacmae>Brasileira</nacmae>
		<vlctps />
		<vldrne />
		<nronit />
		<indafc />
		<indcir />
		<indale />
		<exmper />
		<indfil>Não</indfil>
		<indest>Não</indest>
		<pretsl />
		<nranos />
		<nrmess />
		<nrdias />
		<foncod />
		<nomesc />
		<durces />
		<unices />
		<endesc />
		<munesc />
		<cgcesc />
		<nomcur />
		<seriep />
		<nocomp />
		<noresp />
		<cpfres />
		<didres />
		<durcme />
		<unicme />
		<noesme />
		<cgceme />
		<nomcme />
		<iacpfi />
		<iadpfi />
		<datats />
		<dtfgts />
		<ipasta />
		<indpag>37</indpag>
		<bandoc />
		<despre>Sim</despre>
		<adiant>Sim</adiant>
		<indhol>Não</indhol>
		<sosind>Não</sosind>
		<cosind>Sim</cosind>
		<desind>Sim</desind>
		<soasso>Não</soasso>
		<efetiv>NEFET</efetiv>
		<excpto>Não</excpto>
		<iacreg>infadic02|infadic10|infadic15|infadic16|infadic17|infadic19</iacreg>	<iadreg>013155533|13|321|DANIELA|[email protected]|00033</iadreg>
		<nrodep>1</nrodep>
		<dnom01>EDNEI LUIS</dnom01>
		<dgrp01>1</dgrp01>
		<ddna01>23/05/1976</ddna01>
		<dsex01>Masculino</dsex01>
		<dciv01>CAS</dciv01>
		<dmna01></dmna01>
		<dalt01></dalt01>
		<dcor01>0</dcor01>
		<dsan01></dsan01>
		<ddoa01>Não</ddoa01>
		<ddud01></ddud01>
		<dpes01>Não</dpes01>
		<dfam01>Não</dfam01>
		<dcir01>Não</dcir01>
		<dale01>Não</dale01>
		<dcar01></dcar01>
		<dnre01></dnre01>
		<ddce01></ddce01>
		<dirr01>Não</dirr01>
		<dinv01>Não</dinv01>
		<dcre01>Não</dcre01>
		<desc01>Não</desc01>
		<duni01>Não</duni01>
		<ddva01></ddva01>
		<ddfr01></ddfr01>
		<didg01></didg01>
		<iacd01></iacd01>
		<iadd01></iadd01>
		<dmae01></dmae01>
		<dtdf01></dtdf01>
		<dtvg01></dtvg01>
		<dtma01></dtma01>
		<catpro />
		<sindic />
	</record>
</root>

Possíveis erros

Arquivo rejeitado:

Um arquivo pode ser rejeitado por falta no envio de campos obrigatórios em primeira instância ou campos enviados com formatação incorreta. Nesse caso, ao corrigir o cenário de erro e reenviar o candidato para a etapa de admissão na Gupy poderá gerar sucesso na criação da REQ e o arquivo ser aceito. Portanto é importante verificar se a documentação do candidato está completa antes de movê-lo para etapa de integração.

Destaque para o tráfego das informações bancárias dos colaboradores, pois caso esse documento seja solicitado para envio de documentação é necessário cadastrar primeiro a agência na ADP antes de mover o candidato para a etapa de integração. Isso porque existe uma validação do lado da ADP se a agência existe ou não na base de dados.

Informações faltantes:

Um arquivo pode ser aceito e gerar um número de REQ com sucesso na ADP, mas ainda assim apresentar alguma “falha” do ponto de vista operacional (campos faltantes ou com informações errôneas). O que significa que esse erro não é impeditivo para gerar a REQ no sistema, mas requer que algumas informações sejam inseridas/corrigidas manualmente na ADP pelo time de departamento pessoal da empresa.

Quando uma REQ é gerada na ADP, não é possível enviar uma admissão com o mesmo “nreqid”, portanto as correções devem ser feitas diretamente na ADP e não adiantará reprocessar a admissão na Gupy.

Updated 7 months ago