BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Workers

A list page of workers (employees and contractors) from which you open a worker's details and, on the Commerce tab, maintain the store-related settings such as POS permissions, POS notifications, default sales group and the external identity used to activate Store Commerce devices.

Used by
Accounts payable manager, Auditor, Chief executive officer and 23 more roles
Business process
Create and manage shifts in Dynamics 365 Commerce
Menu item
HcmWorkerListPage
Main table
HcmWorker
Data entity
HcmWorkerEntity
Show what matters for
PAGE GUIDEWhat the page does and how to use it7 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA list page of workers (employees and contractors) from which you open a worker's details and, on the Commerce tab, maintain the store-related settings such as POS permissions, POS notifications, default sales group and the external identity used to activate Store Commerce devices.
What you do hereUse this page to give a worker the POS permissions and manager rights they need, link them to a Microsoft Entra account for device activation, set their default commission sales group, and subscribe them to POS notifications; then run the Staff (1060) distribution job to send the changes to the stores.
ExampleFor example, before a new store manager can activate a register, an IT administrator opens the worker here, checks that Manage Devices is Yes under POS permissions and associates the worker's Entra account under External identity.
Workers 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.

Steps from Microsoft

  1. Go to Retail and Commerce > Employees > Workers.
  2. Find and select the worker, then select the link in the row to open the details.
  3. Select the Commerce tab and select Edit.
  4. Set the Default group (sales group) if the worker earns commission.
  5. Select POS permissions to check the permission group, Manage Devices and notification subscriptions.
  6. Under External identity, use Commerce > Associate existing identity to map the worker's Microsoft Entra account.
  7. Select Save, then run the 1060 Staff distribution schedule job.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Default groupThe commission sales group added to the worker's POS sales lines by default.Microsoft Learn
POS permissionsLink that opens the worker's permission group, individual permission overrides and notification subscriptions.Microsoft Learn
External identity (Alias, UPN, External identifier)The Microsoft Entra account mapped to the worker for Store Commerce sign-in and device activation.Microsoft Learn
Notifications (FastTab under POS permissions)The POS operations the worker receives notifications for and their display order.Microsoft Learn

Common errors and fixes

MessageWhat to do
Microsoft_Dynamics_Commerce_Runtime_EmployeePermissionGroupNotFoundRun the Staff scheduler job (1060) so the worker's POS permissions reach the offline database. Microsoft Learn
Microsoft_Dynamics_Commerce_Runtime_EmployeeNotOnStoreCheck the worker is in the store's address book, then run the Staff scheduler job (1060). Microsoft Learn

Test checklist

  1. Open the worker, add the store's address book, and use Associate existing identity to link a Microsoft Entra account.
  2. Check Alias, UPN and External sub identifier are filled on the Commerce tab.
  3. Review POS permissions for any worker-level overrides.
  4. Run the 1060 (Staff) job and sign in to POS as the worker.

Source: Microsoft Learn

Solution architect

4Design impact

Can it be undoneReversible: Commerce settings such as POS permissions, notifications and the associated Microsoft Entra identity can be changed at any time; stores only see the change after the 1060 (Staff) job runs. Worker-level POS permission values override the permission group. Microsoft Learn
If you change it laterChanges to a worker's Commerce settings reach the stores only after the Staff distribution job runs; the mapped Entra account becomes the worker's activation account for Store Commerce. Microsoft Learn
Technical architect

5Technical

Menu itemHcmWorkerListPage 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 HcmLimitedWorkerViewEdit workers HcmWorkerEditMaintain workers HcmWorkerMaintainView workers HcmWorkerViewMaintain time registration workers JmgLimitedWorkerMaintainView limited workers JmgLimitedWorkerViewView workers RetailLimitedWorkerView RetailStoreManagementWorkspaceMaintainMaintain store management workspace for retail trial. RetailTrialStoreManagementWorkspaceMaintainDutiesMaintain 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 ProjProjectMasterMaintain RetailStoreManagementWorkspaceMaintainMaintain store management workspace for retail trial. RetailTrialStoreManagementWorkspaceMaintainMaintain 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 itRetail operations manager RetailOperationsManagerRetail store manager RetailStoreManagerHuman resource assistant HcmHumanResourceAssistantRecruiter HcmRecruiterCompensation and benefits manager HcmCompensationAndBenefitsManagerTo use itRetail service RetailServiceSales manager TradeSalesManagerProject manager ProjProjectManagerShop supervisor JmgShopSupervisorProduction manager ProdProductionManagerGive people one of these roles. On this system, 26 roles can open this page.Checked in Dynamics 365
Actions on the pageWorkPerson: 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 balancesProject: Set up, Project control, Transactions, ViewCommerce: Set up, Media, View, External identity, POSGeneral: Cases, CAPA, Set up, Registration, WarehousesExpense: Edit(Action Pane without tabs): New, DeleteChecked in Dynamics 365
Developer

6Developer

Open it by URLhttps://<your-environment>/?mi=HcmWorkerListPage
Integrate withHcmWorkerEntity data entity Microsoft data model
Data migrationHcmWorkerEntity (Worker): shared by all companies.Microsoft Learn
Everyone

7Sources