Recruiting request position

Applies to these Dynamics 365 apps:
Human Resources

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

Physical name: mshr_hcmrecruitingrequestpositionentity

Description

Describes the position or positions to fill for a recruiting request. Adding a position to the recruiting request is optional. The properties of the position are read-only, as the position properties shouldn't be different on the recruiting request than they are on the position master record. If the properties need to change, it should be done on the position master record before adding the position to the recruiting request.

JSON representation

{
    "mshr_recruitingrequestid": "String",
    "mshr_positionid": "String",
    "mshr_description": "String",
    "mshr_positiontypeid": "String",
    "mshr_status": Int,
    "mshr_departmentnumber": "String",
    "mshr_reportstopositionid": "String",
    "mshr_reportstopersonnelnumber": "String",
    "mshr_financialdimension": "String",
    "mshr_dataareaid": "String",
    "_mshr_dataareaid_id_value": "Guid",
    "mshr_primaryfield": "String",
    "_mshr_fk_recruitingrequest_id_value": "Guid",
    "_mshr_fk_position_id_value": "Guid",
    "_mshr_fk_positiontype_id_value": "Guid",
    "_mshr_fk_department_id_value": "Guid",
    "_mshr_fk_reportstoposition_id_value": "Guid",
    "_mshr_fk_reportstoworker_id_value": "Guid",
    "mshr_hcmrecruitingrequestpositionentityid": "Guid"
}

Properties

Property Physical name Type	Use	Description
Recruiting Request Position Entity ID mshr_hcmrecruitingrequestpositionentityid GUID	Read-only Required	System-generated identifier of the recruiting request position record.
Recruiting Request ID mshr_recruitingrequestid String	Write-once Required	The user-readable unique identifier of the recruiting request.
Recruiting Request ID Value _mshr_fk_recruitingrequest_id_value GUID	Read-only Required Foreign key: mshr_hcmrecruitingrequestentityid of mshr_hcmrecruitingrequestentity entity	System-generated identifier of the recruiting request to which the position is assigned.
Position ID mshr_positionid String	Write-once Required	The user-readable unique identifier of the position.
Position ID Value _mshr_fk_position_id_value GUID	Read-only Required Foreign key: mshr_hcmpositionv2entityid of mshr_hcmpositionv2entity entity	System-generated identifier of the position.
Description mshr_description String	Read-only Required	The position description.
Position Type ID mshr_positiontypeid String	Read-only Optional	The user-readable unique identifier of the position type for this position.
Position Type ID Value _mshr_fk_positiontype_id_value GUID	Read-only Optional Foreign key: mshr_hcmpositiontypeentityid of mshr_hcmpositiontypeentity entity	A system-generated unique identifier of the position type for this position.
Status mshr_status RecruitingRequestPositionStatus option set	Read/write Required	Status of the position for the recruiting request.
Department Number mshr_departmentnumber String	Read-only Optional	The department number of the position.
Department ID Value _mshr_fk_department_id_value GUID	Read-only Optional Foreign key: mshr_omdepartmententityid of mshr_omdepartmententity entity	System-generated unique identifier of the department of the position.
Reports To Position ID mshr_reportstopositionid String	Read-only Required	The user-readable ID of the position to which the recruited position reports in the organizational hierarchy.
Reports To Position ID Value _mshr_fk_reportstoposition_id_value GUID	Read-only Required Foreign key: mshr_hcmpositionv2entityid of mshr_hcmpositionv2entity entity	The system-generated ID of the position to which the recruited position reports.
Reports To Personnel Number mshr_reportstopersonnelnumber String	Read-only Required	The worker ID of the worker to which the hired candidate will report.
Reports To Worker ID Value _mshr_fk_reportstoworker_id_value GUID	Read-only Required Foreign key: mshr_hcmworkerbaseentityid of mshr_hcmworkerbaseentity entity	System-generated ID of the worker to which the hired candidate will report.
Financial Dimension mshr_financialdimension String	Read-only Optional	The financial dimension (for example, cost center) assigned to the position. The financial dimension is assigned for each position per legal entity. Cost centers that are defined in dimensions are accessible through the mshr_dimattributeomcostcenterentity entity.
Data Area ID mshr_dataareaid String	Read/write Optional	Specifies the legal entity (company) for the recruiting request position.
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 position.
Primary Field mshr_primaryfield String	Read-only Required	Concatenation of Recruiting Request value and Position ID as another method to uniquely identify the record.

See also

Applicant Tracking System integration API introduction
Example query for Recruiting request