BeyondERP.Newsletter
Menu

Setup page · Sales and marketing

Order hold codes

A setup page where you create the hold codes that give the reason a sales order is put on hold.

Used by
Sales manager
Business process
Manage sales order holds
Menu item
MCRHoldCodeTable
Main table
MCRHoldCodeTable
Data entity
MCRSalesOrderHoldCodeEntity
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 setup page where you create the hold codes that give the reason a sales order is put on hold.
What you do hereUse this page to set up each type of hold, who can remove it, and whether it removes inventory reservations.
ExampleBEAT creates hold code CREDIT with Role = Collections manager and Remove inventory reservations = No. When order SO-001234 for 12,500.00 needs a credit review, the order desk adds the CREDIT hold; the order can't be picked or packed until a user with the Collections manager role clears the hold, and its stock stays reserved meanwhile.
Order hold codes 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 Order hold codes1 screen

Use this page to set up each type of hold, who can remove it, and whether it removes inventory reservations.

  1. Screen 1

    Create an order hold code

    Go to Sales and marketing > Setup > Sales orders > Order hold codes

    1. Select New
    2. Enter the hold code and description
    3. Optionally select the role that can remove the hold
    4. Set Default for sales order and Remove inventory reservations as needed
    5. Select Save
    1Hold codeBEAT-HOLD
    2DescriptionOrder hold
    3Default for sales orderNo
    4Remove inventory reservationsNo
    Create an order hold code (zoomed on the outlined fields)
    Show the full screenCreate an order hold code
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to Sales and marketing > Setup > Sales orders > Order hold codes.
  2. Select New, or select Edit and choose an existing hold code.
  3. In the Hold code field, enter a short name, for example Call back.
  4. In the Description field, enter a short description.
  5. In the Role field, select the security role a user needs to remove this hold.
  6. Select Default for sales order or Remove inventory reservations if needed.
  7. Select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Hold codeA short name for the hold code.Microsoft Learn CREDITMCRHoldCode
DescriptionMore information about the hold code.Microsoft Learn Order holdMCRHoldCodeDescription
RoleThe security role a user must have to remove this hold code from an order.Microsoft Learn Name
Default for sales orderMakes this hold code the default each time a user adds a new hold.Microsoft Learn NoMCRDefaultSOHoldCode
Remove inventory reservationsRemoves physical reservations from an order when this hold code is added.Microsoft Learn NoMCRUnReserve
Hold code colorThe color shown for the hold code.Microsoft Learn

Common errors and fixes

MessageWhat to do
Picking list and packing slip buttons are unavailable on a sales orderThe order has a hold (Do not process is selected). Clear the hold with Clear holds, by a user who has the role set on the hold code. Microsoft Learn
Stock reserved for an order is gone after a holdThe hold code has Remove inventory reservations selected, which removes physical reservations when the hold is added. Reserve again after clearing the hold, and clear the option on codes used for short holds. Microsoft Learn

Test checklist

  1. Create a hold code with a Role and Remove inventory reservations set to Yes.
  2. Reserve stock on a sales order, then add the hold through Sales order > Functions > Order holds.
  3. Check that All sales orders shows a check mark in Do not process and a pause symbol in Hold, and that picking list and packing slip buttons on the Pick and pack tab are disabled.
  4. Check that the physical reservation on the order line was removed.
  5. Sign in as a user without the selected role and confirm the hold can't be cleared; then clear it with Clear holds as a user with the role.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Order hold codesOne hold code per hold reason (for example credit review, address check, customer callback), each with Role set to the security role that is allowed to clear itHold codes exist so you can set up each type of hold you apply to sales orders, and the Role field limits who can remove that hold from an order, so the right team owns each release.Should a hold code remove inventory reservations?Selecting Remove inventory reservations on a code used for short, routine holds. Every time that code is added, the order's physical reservations are removed, so the stock is no longer held for that order.Test: Order hold blocks warehouse processing

Feature management and licence

Licence or add-inOn the live system, Sales manager 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: You can edit hold codes at any time. The settings apply when a hold is added to an order, so changes affect new holds. Reservations already removed by an earlier hold aren't put back by editing the code. Microsoft Learn
If you change it laterAn order with a hold can't be picked, packed or processed further until the hold is cleared. Microsoft Learn
Technical architect

6Technical

Menu itemMCRHoldCodeTable Checked in Dynamics 365
FormMCRHoldCodeTable Checked in Dynamics 365
TableMCRHoldCodeTableShown as “Hold code” in Record infoKey field: MCRHoldCode, MCRHoldCodeDescriptionChecked in Dynamics 365
Data entitiesMCRSalesOrderHoldCodeEntitySales order hold codes Microsoft data model
Who can open itPrivilegesMaintain order hold codes MCRHoldCodeTableMaintainDutiesEnable sales order hold process MCRSalesHoldProcessEnable
1 security roleSales manager TradeSalesManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSales manager TradeSalesManagerGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=MCRHoldCodeTable
Integrate withMCRSalesOrderHoldCodeEntity data entity Microsoft data model
Data migrationMCRSalesOrderHoldCodeEntity (Sales order hold codes): loaded for each company, in Microsoft's default template 330 - Sales and marketing.Load order: Microsoft's default template 330 - Sales and marketing loads Sales order hold codes at execution unit 1, level 40, sequence 10. Lower levels load first, and entities at the same level load in sequence order.Load first: the default templates at lower levels (System setup to dependency bands 30 to 90)Microsoft Learn
Table definitionMCRHoldCodeTable columns and relations Microsoft data model
Everyone

8Sources