01. VISÃO GERAL
RESUMO
A integração permite a com o sistema PROTHEUS permite automatizar o processo de criação de vagas, gerando automaticamente vaga em rascunho a partir de uma requisição do tipo "aumento de quadro" ou "substituição" com status "APROVADA" no sistema PROTHEUSde requisições aprovadas. Essa funcionalidade contempla especificamente os tipos de requisição “aumento de quadro” e “substituição”. Além disso, a solução permite a sincronização de dados essenciais, como cargos, áreas e unidades, garantindo que as informações estejam sempre atualizadas e alinhadas entre os sistemas. Com isso, o gerenciamento de vagas torna-se mais ágil, preciso e eficiente, melhorando a produtividade operacional.
02. FLUXO DE INTEGRAÇÃO
O CS deverá solicitar junto ao time de produto a liberação da integração no ambiente do cliente. Só após essa liberação a ativação da integração poderá ser iniciada.
...
A versão mínima para o PROTHEUS é a 12.1.2310, as anteriores não executam a integração, para verificar a versão siga os passos abaixo:
No RMAcessando qualquer módulo no PROTHEUS, clique em Ambiente Ajuda > Sobre > Mais info...> - conforme o print abaixo:
Observação: Caso não esteja, será necessária uma atualização. Clique aqui para mais informações.
Image Removed
Image Added
Antes de habilitar a integração dentro do sistema ATS, são necessárias algumas configurações prévias:
...
| Totvs custom tabs box |
|---|
| tabs | Permissão de Acesso, Ativação das CredenciaisAtivação da integração,Complemento de Estabelecimento,Portal Capital Humano (Solicitações),Meu RH (Solicitações) |
|---|
| ids | 1,2,3,4 |
|---|
|
| Totvs custom tabs box items |
|---|
| Para acessar o TOTVS App (Carol), é necessário fornecer permissão para o perfil do usuário responsável pela ativação da integração. No RM, clique no menu, depois emServiços Globais e siga os passos abaixo: - Segurança;
- Perfis;
- Sistema: Integração (dê um duplo clique para editar o perfil desejado*);
- Habilite o acesso na pasta "Acesso a Menus";
- Clique em: “[04] Totvs App”, depois em “[04.01] Integração Totvs App”, para abrir a pasta “[04.01.01] Aprovação Totvs App”;
- Por fim, clique em “Salvar”.
 Image RemovedFigura 1 - Tela de permissão para acesso ao TOTVS App.
| | Totvs custom tabs box items |
|---|
| PROTHEUS, acesse o programa de ativação "ConfigTotvsRH":  Image Added
Figura 1 - Chamada do programa de Ativação Protheus
Aqui será aberta a tela inicial, onde deverá clicar no botão Avançar:  Image Added
Figura 2 - Tela inicial
Aqui o usuário deverá informar Login e Senha do usuário Protheus, além de selecionar as empresas que deverão ter a integração ativada, depois clicar no botão Avançar:  Image Added
Figura 3 - Tela de Autenticação
Nesta tela deverá ser informada as Chaves de integração (Client ID e Client Secret) fornecidos pela Totvs. Após preencher pode clicar em Avançar para finalizar o processo:  Image Added
Figura 4 - Dados da Plataforma Após a permissão fornecida, através das opções de menu a esquerda, escolha o sistema Integração > TOTVS App > Ativação TOTVS App. Será apresentada tela do wizard de ativação para que você preencha os campos chave, conforme credenciais enviadas no email de provisionamento do ambiente encaminhado ao destinatário administrador da plataforma.
Este processo deve ser executado apenas na empresa coligada principal. - Credenciais para ativação por RACID ( RAC Client Id e RAC Client Secret (credenciais recebidas por email) )
- Informe o Client Id e Client Secret e ative o App HrPlatform
Após a leitura das credenciais do RAC será acionado processo de criação do serviço de execução continua, para o envio de dados; para issoexecução do processo de ativação, será criado um job com a função FWTECHFINJOB, que executará em background e enviará os dados para integração com a plataforma Carol. |
| Totvs custom tabs box items |
|---|
| Para integração de Protheus x ATS é necessário também o cadastro de Complemento de Estabelecimento, para identificar corretamente a Empresa e Filial de cada tabela na integração. Nesta rotina devem ser cadastradas todas as filiais centralizadoras (matriz) e demais filiais. Para quem já utiliza o módulo TAF (Automação Fiscal) essa tabela (C1E) já estará preenchida, caso não utilize, deve fazer os cadastros através da Rotina Complemento de Estabelecimento (TAFA050), através do módulo SIGATAF ou adicionar a rotina no menu de um outro módulo e realizar a sua chamada.
Exemplo de Cadastro de Complemento de Estabelecimento:  Image Added
Figura 1 - Guia principal do Cad. de Compl. Estabelecimento.
Obs.: Preencher as principais informações conforme Figura acima.
|
| Totvs custom tabs box items |
|---|
| No Portal do Capital Humano (GCH) na opção SOLICITAÇÕES, quando o cliente possuir integração com TOTVS App (Carol) e contratação do ATS (Atração e Talentos) será integrada as solicitações de AUMENTO DE QUADRO e SUBSTITUIÇÃO.
Exemplo de uma solicitação de Aumento de Quadro:  Image Added
Figura 1 - Página inicial das solicitações de aumento de quadro
 Image Added
