BeyondERP.Newsletter
Menu

Setup step on the Organization hierarchies page · Organization administration

Set up Organization hierarchies

Use this page to build hierarchies that let you view and report on the business from different angles, such as tax, legal or internal control.

Business process
Administer system features
Menu item
OMHierarchyList
Data entity
OMOrganizationHierarchyPurposeEntity
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 list page of organization hierarchies, which show the relationships between the organizations that make up your business.
What you do hereUse this page to build hierarchies that let you view and report on the business from different angles, such as tax, legal or internal control.
ExampleFor example, you can create a purchasing hierarchy to control purchasing policies, rules and business processes.
Organization hierarchies 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.

Step by step, with screenshots

Set up Organization hierarchies1 screen

Use this page to build hierarchies that let you view and report on the business from different angles, such as tax, legal or internal control.

  1. Screen 1

    Create an organization hierarchy

    Go to Organization administration > Organizations > Organization hierarchies

    1. Select New
    2. Enter the hierarchy name
    3. Select Save
    4. Assign a purpose when the hierarchy is ready to use
    1NameOrganization hierarchy
    Create an organization hierarchy (zoomed on the outlined fields)
    Show the full screenCreate an organization hierarchy
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to Organization administration > Organizations > Organization hierarchies.
  2. Select New.
  3. In the Name field, enter a name.
  4. In the Purpose section, select Assign purpose and pick a purpose.
  5. In the Assigned hierarchies section, select Add, select your new hierarchy, and select OK.
  6. Select your hierarchy and select View hierarchy.
  7. Select Edit, then Insert to add organizations.
  8. Save a draft or Publish the changes.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
PurposeDecides which types of organizations the hierarchy can include and where it can be used.Microsoft Learn
PublishMakes your hierarchy changes take effect; you can also save them as a draft first.Microsoft Learn
NameThe name of the organization hierarchy.Checked in Dynamics 365Organization hierarchyName

Common errors and fixes

MessageWhat to do
The Organization doesn't existWhen importing a multilevel hierarchy with data entities, import from the top down: the highest parent node first, then each level of child nodes in a separate import. Microsoft Learn

Test checklist

  1. Create a hierarchy, assign a purpose, and add it under Assigned hierarchies.
  2. Select View hierarchy, Edit, insert organizations, then Save the draft.
  3. Publish with today's effective date in your usual time zone.
  4. If the hierarchy is linked to an account structure, post a journal with a valid and an invalid dimension combination and check that only the valid one passes (allow up to 24 hours after publishing).

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Organization hierarchiesFew, balanced hierarchies: one operating-unit hierarchy reused for all policy purposes, no second hierarchy for the same purpose in a legal entity, and every change made in draft before publishing.Learn's best practices: don't create a hierarchy for every purpose, don't model several hierarchies for the same purpose in one legal entity, keep hierarchies balanced, and use draft mode before publishing a new version.One shared hierarchy for several purposes, or a hierarchy per purpose?Publishing more than once a day or in different time zones: a hierarchy can be published only once per calendar day in a time zone, and mixing time zones can make effective dates collide and block the publish.Test: Published hierarchy controls dimension combinations
Solution architect

5Design impact

Can it be undoneHard to reverse: Each publish creates a new effective-dated version. Mistakes are corrected by a new draft and publish, and a wrongly future-dated version has to be deleted from Future changes. Operating units added to a hierarchy can't be deleted.
If you change it laterChange a hierarchy in draft mode and publish it as a new version; an operating unit that is in a hierarchy can't be deleted. Microsoft Learn
Technical architect

6Technical

Menu itemOMHierarchyList Checked in Dynamics 365
FormOMHierarchyManager Checked in Dynamics 365
Data entitiesOMOrganizationHierarchyPurposeEntityOrganization hierarchy purposes Checked in Dynamics 365OMOrganizationHierarchyTypeEntityOrganization hierarchy type Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerProduction manager ProdProductionManagerAccounting manager LedgerAccountingManagerHuman resource assistant HcmHumanResourceAssistantRental manager RentalManagerTo use itHuman resource manager HcmHumanResourceManagerRental purchasing manager RentalPurchasingManagerRental sales manager RentalSalesManagerRental coordinator agent RentalCoordinatorAgentRental clerk RentalClerkGive people one of these roles. On this system, 18 roles can open this page.Checked in Dynamics 365
Actions on the pageOptionsChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=OMHierarchyList
Integrate withOMOrganizationHierarchyPurposeEntity data entity Checked in Dynamics 365
Everyone

8Sources

To cite this step: OA-ORG-030, Set up Organization hierarchies. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/OA-ORG-030