Fluxo de Criação e Atualização de Cargos

Este fluxo obtém os dados básicos de cargos da base de dados do sistema utilizado pela sua empresa do cliente e os mantém sempre atualizados.

❗️

Atenção

A API não permite a exclusão de cargos que estejam sendo utilizadas em vagas ou usuários. Essa exclusão só é possível caso não haja vagas ou usuários atrelados.

Atualizações de cargo podem ser feitas em massa via suporte. Entre em contato com a pessoa responsável pela sua conta para entender como fazer isso.

Gerando o token

Para utilizar este fluxo, é necessário utilizar o Bearer Token gerado nas configurações avançadas da plataforma. Acesse nossa seção de autenticação para saber como gerar o o token de autenticação.

No momento de gerar o token habilite os seguintes endpoints da V1:

  • Job Roles

Criando os cargos

Acesse o endpoint POST Roles e preencha os parâmetros:

ParâmetroDescrição
nameNome do cargo (chave única não pode haver duplicidade)
codeCódigo atribuído à área no sistema externo do cliente (chave única não pode haver duplicidade)
similarToHierarquia que mais se aproxima da hierarquia definida para o cargo

Exemplo de requisição

curl --request POST \
     --url https://api.gupy.io/api/v1/roles \
     --header 'accept: application/json' \
     --header 'authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' \
     --header 'content-type: application/json' \
     --data '
{
     "name": "Diretor de Gente e Gestão",
     "similarTo": "director",
     "code": "101"
}
'

Exemplo de resposta

{
  "id": 1234,
  "name": "Diretor de Gente e Gestão",
  "code": "101",
  "similarTo": "director",
  "createdAt": "2023-02-24T19:35:16.608Z",
  "updatedAt": "2023-02-24T19:35:16.608Z"
}

Atualizando os cargos

  1. Acesse o endpoint GET Roles
  2. No campo "name" filtre pelo cargo que deseja atualizar
  3. Clique em "Try it!" e salve a roleId
  4. Acesse o endpoint PUT Roles e preencha os parâmetros:
ParâmetroDescrição
roleIdID gerada automaticamente pela Gupy recuperada na resposta do endpoint POST Roles ou GET Roles
nameNome do cargo
codeCódigo atribuído à área no sistema externo do cliente
similarToHierarquia que mais se aproxima da hierarquia definida para o cargo

Exemplo de requisição

curl --request PUT \
     --url https://api.gupy.io/api/v1/roles/1234 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' \
     --header 'content-type: application/json' \
     --data '
{
     "code": "101",
     "name": "Pessoa diretora de gente e gestão"
}
'

Exemplo de resposta

{
  "id": 1234,
  "name": "Pessoa diretora de gente e gestão",
  "code": 101,
  "similarTo": "director",
  "createdAt": "2020-07-14T17:37:24.402Z",
  "updatedAt": "2023-02-24T19:43:44.658Z"
}

Como ficará essa integração na Gupy?

Possíveis erros

Cargos diferentes com mesmo código

É comum que cargos com o mesmo nome possuam códigos diferentes e, nossa sugestão para esse cenário é utilizar o nome dos cargos de uma forma “concatenada”, como por exemplo: ID + Nome do Cargo.

Similaridade

É possível que não exista um similaridade simples de cargo para ser utilizado na Gupy e, nossa sugestão é fixar o valor “Analyst” para quando não encontrar um DE/PARA. Esse campo é muito importante, pois a nossa IA Gaia utiliza a similaridade de cargo e área para igualar as múltiplas vagas que temos e aprender com elas, utilizando essa informação para adaptar o ranking pra cargos e vagas específicos, além de auxiliar em análise de dados (KPIs, Relatórios).