Recruiting request

Applies to these Dynamics 365 apps:
Human Resources

This topic describes the Recruiting request entity for Dynamics 365 Human Resources.

Physical name: mshr_hcmrecruitingrequestentity

Description

Describes a request to recruit for a job.

JSON representation

{
    "mshr_recruitingrequestid": "String",
    "mshr_hiringmanagerpersonnelnumber": "String",
    "mshr_recruiterpartynumber": "String",
    "mshr_status": Int,
    "mshr_description": "String",
    "mshr_recruitingrequestlocationid": "String",
    "mshr_comments": "String",
    "mshr_jobid": "String",
    "mshr_titleid": "String",
    "mshr_jobfunctionid": "String",
    "mshr_defaultfulltimeequivalency": Decimal,
    "mshr_regulatoryjobcategory": Int,
    "mshr_jobtypeid": "String",
    "mshr_exemptstatus": Int,
    "mshr_estimatedstartdate": "Date",
    "mshr_externaldescription": "String",
    "mshr_compensationlevelid": "String",
    "mshr_compensationlowthreshold": Decimal,
    "mshr_compensationcontrolpoint": Decimal,
    "mshr_compensationhighthreshold": Decimal,
    "mshr_dataareaid": "String",
    "_mshr_dataareaid_id_value": "Guid",
    "_mshr_fk_hiringmanager_id_value": "Guid",
    "_mshr_fk_recruiter_id_value": "Guid",
    "_mshr_fk_job_id_value": "Guid",
    "_mshr_fk_title_id_value": "Guid",
    "_mshr_fk_jobtype_id_value": "Guid",
    "_mshr_fk_compensationlevel_id_value": "Guid",
    "mshr_hcmrecruitingrequestentityid": "Guid",
    "_mshr_fk_recruitingrequestlocation_id_value": “Guid”
}

Properties

Property
Physical name
Type
Use Description
Recruiting Request ID
mshr_recruitingrequestid
String
Read-only
Required
System-generated
A user-readable unique identifier for the request displayed in the HR application. Number sequence.
Recruiting Request Entity ID
mshr_hcmrecruitingrequestentityid
GUID
Read-only
Required
System-generated
A system-generated GUID value to uniquely identify the recruiting request.
Data Area ID
mshr_dataareaid
String
Read/write
Optional
Specifies the legal entity (company) for the recruiting request.
Data Area ID Value
_mshr_dataareaid_id_value
GUID
Read-only
Optional
Foreign key: cdm_companyid of cdm_company entity
System-generated GUID value identifying the legal entity (company) for the recruiting request.
Hiring Manager Personnel Number
mshr_hiringmanagerpersonnelnumber
String
Read/write
Optional
The personnel number of the hiring manager associated with this recruiting request.
Hiring Manager ID Value
_mshr_fk_hiringmanager_id_value
GUID
Read-only
Optional
Foreign key: mshr_hcmworkerbaseentityid of mshr_hcmworkerbaseentity entity
System-generated GUID value to identify the manager associated with the recruiting request.
Recruiter Party Number
mshr_recruiterpartynumber
String
Read/write
Optional
The person (party) number of the recruiter selected for the request.
Recruiter ID Value
_mshr_fk_recruiter_id_value
GUID
Read-only
Optional
Foreign key: mshr_dirpersonentityid of mshr_dirpersonentity entity
System-generated GUID value to identify the recruiter associated with the recruiting request.
Status
mshr_status
RecruitingRequestStatus option set
Read/write
Required
Indicates the status of the recruiting request.
Description
mshr_description
String
Read/write
Required
Describes the request.
Recruiting Request Location ID
mshr_recruitingrequestlocationid
String
Read/write
Optional
The user-readable unique identifier of the job location associated with this request.
Recruiting Location ID Value
_mshr_fk_recruitinglocation_id_value
GUID
Read-only
Optional
Foreign key: mshr_hcmrecruitingrequestlocationentityid of mshr_hcmrecruitingrequestlocationentity entity
System-generated GUID value to identify the recruiting request location selected for the request.
Comments
mshr_comments
String
Read/write
Optional
Comments about the request for use by hiring managers and recruiters.
Job ID
mshr_jobid
String
Write-once
Required
The user-readable unique identifier of the job shared by all Positions associated with this request.
Job ID Value
_mshr_fk_job_id_value
GUID
Read-only
Required
Foreign key: mshr_hcmjobentityid of mshr_hcmjobentity entity
The system-generated unique identifier of the job shared by all Positions associated with the recruiting request.
Title ID
mshr_titleid
String
Read-only
Required
The user-readable unique identifier of the job title associated with this request.
Title ID Value
_mshr_fk_title_id_value
GUID
Read-only
Required
Foreign key: mshr_hcmtitleid of mshr_hcmtitleentity entity
The system-generated unique identifier of the title of the job selected for the recruiting request.
Job Function ID
mshr_jobfunctionid
String
Read-only
Required
Foreign key: mshr_jobfunctionid of mshr_hcmjobfunctionentity entity
The user-readable unique identifier of the job function associated with this request.
Default Full-Time Equivalency
mshr_defaultfulltimeequivalency
Double
Read-only
Required
The full-time equivalent value for the job, where 1.0 represents a full-time worker.
Regulatory Job Category
mshr_regulatoryjobcategory
RegulatoryJobCategory option set
Read-only
Optional
The EEO job category of the job function selected for the job. Valid values included in the HcmRegulatoryJobCatetory (mshr_hcmregulatoryjobcategory) option set.
Job Type ID
mshr_jobtypeid
String
Read-only
Optional
The type of the job associated with the position. The job types are user-defined values, available in the mshr_hcmjobtypeentity entity.
Job Type ID Value
_mshr_fk_jobtype_id_value
GUID
Read-only
Optional
Foreign key: mshr_hcmjobtypeentityid of mshr_hcmjobtypenentity entity
The system-generated unique identifier of the job type associated with the job for the recruiting request.
Exempt Status
mshr_exemptstatus
JobExemptStatus option set
Read-only
Optional
The FLSA exempt status based on the job type.
Estimated Start Date
mshr_estimatedstartdate
Date
Read/write
Required
The estimated date a candidate would start work.
External Description
mshr_externaldescription
String
Read/write
Optional
A candidate-facing description of the job/position.
Compensation Low Threshold
mshr_compensationlowthreshold
Double
Read/write
Optional
Lower bound for the compensation level.
Compensation Control Point
mshr_compensationcontrolpoint
Double
Read/write
Optional
Control point for the compensation level.
Compensation High Threshold
mshr_compensationhighthreshold
Double
Read/write
Optional
Upper bound for the compensation level.
Compensation Level
mshr_compensationlevelid
String
Read/write
Optional
The compensation level of the job. A job can be set up with multiple compensation levels. This attribute indicates the selected job compensation level for this request.
Job Compensation ID
_mshr_fk_jobcompensation_id_value
GUID
Read-only
Optional
Foreign key: mshr_hcmjobcompensationentityid of mshr_hcmjobcompensationentity entity
System-generated unique identifier for the compensation level associated with the Job of the recruiting request.

See also

Applicant Tracking System integration API introduction
Example query for Recruiting request