CONTEÚDO
- Visão Geral
- Configurações para Recepção
- Admissão
- 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 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.
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 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 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 a seguir:
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 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 |
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!
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 :
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:
- Quando o arquivo config.json não existe no diretório ats:
Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila: 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 "
}- Quando o arquivo config.json existe porém não contém conteúdo de Grupo de Empresa/Filial existente no cadastro de Filiais:
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 Filiais do Módulo Configurador em Ambiente > Empresas > Filial..
- 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 > Funcionários > 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:
- 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,
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:
Na ação de Admitir é exibida tela para seleção da Filial onde o registro será admitido:
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':
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 |
|
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 próximo bloco. |
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 Cadastro de Funcionários
TOTVS RH Atração de Talentos





















