CONTEÚDO

  1. Visão Geral
  2. Configurações para Recepção
  3. Admissão
  4. Documentações Relacionadas

01. VISÃO GERAL

A integração com Totvs RH Atração de Talentos com o módulo SIGAGPE possui o objetivo de realizar a captura 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.  

02. Configurações para Recepção

Para que essa integração seja possível são necessários os seguintes passos:


Atualização do dicionário de dados para criação da tabela RUH - Integração ATS Candidato.

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 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 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 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 Client Secret) fornecidas pela Totvs.

Para onde os dados serão levados para dentro do Protheus?

O usuário possuirá 2 alternativas para essa etapa do processo listadas abaixo:


Essa configuração é ESSENCIAL para correta recepção e gravação dos dados!



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.

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 essasconfiguração na tabela RUH - ATS Candidatos.

Por exemplo:

UnidadeCNPJGrupo de Empresas (Protheus)Filial (Protheus)
São Paulo

04.827.707/0002-08

T1M SP 01
Campinas04.827.707/0001-27T1M SP 02
Belo Horizonte57.542.443/0001-210190
Uberaba57.542.443/0002-02 0191



Essa configuração implica somente a 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!

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âmetroDescriçãoConteúdo Padrão
MV_RHATSHabilita 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 identificará que o arquivo config.json não existe:


O usuário deverá selecionar 'Sim' e preencher as informações conforme descritivo:


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:

Onde T1 representa o Grupo de Empresas e D MG 01 a Filial (exemplo):


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:


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.



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.

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:

  1. Quando o arquivo config.json não existe no diretório system\ats:

    Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:



  2. Quando o arquivo config.json existe porém não contém estrutura válida:

    Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:


    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 "
    }



  3. Quando o arquivo config.json existe porém não contém conteúdo de Grupo de Empresa/Filial existente no cadastro de Empresas:

    Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:


    Os dados de Grupo de Empresa e Filial contidos no arquivo config.json deverão existir no Cadastro de Empresas (SIGACFG).




  4. Quando a tabela RUH não existe no Dicionário de Dados:

    Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:


    Necessário a criação da tabela  RUH - Integração ATS Candidato via expedição contínua.


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 > Funcionações > Outras Ações > Admissão Candidatos ATS 


Na tela de Candidatos ATS os dados serão exibidos conforme as legendas:

  • 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

Na tela de Candidatos ATS é possível realizar as ações listadas a seguir:

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:

  1. Não é informado o Grupo de Empresa,
  2. Não é informado a Filial,
  3. Não é informado Grupo de Empresa e Filial,
  4.  Informado Grupo de Empresa inválido/inexistente,
  5. Informado Filial inválida/inexistente
  6. Informado Grupo de Empresa e Filial inválidos/inexistentes,



Após informar um conteúdo válido, a configuração é gravada com sucesso e o arquivo config.json é  sgravado dentro da pasta do Startpath sob o novo folder ats:

Na ação de Admitir é exibida tela para selação da Filial onde o registro será admitido:


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:

Na ação de Visualizar é possível verificar os dados recebidos pela integração.

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

RA_CARGO

content.JobOpportunity.Positions[1].IntegrationId

Existência validada na SQ3

RA_ADMISSA

content.hiringDate

(campo não presente no JSON exemplo)

RA_PORTDEF

content.Applicant.Diversity.*

Mapeamento a seguir:



Mapeamento de Deficiências (RA_PORTDEF):

Posição campo Protheus

Propriedade JSON

* (não possui esse tipo de deficiência)

Posição 1

Diversity.Physical

1 ou *

Posição 2

Diversity.Auditory

2 ou *

Posição 3

Diversity.Visual

3 ou *

Posição 4

(Não mapeado - Mental)

*

Posição 5

Diversity.Intellectual

5 ou *

Posição 6

(Não mapeado - Reabilitado)

*


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 Cadastro de Funcionários
TOTVS RH Atração de Talentos