Fórum

API que retorna os dados da vaga através do recruitmentProcessId

• gsbarizao

  Participante

  # 3 anos, 2 meses atrás

  Temos a necessidade de recuperar dados do processo de recrutamento através do “recruitmentProcessId” (id do processo de recrutamento).
  Tentamos usar o endpoint “/hcm/vacancymanagement/entities/recruitmentProcess/{id}”, no entanto ele não retorna os dados completos conforme a documentação.
  Retorna apenas o JSON Abaixo:

  {
      "id": "390d66ee-7963-4bb6-a5c7-6147c150e07c",
      "subscriptionType": "SELECTED",
      "medicalExamStatus": "NONE",
      "statusIntegration": true,
      "initialCandidateType": "EXTERNAL",
      "status": "ACTIVE",
      "createdBy": "gestor-hcm@seniornorteprdev.com.br",
      "createdDate": "2021-09-06T14:06:55.412Z",
      "lastModifiedBy": "gestor-hcm@seniornorteprdev.com.br",
      "lastModifiedDate": "2021-09-06T14:16:04.192Z",
      "_discriminator": "recruitmentProcess"
  }

  A justificativa para isso, é que estamos fazendo uma customização que fará a interceptação da primitiva “/vacancymanagement/actions/sendToMedicalExam”.
  Esse método gera uma integração com G5 para realização da marcação do exame médico, e como o cliente já possui customização nesse processo, precisamos desenvolver essa customização também na plataforma.
  O payload na primitiva acima não possui muitos dados, restando apenas o “recruitmentProcessId”, para conseguir recuperar mais informações sobre o processo.
  Abaixo o json de payload dessa primitiva:

  {
  	"attendant": {
  		"code": "3",
  		"externalId": "1D54B3FD7C14456EBF956CE6FBAC6445",
  		"name": "Ana Paula Prestone"
  	},
  	"recruitmentProcessId": "390d66ee-7963-4bb6-a5c7-6147c150e07c",
  	"activeEmployeeId": "CC023C10EC294A10923BCE1FE11B362E",
  	"context": "HR"
  }

  Dessa forma, nesse tópico, gostaria de verificar se alguém sabe outra forma de recuperar mais informações do processo tendo como informação base apenas o “recruitmentProcessId”, ou ainda, se há alguma forma de fazer o método “/hcm/vacancymanagement/entities/recruitmentProcess/{id}” retornar informações mais completas.

  Desde já agradeço!

  Atte.
  Guilherme Barizão
  fernanda.telles

  Participante

  # 3 anos, 1 mês atrás

  Boa tarde,

  Neste caso, você pode usar, no GET da recruitmentProcess os parâmetros de filter e displayFields.

  Neste link tem mais detalhes sobre o uso de filter e do displayFileds:

  Tutorial de uso das APIs de Entidade com filtros – OData

  E abaixo tem um exemplo da chamada do endpoint da recruitmentProcess, solicitando somente alguns campos específicos:
  GET hcm/vacancymanagement/entities/recruitmentProcess?filter=id eq ’64b9129b-c031-4832-ab5b-9b526bb5c56f’&displayfields=subscriptionType,medicalExamStatus,vacancy.code,vacancy.jobposition.name,candidate.name,candidate.email

  Os campos que podem ser informados no displayFields estão detalhados no retorno da API, na documentação da API no dev.senior.com.br.

  Att,
  Fernanda.