...
A integração com Totvs RH Atração de Talentos e com o módulo SIGAGPE possui o objetivo de realizar a captura recepção dos dados do Candidatos cuja contratação foi aprovada e disponibilizar esses dados para que sua admissão seja efetuada no módulo de Gestão de Pessoal na rotina de Cadastro de Funcionários.
...
Para que essa integração seja possível são necessários os seguintes passos:
| Totvs custom tabs box |
|---|
| tabs | Passo 01, Passo 02, Passo 03,Passo 04,Pontos de Atenção |
|---|
| ids | passo1,passo2,passo3,passo4,passo5 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Após a criação da tabela é primordial realizar a seguinte configuração através do módulo SIGACFG | Aviso |
|---|
Essa configuração é de suma importância para correta carga dos dados! |
Acessar o módulo SIGACFG - Configurador no item Base de Dados > Dicionário > Base de Dados e no ícone de busca, procurar pela tabela RUH:  Image Removed
Em seguida selecione o ícone de Editar:  Image Removed
Para o NOME da tabela ele deverá ser composto por RUH + Sufixo Grupo de Empresas por exemplo, Grupo de Empresas T1 , o sufixo formado para as tabelas é com T10, logo a tabela RUH terá seu nome RUHT10.  Image Removed
warning | Deverá ser escolhido o sufixo do Grupo de Empresa que possuir o maior número de dígitos do grupo 121 - Matrícula Funcionário O nome da tabela RUH deverá ser alterado em absolutamente em TODOS os grupos de empresa. Por exemplo: | Grupo de Empresa | Sufixo | Grupo 121 Matrícula (tamanho máximo) | Nome tabela RUH |
|---|
| T1 | T10 | 6 | RUHT30 | | T2 | T20 | 8 | RUHT30 | | T3 | T30 | 15 | RUHT30 | | Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
| A Integração com o Totvs RH Atração de Talentos é implementada através de Behaviour Sharing que consiste em realizar a execução do job responsável popela pela operação de descida de dados de forma apartada e resiliente.
No caso do Protheus, essa operação é realizada através do FWTOTVSLINKJOB que depois de algumas validações realiza a execução da função responsável para a operação desejada. Uma dessas validações é em relação a existência de credenciais , se elas forem válidas, uma consulta na fila do Smartlink é executada.
Nesta fila estará o nosso processo com o nome de RHATSSendApplicantApprovedToErp responsável por realizar a leitura recepção dos dados de candidatos em suas respectivas vagas vindos da integração com o produto do Totvs RH Atração de Talentos. Tendo isso em vista o primeiro segundo passo será cadastrar as credenciais através da rotina de Comunicação SmartLink - Parâmetros de Conexão As credenciais são as Chaves de integração (Client ID e e Client Secret) fornecidas pela Totvs. |
|
...
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
| Para onde os dados serão levados para dentro do Protheus? O usuário possuirá 2 alternativas para essa etapa do processo listadas a seguir:
| Aviso |
|---|
Essa configuração é ESSENCIAL para correta recepção e gravação dos dados! |
| Deck of Cards |
|---|
| | Card |
|---|
| id | id1 |
|---|
| label | Unidade da Central do Recrutador |
|---|
| O campo CNPJ vinculado à Unidade no portal do Central do Recrutador atualmente é um campo opcional porém de forma a vincular os dados recebidos daquela Unidade com os dados do Protheus, o usuário deverá cadastrar o campo CNPJ com um código de CNPJ vinculado à uma Grupo de Empresa/Filial do Protheus.  Image Added
Para isso, verifique o conteúdo do campo CNPJ no cadastro de Filial do Módulo Configurador em Ambiente > Empresas > Filial. Dessa maneira, durante a recepção dos dados, será localizado o Grupo de Empresa/Filial correspondente àquele CNPJ e os dados serão gravados de acordo com essa configuração na tabela RUH - ATS Candidatos. Por exemplo: | Unidade | CNPJ | Grupo de Empresas (Protheus) | Filial (Protheus) |
|---|
| São Paulo | 04.827.707/0002-08 | T1 | M SP 01 | | Campinas | 04.827.707/0001-27 | T1 | M SP 02 | | Belo Horizonte | 57.542.443/0001-21 | 01 | 90 | | Uberaba | 57.542.443/0002-02 | 01 | 91 |
| Aviso |
|---|
Essa configuração implica somente na gravação dos dados da tabela RUH - ATS Candidatos, na etapa de Admissão ainda será possível escolher a FILIAL para qual o funcionário deverá ser admitido! |
|
| Card |
|---|
| id | id2 |
|---|
| label | Arquivo config.json |
|---|
| title | Arquivo config.json |
|---|
| Caso o usuário opte por não realizar a alteração no cadastro de cada Unidade na Central do Recrutador, ele deverá possuir o arquivo config.json configurado. Esse arquivo visa a garantir um destino default para recepção dos dados do Totvs RH Atração de Talentos ao Protheus.
Para isso, ele deverá acessar a opção Admissão Candidatos ATS disponível em SIGAGPE(07) / Atualizações > Funcionários > Funcionários > Outras Ações. A opção Admissão Candidatos ATS será exibida no Cadastro de Funcionário somente se o parâmetro MV_RHATS estiver configurado igual a .T. | Parâmetro | Descrição | Conteúdo Padrão |
|---|
| MV_RHATS | Habilita Admissão do Candidato ATS no Cadastro de Funcionários | .F. |
No primeiro acesso ou na ocorrência do arquivo ter sido excluído acidentalmente, a rotina sempre validará a existência do arquivo config.json :  Image Added
O usuário deverá selecionar 'Sim' e preencher as informações conforme descritivo:  Image Added
Após o preenchimento das informações o arquivo config.json será gravado dentro da pasta do Startpath sob o novo folder ats no seguinte formato:  Image Added
Onde T1 representa o Grupo de Empresas e D MG 01 a Filial (exemplo):  Image Added
Caso o usuário selecione 'Não' na pergunta inicial, será exibida a tela de Candidatos ATS normalmente e ainda será possível configurar o arquivo através da opção Configuração ATS-Protheus em Outras Ações:  Image Added
| Aviso |
|---|
Caso o usuário não configurar um CNPJ através do cadastro de Unidade da Central do Recrutador , ou não configurar o arquivo config.json ou até mesmo excluí-lo acidentalmente, o registro será movido para a Fila de Erros (DLQ) do Smartlink - verificar item Pontos de Atenção. |
|
|
|
| Totvs custom tabs box-items |
|---|
| default | no |
|---|
| referencia | passo4 |
|---|
| Após todos estes passos a integração com o Totvs RH Atração de Talentos estará configurada no ERP Protheus para recepção das mensagens. |
| totvs-custom-tabs-box-items |
|---|
| default | no |
|---|
| referencia | passo5 |
|---|
| Durante a leitura/processamento da mensagem serão realizadas as validações a seguir, cujas mensagens serão exibidas no log do console do AppServer e na Fila de Erros (DLQ) do Monitor do Smartlink:
- Quando o arquivo config.json não existe no diretório ats:
 Image Added
Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:
 Image Added
