Payroll position

Important

The functionality noted in this article is currently available in both the stand-alone Dynamics 365 Human Resources and the merged Finance infrastructure. Navigation might be different than noted while we make updates. If you need to find a specific page, you can use Search.

Applies to these Dynamics 365 apps:
Human Resources

This article describes the Payroll Positions entity in Dynamics 365 Human Resources.

Physical name: mshr_payrollpositionentity.

Description

This entity provides position-related information for a given employee.

Physical name: mshr_payrollpositionentity.

Properties

Property
Physical name
Type
Use Description
Position ID
mshr_positionid
String
Read-only The ID of the position.
Pay cycle ID
mshr_paycycleid
String
Read-only The pay cycle that is defined on the position.
Annual regular hours
annualregularhours
Decimal
Read-only The annual regular hours that are defined on the position.
Paid by legal entity
paidbylegalentity
String
Read-only The legal entity that is defined on the position and responsible for issuing payment.
Valid to
validto
Date Time Offset
Read-only The date that the position details are valid to.
Valid from
validfrom
Date Time Offset
Read-only The date that the position details are valid from.
Primary field
mshr_primaryfield
String
System generated The primary field.
Payroll position details entity ID
payrollpositiondetailsentityid
Guid
Required
System generated.
A system-generated globally unique identifier (GUID) value to uniquely identify the position.

Relations

Property value Related entity Navigation property Collection type
_mshr_fk_fixedcompplan_id_value mshr_payrollfixedcompensationplanentity mshr_FK_FixedCompPlan_id mshr_FK_PayrollFixedCompensationPlanEntity_PayrollPosition
_mshr_fk_hcmpositionhierarchy_id_value mshr_hcmpositionhierarchyentity mshr_FK_HcmPositionHierarchy_id Not applicable
_mshr_fk_job_id_value mshr_payrollpositionjobentity mshr_FK_Job_id mshr_FK_PayrollPositionJobEntity_Payroll
_mshr_fk_positionassignmentv2_id_value mshr_hcmpositionworkerassignmentv2entity mshr_FK_PositionAssignmentV2_id Not applicable

Example query

Request

GET [Organizaton URI]/api/data/v9.1/mshr_payrollpositionentities?$filter=mshr_positionid eq @positionid and mshr_validfrom le @asofdate and mshr_validto ge @asofdate&@positionid='000276'&@asofdate=2021-04-01

Response

{
    "mshr_positionid": "000276",
    "mshr_paycycleid": "w",
    "mshr_annualregularhours": 3000,
    "mshr_paidbylegalentity": "USMF",
    "mshr_validfrom": "2021-03-14T00:00:00Z",
    "mshr_validto": "2154-12-31T00:00:00Z",
    "mshr_primaryfield": "000276 | 3/14/2021",
    "_mshr_fk_job_id_value": "00010094-0000-0000-df00-014105000000",
    "_mshr_fk_fixedcompplan_id_value": "0000029f-0000-0000-d5ff-004105000000",
    "mshr_payrollpositionentityid": "00010097-0000-0000-df00-014105000000"
}

See also

Payroll integration API introduction