BeyondERP.Newsletter
Menu

Setup step on the Order holds page · Sales and marketing

Work the order holds queue

Check out, review and clear holds so orders can move on.

Used by
Collections agent, Collections manager, Accounts receivable clerk and 6 more roles
Business process
Manage sales order holds
Menu item
MCROMHoldsListPage
Main table
MCRHoldCodeTrans
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 workbench page that gives an overview of all current and processed order holds, where you handle the holds and their sales orders.
What you do hereUse this page to check holds in and out and to clear holds so that orders can move on to the next fulfillment step.
ExampleFor example, SO-001234 for BEAT-000123 gets hold code CREDIT because the order total of 12,400.00 needs review; a collections agent checks out the hold, the manager approves, and the agent selects Clear holds so the warehouse can pick it.
Order holds 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

Business processManage sales orders › Manage sales order holds
Menu pathSales and marketing › Sales orders › Open orders › Order holds
Set up firstOrder hold codes Microsoft Learn All sales orders Microsoft Learn
Used next byAll sales orders Microsoft Learn
Related pagesAll sales orders Microsoft Learn
In this process Set up Order hold codes
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

Work the order holds queue

Check out, review and clear holds so orders can move on.

Steps from Microsoft

  1. Go to Sales and marketing > Sales orders > Open orders > Order holds.
  2. Use the Filter field or the Show list to filter by value or hold status, and select the hold.
  3. On the Hold checkout tab, select Check out so other users can't clear the hold while you work on it.
  4. Use Override checkout to hand a checked-out hold to another user.
  5. When the order is ready, on the Clear hold tab select Clear holds, or Clear and modify if the order needs changes.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Hold codeThe type of hold placed on the order.Microsoft Learn CREDITMCRHoldCode
Checked out toThe user who has the hold checked out.Microsoft Learn beat.agent1MCRCheckedOutTo
ShowFilters the list by hold status.Microsoft Learn
Days on holdHow many days an order has been on hold, to help prioritize the queue.Microsoft Learn

Common errors and fixes

MessageWhat to do
The hold can't be cleared by the user.The hold code names a Role; only users with that role can remove it. Ask a user with the role, or check the hold code setup. Microsoft Learn

Test checklist

  1. Put SO-001234 on hold with hold code CREDIT.
  2. Check the order shows Do not process and that picking list and packing slip buttons are disabled.
  3. On Order holds, check out and clear the hold.
  4. Check the hold shows as cleared and the order can be picked.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Work the order holds queueCheck out a hold before working on it and clear it with Clear and modify when the order needs changes.A checked-out hold can't be cleared by others, so two users don't release the same order with different decisions.Should a hold code remove inventory reservations?Clearing holds without the role named on the hold code: the role on the hold code decides who may remove it.Test: Hold blocks picking until cleared

Feature management and licence

Licence or add-inOn the live system, Sales clerk, Sales manager, Sales representative and Customer service representative use this page.

Checked in Dynamics 365

Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneReversible: Holds can be added again.
If you change it laterWhile a hold is checked out to you, other users can't clear it. Microsoft Learn
Technical architect

6Technical

Menu itemMCROMHoldsListPage Checked in Dynamics 365
FormMCRHoldCodeTrans Checked in Dynamics 365
TableMCRHoldCodeTransShown as “Hold codes” in Record infoChecked in Dynamics 365
Who can open itPrivilegesCustomer credit and collections CustomerCollectionManagerWorkspaceViewMaintain holds for sales orders MCROMHoldsListPageMaintainDutiesCustomer credit and collections CustomerCollectionManagerWorkspaceViewMaintain sales order holds MCRSalesHoldMaintain
10 security rolesCollections agent CollectionLetterCollectionsAgentCollections manager CollectionLetterCollectionsManagerAccounts receivable clerk CustInvoiceAccountsReceivableClerkAccounts receivable manager CustInvoiceAccountsReceivableManager MCRTestUserRoleCustomer service manager TradeCustomerServiceManagerCustomer service representative TradeCustomerServiceRepresentativeSales clerk TradeSalesClerkSales manager TradeSalesManagerSales representative TradeSalesRepresentative
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSales manager TradeSalesManagerSales representative TradeSalesRepresentativeAccounts receivable manager CustInvoiceAccountsReceivableManagerSales clerk TradeSalesClerkCustomer service representative TradeCustomerServiceRepresentativeTo use itCollections manager CollectionLetterCollectionsManagerCollections agent CollectionLetterCollectionsAgentGive people one of these roles. On this system, 9 roles can open this page.Checked in Dynamics 365
Actions on the pageOrder: OrderHold checkout: Hold checkoutClear hold: Clear holdOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=MCROMHoldsListPage
Data migrationLoad order: Order holds has no data entity in Data management. No entity in the Common Data Model is built on its table (MCRHoldCodeTrans); holds are working data, so clear or re-create them on the migrated orders. Hold codes load with Sales order hold codes (MCRSalesOrderHoldCodeEntity).Checked in Dynamics 365
Table definitionMCRHoldCodeTrans columns and relations Microsoft data model
Everyone

8Sources

To cite this step: SM-ORD-100, Work the order holds queue. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SM-ORD-100