Quando o arquivo config.json existe porém não contém estrutura válida:
 Image Added
Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:
 Image Added
| Aviso |
|---|
Estrutura válida do arquivo config.json (exemplo) onde T1 representa o Grupo de Empresas e D MG 01 a Filial: {
"companyId":"T1",
"branchId":"D MG 01 "
} |
- Quando o arquivo config.json existe porém não contém conteúdo de Grupo de Empresa/Filial existente no cadastro de Filiais:
 Image Added
Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:
 Image Added
| Aviso |
|---|
Os dados de Grupo de Empresa e Filial contidos no arquivo config.json deverão existir no Cadastro de Filiais do Módulo Configurador em Ambiente > Empresas > Filial.. |
- Quando a tabela RUH não existe no Dicionário de Dados:
 Image Added
Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:
 Image Added
|
|
03. Admissão
Para a admissão dos Candidatos recebidos pelo Totvs RH Atração de Talentos será necessário acessar o cadastro SIGAGPE(07) / Atualizações > Funcionários > Funcionários > Outras Ações > Admissão Candidatos ATS
| Totvs custom tabs box |
|---|
| tabs | Tela Inicial,Ações |
|---|
| ids | adm1,adm2 | Passo 01, Passo 02, Passo 03, Passo 04 | ids | passo1,passo2 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 | adm1 |
|---|
| Na tela de Candidatos ATS os dados serão exibidos conforme as legendas:  Image Added
- Livre Para Admissão
Registro lido da integração com Totvs RH Atração de Talentos e apto para admissão,
- Admitido
Registro lido através da integraão com Totvs RH Atração de Talentos e já admitido como funcionário no Protheus,
- Desprezado
Registro lido através da integração com Totvs RH Atração de Talentos e desprezado para admissão como funcionário no Protheus - uma vez que o registro é desprezado ele não retornará ao status de Livre para Admissão.
Nesta tela ainda é possível a aplicação de filtros sobre algumas informações prévias recebidas pelo Protheus como: - Nome do Candidato
- Data de Nascimento
- Email do Candidato
- Título da Vaga
 Image Added
