BeyondERP.Newsletter
Menu

Master data page · Human resources

Contractors

A list page that shows the contractors who are employed in the company you are signed in to.

Used by
Accounts payable manager, Auditor, Chief executive officer and 23 more roles
Business process
Update worker information
Menu item
HcmWorkerListPage_Contractors
Main table
HcmWorker
Data entity
HcmWorkerEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA list page that shows the contractors who are employed in the company you are signed in to.
What you do hereUse this page to find, open, and maintain records for contractors (workers whose worker type is Contractor).
ExampleFor example, BEAT hires the IT consultant Marc Dubois as a contractor from 1 April to 30 September 2026; the Contractors tile goes from 6 to 7, and Marc shows Worker type Contractor and an Employment end date of 30 September 2026.
Contractors page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Hire contractors as Contractor workers with an end date

Keep contractors apart from employees by hiring them with Worker type Contractor and the end of the contract.

Steps from Microsoft

  1. Go to Human resources > Workers > Contractors.
  2. Use Contractors to find the contractors employed in the company you are signed in to; for employees, use Human resources > Workers > Employees.
  3. Search by name or personnel number, and check the Worker type column, which shows Contractor for every worker in the list.
  4. Open a contractor to see Contractor vendor (the vendor account linked to the contractor, such as the supplying agency), the linked Purchase order and the Employment end date.
  5. Use the Action Pane tabs, such as Work, Person and Compensation, to maintain the contractor's details, or select New to add a contractor.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Worker typeShows whether the worker is an employee or a contractor.Microsoft Learn Contractor
Contractor vendorThe vendor account linked to the contractor, such as the agency that supplies the contractor.Microsoft Learn V-0310 Dubois IT Consulting
Purchase orderThe purchase order linked to the contractor.Microsoft Learn PO-002481
Employment end dateThe date the contractor's employment ends.Microsoft Learn 30 September 2026

Common errors and fixes

MessageWhat to do
A contractor shows on the Employees listThe worker was hired with Worker type Employee. The worker type is chosen on the hire, so hire the person with Worker type Contractor. Microsoft Learn
A contractor hired in another legal entity isn't on the listThe list counts contractors employed in the company you are signed in to. Open Workers with View options set to contractors in all legal entities. Microsoft Learn

Test checklist

  1. Open Personnel management and note the count on the Contractors tile.
  2. Select the tile and check the list shows the same contractors for the company you are signed in to.
  3. Hire a test contractor in the current company and check that the tile count goes up by one.
  4. Check that the new contractor has Worker type Contractor and doesn't appear on the Employees list.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Hire contractors as Contractor workers with an end dateHire contractors with Worker type Contractor, the employment start and end date of the contract, and a position when they fill one.Learn's hire process uses the worker type to say whether a new worker is an employee or a contractor, and the workspace counts the two separately.How are contractors recorded?Hiring a contractor as an employee to save time: the person is counted on the Employees tile and list, and later reporting mixes the two groups.Test: Contractor counted on its own tile

Feature management and licence

Licence or add-inOn Employees the live security lets Human resource assistant, Compensation and benefits manager, Recruiter, Payroll administrator and Retail operations manager maintain workers; Human resource manager, Payroll manager, Training manager and Chief executive officer can view them. The full role list is under the page's security roles. No Feature management feature is needed for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared worker, per-company employment: Data management lists the Worker entity as shared, so a person is one worker record for every legal entity, while employment is held per legal entity. To move a worker to another legal entity, Learn's way is to end the employment in the first legal entity and rehire in the new one. This list shows only the contractors employed in the company you are signed in to. Checked in Dynamics 365
Can it be undoneHard to reverse: Only terminated workers can be deleted. For a contractor you remove position assignments and checklists first; the compensation steps don't apply because compensation isn't assigned to contractors. Correct contractor details on the record rather than deleting it. Microsoft Learn
If you change it laterThe worker type set on the hire decides whether the person is counted as an employee or a contractor on the workspace tiles and lists. When the contract ends, terminating the employment ends all position assignments of the contractor. Microsoft Learn
Technical architect

6Technical

