Recruiting request

Applies to these Dynamics 365 apps:
Human Resources

This article 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_recruitingrequestlocation_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