...
A integração com Totvs RH Atração de Talentos com o módulo 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.
...
| 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 |
|---|
| 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 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. |
| 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 abaixoa 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 essasconfiguração 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 a 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 identificará que o arquivo validará a existência do 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 é arquivo config.json será gravada 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 ainda , será exibida a tela de Candidatos ATS normalmente e ele ainda poderá será possível configurar o arquivo através da opção Configuração ATS-Protheus em Outras Ações: 
| 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 system\ 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:
| 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 EmpresasFiliais:
Na Fila de Erros (DLQ) do Smartlink - Detalhes da Fila:
| Aviso |
|---|
Os dados de Grupo de Empresa e Filial contidos no arquivo config.json deverão existir no Cadastro de Empresas (SIGACFG)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:
|
|
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 Funcionários > Outras Ações > Admissão Candidatos ATS
...
| Totvs custom tabs box |
|---|
| tabs | Passo 01, Passo 02, Passo 03, Passo 04Tela Inicial,Ações |
|---|
| ids | adm1,adm2 |
|---|
|
| Totvs custom tabs box items |
|---|
| 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 |
|---|
| default | yes |
|---|
| referencia | adm1 | adm2 |
|---|
| 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 - Informado Grupo de Empresa inválido/inexistente,
- Informado Filial inválida/inexistente
- Informado Grupo de Empresa e Filial inválidos/inexistentes,
 Image Modified
Após informar um conteúdo válido, a configuração é gravada com sucesso e o arquivo config.json |
|
é sgravado é gravado dentro da pasta do Startpath sob o novo folder ats:  Image Modified
 Image Modified
|
|
| | Totvs custom tabs box items |
|---|
|
|
...
| 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 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 Dicionário Cadastro de DadosFuncionários
TOTVS RH Atração de Talentos
...
