...
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 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: 
| 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 | Tela Inicial,Ações |
|---|
| ids | adm1,adm2 |
|---|
|
| Totvs custom tabs box items |
|---|
| 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
|
| 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 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 é sgravado é gravado dentro da pasta do Startpath sob o novo folder ats: 
|
| Card |
|---|
| Na ação de Admitir é exibida tela para selação 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':  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: 
|
| Card |
|---|
| Na ação de Visualizar é possível verificar os dados recebidos pela integração. 
|
| Card |
|---|
| id | op5 |
|---|
| label | Compabilidade Campos |
|---|
| Oscampos 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 |
RA_ADMISSA | content.hiringDate | (campo não presente no JSON exemplo(Cargos) | RA_PORTDEF | content.Applicant.Diversity.* |
Mapeamento a seguir:Ver listagem no próximo bloco. |
Mapeamento de Deficiências (RA_PORTDEF): |
Posição campo ProtheusPosição 1* (não possui esse tipo de deficiência) | Posição 2 | Posição campo Protheus | Diversity.Physical | 1 |
ou *-Portador de Deficiência Física |
ou *Posição 3-Portador de Deficiência Auditiva | 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) | *-Portador de Deficiência Visual |
|
|
|
|
04. Documentações Relacionadas
...