Figura 2 - Incluindo uma solicitação de aumento de quadro
Exemplo de uma solicitação de Substituição:  Image Added
Figura 1 - Incluindo uma solicitação de substituição
| Nota |
|---|
| title | INFORMAÇÃO IMPORTANTE! |
|---|
|
No sistema ATS, o campo Função é obrigatório, portanto para que a integração de Requisições entre o Protheus x ATS seja bem sucedida, esta informação deve ser preenchida no sistema Protheus através do módulo SIGAORG (Estrutura Organizacional), no menu Movimento - Postos, conforme a tela abaixo:
 Image Added
|
|
| Totvs custom tabs box items |
|---|
| No Meu RH na opção SOLICITAÇÕES, quando o cliente possuir integração com TOTVS App (Carol) e contratação do ATS (Atração e Talentos) será integrada as solicitações de AUMENTO DE QUADRO.
Exemplo de uma solicitação de Aumento de Quadro:  Image Added
Figura 1 - Incluindo uma solicitação de aumento de quadro
 Image Added
Figura 2 - Incluindo uma solicitação de aumento de quadro e selecionando o departamento , todos os arquivos atualizados com a versão disponibilizada na nuvem ( "TOTVSAppConfig","Conceitos") serão baixados para o servidor e inseridos na tabela GTOTVSAPP a configuração de execução do processo em questão e na tabela GTOTVSAPPCONCEITO, os "Conceitos" responsáveis pela subida de dados para o ambiente em nuvem Carol, podendo este processamento ser acompanhado através do recurso para Gerenciamento de Job (GTOTVSAPPCONCEITOHST) . Para maiores informações clique aqui!  Image Removed
Figura 2 - Tela para ativação das credenciais no TOTVS App. Após a execução do processo de ativação, será criado um job, que executará em background que executará a cada 5 minutos os conceitos criados responsáveis pelo envio dos dados para integração com a plataforma Carol. | Aviso |
|---|
O passo a passo para realizar a ativação do TotvsApp no RM, pode ser acessada clicando aqui.
|
|
Após as configurações detalhadas acima, podemos habilitar a integração no ATS. Veja como habilitar a integração.
...
Após a conclusão da carga inicial, o sistema passa a receber as requisições apenas do tipo SUBSTITUIÇÃO e AUMENTO DE QUADRO com status de APROVADA a os dados alterados a partir da data em que a integração foi habilitada.
...
...
.
03. CRIAÇÃO DA VAGA NO ATS
...
- Cargo da vaga.
- Unidade.
- Área.
- Código da requisição.
- Motivo da requisição e
- Justificativa da requisição.
04. INTEGRAÇÃO DE CARGOS, UNIDADES E ÁREAS
Além da integração de requisições, o sistema oferece também mais três opções de integração, que podem ser combinadas entre si para personalizar o funcionamento da integração da forma mais adequada às necessidades do usuário:
- Integrar todos os cargos: integra todos os cargos cadastrados no seu ERP TOTVS com o ATS. É importante destacar que, ao habilitar essa opção, todos os cargos serão integrados, inclusive aqueles antigos ou atualmente não utilizados. Além disso, essa configuração funciona de forma independente: não é necessário que a integração de requisições esteja habilitada. Ao ativá-la, o sistema garantirá a sincronização completa de todos os cargos, independentemente de outras integrações em uso.
- Integrar todas as áreas: Integra todas as áreas cadastradas no seu ERP TOTVS com o ATS. É importante destacar que, ao habilitar essa opção, todas as áreas serão integradas, inclusive aquelas antigas ou atualmente não utilizadas. Além disso, essa configuração funciona de forma independente: não é necessário que a integração de requisições esteja habilitada. Ao ativá-la, o sistema garantirá a sincronização completa de todas as áreas, independentemente de outras integrações em uso.
- Integrar todas as unidades: Integra todas as unidades cadastradas no seu ERP TOTVS com o ATS. É importante destacar que, ao habilitar essa opção, todas as unidades serão integradas, inclusive aquelas antigas ou atualmente não utilizadas. Além disso, essa configuração funciona de forma independente: não é necessário que a integração de requisições esteja habilitada. Ao ativá-la, o sistema garantirá a sincronização completa de todas as unidades, independentemente de outras integrações em uso.
Para mais informações, acesse Marketplace.
| Informações |
|---|
|
Ao finalizar uma vaga no ATS, a requisição NÃO será finalizada no RMPROTHEUS. Caso ocorra uma alteração na requisição após a integração, a mesma NÃO será alterada no ATS, ou seja, as informações não serão refletidas na vaga. A integração NÃO se estende à admissão ou ao cadastro de funcionários na folha de pagamento. A integração NÃO traz nenhuma outra informação do RMProtheus, exceto as que são necessárias para a criação da vaga e estão descritas neste documento.
|
...
