Recruiting request position

Applies to these Dynamics 365 apps:
Human Resources

This topic 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