|
| Totvs custom tabs box items |
|---|
| Na tela de Candidatos ATS é possível realizar as ações listadas a seguir: | Deck of Cards |
|---|
| | Card |
|---|
| id | op1 |
|---|
| label | Configuração ATS-Protheus |
|---|
| Através da opção Configuração ATS-Protheus é possível configurar o arquivo config.json conforme citamos nos itens anteriores. O usuário deverá selecionar a consulta para escolher o Grupo de Empresas e a Filial ou ainda informar os dados nos campos. A mensagem abaixo é exibida nas seguintes ocasiões ao selecionar OK: - Não é informado o Grupo de Empresa,
- Não é informado a Filial,
- Não é informado Grupo de Empresa e Filial,
- Informado Grupo de Empresa inválido/inexistente,
- Informado Filial inválida/inexistente
- Informado Grupo de Empresa e Filial inválidos/inexistentes,
 Image Added
Após informar um conteúdo válido, a configuração é gravada com sucesso e o arquivo config.json é gravado dentro da pasta do Startpath sob o novo folder ats:  Image Added
 Image Added
|
| Card |
|---|
| Na ação de Admitir é exibida tela para seleção da Filial onde o registro será admitido:  Image Added
A tela a seguir a ser exibida é a do próprio Cadastro de Funcionários com os campos carregados conforme enviados pelo Totvs RH Atração de Talentos, verificar o item Compatibilidade de Campos para conferí-los. Ao término do processo de Admissão, será gravado um registro na tabela SRA - Funcionários e o Status do registro de Candidatos ATS será atualizado para 'Admitido':  Image Added
|
| Card |
|---|
| Na ação de Desprezar é possível alterar o status do registro para 'Desprezado' de forma que ele não fique liberado para o processo de admissão. Ao Desprezar a legenda será alterada de acordo e caso o usuário tente desprezar novamente o mesmo registro é exibida mensagem:  Image Added
|
| Card |
|---|
| Na ação de Visualizar é possível verificar os dados recebidos pela integração.  Image Added
|
| Card |
|---|
| id | op5 |
|---|
| label | Compabilidade Campos |
|---|
| Os campos que serão carregados automaticamente no cadastro de Funcionários durante a admissão que foram recebidos pela integração com o Totvs RH Atração de Talentos são:
Campo Protheus | Propriedade JSON | Observações | RA_NOME | content.FullName | Nome completo | RA_NOMECMP | content.FullName | Nome completo | RA_NSOCIAL | content.SocialName | Nome social | RA_CIC | content.Applicant.Cpf | Cpf | RA_EMAIL | content.Applicant.Email | Email | RA_NASC | content.Applicant.Birthday | Data de Nascimento | RA_TELEFON | content.Applicant.TelephoneNumber | Telefone | RA_SEXO | content.Applicant.Gender | 0=Feminino, 1=Masculino | RA_CEP | content.Applicant.Address.ZipCode | CEP | RA_MUNICIP | content.Applicant.Address.CityName | Nome do Município | RA_ESTADO | content.Applicant.Address.StateSmallName | UF | RA_CODMUN | content.Applicant.Address.CityName + StateSmallName | Código Município IBGE | RA_LOGRTP | content.Applicant.Address.Street | Tipo de logradouro | RA_LOGRDSC | content.Applicant.Address.Street | Descrição do logradouro | RA_LOGRNUM | content.Applicant.Address.Street | Número do logradouro | RA_COMPLEM | content.Applicant.Address.Complement | Complemento | RA_BAIRRO | content.Applicant.Address.NeighborhoodName | Bairro | RA_DEFIFIS | content.Applicant.Diversity.Physical | Deficiência física: 1=Sim, 2=Não | RA_DEPTO | content.JobOpportunity.Departaments[1].IntegrationId | Existência validada na SQB (Departamentos) | RA_CARGO | content.JobOpportunity.Positions[1].IntegrationId | Existência validada na SQ3 (Cargos) | RA_PORTDEF | content.Applicant.Diversity.* | Ver listagem no |
|
|
| referencia | passo2
Mapeamento de Deficiências (RA_PORTDEF): | Propriedade JSON | Posição campo Protheus | Diversity.Physical | 1-Portador de Deficiência Física | Diversity.Auditory | 2-Portador de Deficiência Auditiva | Diversity.Visual | 3-Portador de Deficiência Visual |
|
|
|
|---|
|
04. Documentações Relacionadas
DT Integração ATS Admissão Candidato Dicionário de Dados
DT Integração ATS Admissão Candidato Recepção Mensagem
DT Integração ATS Admissão Candidato Dicionário de DadosCadastro de Funcionários
TOTVS RH Atração de Talentos
