Fluxo de Recrutamento Interno

Nesse fluxo está previsto a criação, atualização e a exclusão destes colaboradores na Gupy.

Na prática, quando uma pessoa funcionária da sua empresa fizer login como candidata, ela terá visão das vagas internas e poderá participar dos processos seletivos destinados apenas para colaboradores de forma mais ágil, aumentando o nível de confiabilidade do processo e impactando positivamente no tempo de vaga aberta.

Habilitando Endpoints

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.

Abaixo encontra-se uma sugestão dos endpoints que devem ser habilitados obrigatoriamente para o funcionamento perfeito deste fluxo.

Cadastro de colaboradores

Acesse o endpoint POST Company Employee e preencha os parâmetros:

Importante: Caso a pessoa colaboradora não seja brasileira, é possível cadastrar outro documento de identificação.

No campo "countryOfOrigin" é necessário realizar um de/para de acordo com o formato esperado pela Gupy. Solicite a listagem para o time da Gupy.

Insira o token:

Exemplo de requisição

curl --request POST \
     --url https://api.gupy.io/api/v1/company-employees \
     --header 'accept: application/json' \
     --header 'authorization: Bearer c20cd2e5-a350-4e64-8775-8162b96a9567' \
     --header 'content-type: application/json' \
     --data '
{
  "employees": [
    {
      "name": "Nome Maria",
      "countryOfOrigin": "BR",
      "identificationDocument": "14714840633"
    }
  ]
}
'
'

Exemplo de resposta

{
  "employees": [
    {
      "id": 3700100,
      "companyId": 266,
      "name": "Nome Maria",
      "countryOfOrigin": "BR",
      "identificationDocument": "14714840633"
    }
  ]
}

Busca por Colaboradores

Acesse o endpoint GET Company Employee:

Neste endpoint, além de preencher os parâmetros citados no cadastro de colaboradores, é possível limitar a quantidade de itens exibidos por página, além de definir a paginação desejada.

Nessa chamada, nenhum parâmetro é obrigatório.

Atualização de colaboradores

Acesse o endpoint PUT Company Employee:

Nesta chamada, é necessário coletar o employeeId retornado no GET Company Employees e inserir nos parâmetros com as demais informações solicitadas.

Exemplo de requisição

curl --request PUT \
     --url https://api.gupy.io/api/v1/company-employees/3700100 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer c20cd2e5-a350-4e64-8775-8162b96a9567' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "Nome Maria",
  "identificationDocument": "14714840634",
  "countryOfOrigin": "CL"
}
'
'

Exemplo de resposta

{
  "id": 3700100,
  "companyId": 266,
  "name": "Nome Maria",
  "countryOfOrigin": "CL",
  "identificationDocument": "14714840634"
}

Exclusão de Colaboradores:

Acesse o endpoint DELETE Company Employee:

Neste endpoint é apenas necessária a inclusão do employeeId retornado na chamada GET.

Exemplo de requisição

curl --request DELETE \
     --url https://api.gupy.io/api/v1/company-employees/3700100 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer c20cd2e5-a350-4e64-8775-8162b96a9567'
'

Exemplo de resposta

{
  "employeeDeleted": true
}

Como ficará essa integração na Gupy?:

No SETUP da plataforma > Estrutura da Empresa, encontramos a opção "Pessoas Colaboradoras"

Na visão do painel de admissões, será possível identificar as pessoas candidatas internas através deste ícone