Menu itemHcmWorkerListPage_Contractors Checked in Dynamics 365
FormHcmWorkerV2 Checked in Dynamics 365
TableHcmWorkerShown as “WORKER” in Record infoKey field: Person_NameChecked in Dynamics 365
Data entitiesHcmWorkerEntityWorker Microsoft data model
Who can open itPrivilegesView limited workers HcmLimitedWorkerViewCreate workers HcmWorkerCreateEdit workers HcmWorkerEditMaintain workers HcmWorkerMaintainView workers HcmWorkerViewMaintain time registration workers JmgLimitedWorkerMaintainView limited workers JmgLimitedWorkerViewView workers RetailLimitedWorkerViewDutiesMaintain audit policies AuditPolicyMaintainCreate maintenance requests EntAssetRequestCreateMaintain maintenance requests EntAssetRequestMaintainMaintain Asset Management setup EntAssetSetupMaintainView Enterprise Asset Management setup EntAssetSetupViewInquire into benefits process HcmBenefitInquireInquire into limited worker information HcmLimitedWorkerInquireInquire into workers HcmWorkerInquireInquire into workers for CEO HcmWorkerInquireCEOMaintain worker master HcmWorkerMaintainView information about workers HcmWorkerViewInquire into time registration workers JmgLimitedWorkerInquireMaintain time registration workers JmgLimitedWorkerMaintainInquire into payroll position and worker setup PayrollPositionWorkerSetupInquireSet up payroll positions and workers PayrollPositionWorkerSetupMaintainEnable project accounting process ProjProjectAccountingProcessEnableMaintain project master ProjProjectMasterMaintainMaintain retail worker RetailWorkerMaintain TrvEmployeeCreditCardMaintainEnable expense management process TrvTravelAndExpenseProcessEnableInquire into expense management reference data TrvTravelAndExpenseReferenceDataInquire
27 security rolesAuditor AuditPolicyManagerChief executive officer CompanyChiefExecutiveOfficerMaintenance clerk EntAssetMaintenanceClerkMaintenance manager EntAssetMaintenanceManagerMaintenance requester EntAssetMaintenanceRequesterExpense administrator ExpenseAdministratorField Service Integration User FieldServiceIntegrationUserCompensation and benefits manager HcmCompensationAndBenefitsManagerHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManagerRecruiter HcmRecruiterTraining manager HcmTrainingManagerIoT messaging service role IoTIntMessagingServiceRoleShop supervisor JmgShopSupervisorProduction manager ProdProductionManagerProject accountant ProjProjectAccountantProject manager ProjProjectManagerProject supervisor ProjProjectSupervisorRetail operations manager RetailOperationsManagerRetail service RetailServiceRetail store manager RetailStoreManagerService delivery manager SMAServiceDeliveryManager TestRoleJmgLimitedWorkerMaintainSales manager TradeSalesManagerAccounts payable manager VendInvoiceAccountsPayableManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itHuman resource assistant HcmHumanResourceAssistantCompensation and benefits manager HcmCompensationAndBenefitsManagerRecruiter HcmRecruiterPayroll administrator HcmPayrollAdministratorRetail operations manager RetailOperationsManagerTo use itHuman resource manager HcmHumanResourceManagerPayroll manager HcmPayrollManagerTraining manager HcmTrainingManagerChief executive officer CompanyChiefExecutiveOfficerSales manager TradeSalesManagerGive people one of these roles. On this system, 26 roles can open this page.Checked in Dynamics 365
Actions on the pageWork: Personnel actions, Work details, Changes timeline, Related informationPerson: Personal information, Competencies, DevelopmentLeave: Manage leave, Set upCompensation: Employee compensation, Bank accounts, Labor unions, CommissionPayroll: Taxes, Payroll, Ready to pay, GenerateBenefits: Benefits, Enrollment, Eligibility, ReportsCompliance: ComplianceTime: Maintain, Reports, Inquiries, Time assignment, Flex, Worker balancesCommerce: Set up, Media, View, External identity, POSGeneral: Cases, CAPA, Registration, Warehouses(Action Pane without tabs): New, DeleteChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmWorkerListPage_Contractors
Integrate withHcmWorkerEntity data entity Microsoft data model
Data migrationHcmWorkerBaseEntity Base worker: the worker record with the person's name and personnel number. Shared by all companies.HcmEmploymentV2Entity Employment V2: the worker's employment in each legal entity, with start and end dates.HcmEmploymentDetailEntity Employment detail: the details of each employment.HcmPersonDetailsEntity Person details: the person's private details.HcmPositionWorkerAssignmentV2Entity Position worker assignments V2: the positions the worker holds.Load order: Load with the Worker data migration template, in its order: Base worker, Employment V2, Employment detail, Person details, then identification, contacts and screenings, then Position worker assignments V2 and Worker primary position. Load the Personnel management setup template and the positions of the Jobs and positions template first, because assignments point to positions.Load first: HcmPositionWorkerAssignmentV2Entity, HcmEmploymentV2Entity, HcmWorkerBaseEntityMicrosoft Learn
Everyone

8Sources