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

[gsbarizao]

# 3 anos, 3 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]

# 3 anos, 2 meses 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.