BeyondERP.Newsletter
Menu

Setup step on the Union agreement page · Human resources

Set up Union agreement

Use this page to record each agreement with a labor union, the legal entity that holds the contract, and the periods the contract is valid for.

Used by
Human resource assistant, Human resource manager, Payroll administrator
Business process
Develop people strategy
Menu item
HcmUnionAgreement
Main table
HcmUnionAgreement
Data entity
HcmLaborUnionAgreementEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you record union agreements, which link positions to the labor unions that negotiated them, with contract periods.
What you do hereUse this page to record each agreement with a labor union, the legal entity that holds the contract, and the periods the contract is valid for.
ExampleFor example, BEAT records the agreement UCA - Consultants for legal entity BEAT with union UCA, signed 15 December 2025 and effective 1 January 2026 to 31 December 2028; the 15 consultant positions are linked to it on their Labor union FastTab.
Union agreement 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

Set up Union agreement

Use this page to record each agreement with a labor union, the legal entity that holds the contract, and the periods the contract is valid for.

Steps from Microsoft

  1. Go to Human resources > Setup > Union agreement.
  2. Pick the Legal entity above the list and use the Filter box to find an agreement.
  3. Select New and enter the Union agreement and Labor union, and type the Agreement description.
  4. Expand Agreement Detail and Notes for the terms of the agreement.
  5. Select Save; select Delete to remove a selected agreement.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Legal entityThe legal entity that holds the contract with the union.Microsoft Learn BEAT
Union agreementA unique name for the agreement.Microsoft Learn UCA - ConsultantsAgreementName
Labor unionThe labor union that negotiated the agreement.Microsoft Learn UCAUnionID
Agreement descriptionA detailed description of the agreement.Microsoft Learn Collective agreement for consultants 2026-2028Description
Date signedThe date on the contract.Microsoft Learn 2025-12-15DateSigned
Effective/ExpirationThe period the contract details are valid for.Microsoft Learn 2026-01-01 to 2028-12-31

Common errors and fixes

MessageWhat to do
The agreement can't be selected on a positionThe agreement belongs to another legal entity or another union. Pick the agreement of the position's legal entity and union. Microsoft Learn

Test checklist

  1. Create a union agreement for a legal entity and labor union with effective and expiration dates.
  2. Link it on a position's Labor union FastTab.
  3. Check the agreement shows on the position for the dates of the contract.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Union agreementOne agreement per contract and legal entity, naming the labor union, with Date signed and the effective and expiration period of the contractPositions link to the agreement for a legal entity, and the position union agreement carries the agreement's validity dates to payroll.How are agreement periods kept?Creating the agreement in the wrong legal entity: positions of the contracting company can't select it.Test: Agreement reaches the position

Feature management and licence

Licence or add-inHuman resource assistant maintains the agreements; Human resource manager and Payroll administrator view them. No Feature management feature is needed for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared table with a legal entity on each agreement: Data management lists the Labor union agreement entity as shared, and each agreement names the legal entity that holds the contract. Checked in Dynamics 365
Can it be undoneHard to reverse: Agreements are linked to positions with validity dates, so changes need to be carried through to the positions that use them.
If you change it laterPosition union agreements carry the agreement name, labor union, legal entity and valid from and to dates, and are passed to payroll through the Position Union Agreement entity, so changing an agreement's dates or union reaches the positions and payroll. Microsoft Learn
Technical architect

6Technical

Menu itemHcmUnionAgreement Checked in Dynamics 365
FormHcmUnionAgreement Checked in Dynamics 365
TableHcmUnionAgreementShown as “UNION AGREEMENT” in Record infoKey field: LaborUnion_UnionID, AgreementName, LegalEntity_DataAreaChecked in Dynamics 365
Data entitiesHcmLaborUnionAgreementEntityLabor union agreement Checked in Dynamics 365HcmUnionAgreementDurationEntityUnion agreement duration (The effective and expiration periods of an agreement.)
Who can open itPrivilegesMaintain union agreements HcmUnionAgreementMaintainView union agreements HcmUnionAgreementViewDutiesEnable maintenance of labor union position and employee relationships HcmLaborUnionProcessEnableInquire into labor union position and employee relationships HcmLaborUnionProcessInquireEnable maintenance of labor unions and labor union agreements HcmLaborUnionSetupEnableInquire into labor union position and employee relationships HcmLaborUnionSetupInquire
3 security rolesHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministrator
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itHuman resource assistant HcmHumanResourceAssistantTo use itHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmUnionAgreement
Integrate withHcmLaborUnionAgreementEntity data entity Checked in Dynamics 365
Data migrationHcmLaborUnionAgreementEntity Labor union agreement. Shared table; each agreement names its legal entity.HcmUnionAgreementDurationEntity Union agreement duration: the contract periods.Load order: Load with the Jobs and positions template after Labor unions and before Position union agreement.Load first: HcmLaborUnionEntityMicrosoft Learn
Everyone

8Sources

To cite this step: HR-SETUP-150, Set up Union agreement. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/HR-SETUP-150