Histórico da Página
01. VISÃO GERAL
RESUMO
A integração possibilita permite a criação e utilização dos dados de candidatos, candidaturas e vagas no TOTVS RH Atração de Talentos.
Os grupos de dados relacionados à Candidaturas irão permitir que o sistema de origem envie as informações de candidatos que estão aptos para iniciar o processo de admissão. Estes candidatos por regras devem estar inseridos na etapa de contratação em uma vaga de status Publicada no TOTVS RH Atração de Talentos.
Os grupos de dados relacionados à vagas, por sua vez, receberão as informações de uma nova requisição de vaga vindo do sistema de origem e, com isso irá criar uma vaga no status rascunho dentro do TOTVS RH Atração de Talentos.
Os dados que atualmente são possíveis realizar a integração com o produto são:
- Candidaturas
- Relacionado aos candidatos:
- Dados pessoais;
- Informações de localização;
- Informações complementares relacionadas à Diversidade e Inclusão, sendo essas de preenchimento opcional para o candidato.
- Relacionado à vaga:
- Informações específicas da vaga;
- Informações da empresa;
- Informações de cadastro.
- Relacionado à candidatura em uma vaga:
- Atualização do status do candidato.
- Relacionado aos candidatos:
- Vagas
- Informações específicas da vaga;
- Informações de cadastro.
- Área
- Informações específicas da área;
- Informações de cadastro.
- Unidade
- Informações específicas da unidade;
- Informações de cadastro.
- Cargo
- Informações específicas da cargo;
- Informações de cadastro.
- Localidade
- Informações dos estados
- Informações das cidades
Quando houver mudanças significativas no contrato da API, a versão dessas API's serão alteradas e o sistema de origem deverá se certificar que a versão que está sendo utilizada ainda é mantida pela TOTVS.
HISTÓRICO DE ALTERAÇÕES
- Criação do endpoint para retornar os dados das candidaturas que possuem status “contratado” em vagas abertas.
- Criação do endpoint para receber os dados para criação da vaga.
- Criação do endpoint para atualizar o status da candidatura.
- Inclusão dos campos isCLT, isPJ e isInternship referentes ao regime de contratação na API de GET de candidaturas.
- Adição dos endpoints de Cargo, Área, Unidade e Localidades
- Adição dos endpoints sobre as pessoas candidatas do Banco de talentos
02. FLUXO DE INTEGRAÇÃO
A solicitação de sincronização (envio de dados) deve ocorrer em uma opção dentro do sistema de origem, não havendo como solicitar a sincronização a partir do ATS, portanto, esta sincronização ocorre via ação do usuário-cliente, não havendo um fluxo automático.
Os endpoints de integração funcionam de forma assíncrona, portanto o envio de dados sempre irá ocorrer em lotes de no máximo 100 registros. Para cada lote enviado o endpoint de integração irá devolver um ID do processo, sendo possível realizar a sua consulta do status do lote através de endpoints de consulta.
Os registros que estiverem válidos serão gravados na base de dados enquanto os que tiverem erros de validação não serão gravados, neste caso será retornado no endpoint de consulta qual validação falhou, o integration ID do registro e um código do erro que poderá ser utilizado para obter mais detalhes na seção 04 de erros de validação que se encontra neste documento.
03. ENDPOINT E PARÂMETROS DE ENTRADA
Endpoint da API que será utilizado para inserir e atualizar dados:
...
URL base
...
201
...
...
em rascunho a partir de uma requisição do tipo "aumento de quadro" ou "substituição" com status "APROVADA" no sistema RM.
02. FLUXO DE INTEGRAÇÃO
Ao habilitar a integração a carga inicial é realizada. Clique aqui e veja como habilitar a integração.
| Aviso |
|---|
Dependendo da quantidade de dados, esse processo pode ser um pouco demorado |
Após a conclusão da carga inicial, o sistema passa a receber as requisições com status de APROVADA a partir da data em que a integração foi habilitada.
03. CRIAÇÃO DA VAGA NO ATS
Ao receber a requisição o ATS cria uma vaga em rascunho com os dados daquela requisição e uma identificação de que aquela vaga foi criada a partir de uma requisição.
Ao fazer a edição desta vaga os dados que vieram da requisição com exceção do título não podem ser alterados, são eles: cargo da vaga, unidade, área, código da requisição, motivo da requisição e justificativa da requisição, os mesmos ficam desabilitados.
...
O detalhamento do formato dos objetos JSON que serão trafegados no envio e retorno dos endpoints devem ser consultados na documentação do swagger do ambiente citado no início desta seção. A URL para acesso a documentação é - https://api-centraldorecrutador.totvs.app/recruitment-integration/swagger/index.html
04. ERROS DE VALIDAÇÃO
Em situações onde há má formatação do corpo da requisição, será retornado um erro do tipo Bad Request 400 na requisição acompanhado de mensagens informando quais campos estão inconsistentes.
05. TOKEN DE ACESSO
A autorização da API é gerenciada por um token de acesso do RAC sendo um token de fluxo ClientCredentials, portanto é um token de aplicação que não contém usuário sendo necessário apenas o ClientID e SecretID para geração, que pode ser recuperado na página de Chaves da integração. Durante o desenvolvimento recomendamos que o token de acesso seja gerado através do postman conforme as instruções a seguir:
1 - No Postman, criar uma requisição POST com o endereço do endpoint de geração do ambiente de desenvolvimento da TOTVS. O environment deve ser informado dev, para produção utilizar a url: https://admin.rac.totvs.app/totvs.rac/connect/token
2 - Na aba Headers inclua a Key: Content-Type com o Value: application/x-www-form-urlencoded; charset=UTF-8
3 - Na aba Body acrescente as Key para client_id e client_secret. Para ter acesso aos valores que devem ser inseridos, é necessário entrar em contato com o time de desenvolvimento do produto.
4 - Com estes dados preenchidos, ao clicar no botão SEND será retornado um JSON com o token de autorização para ser utilizado no Swagger ou nas requisições criadas no sistema de origem.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas