BeyondERP.Newsletter
Menu

Setup page · Subscription billing

Hold reason codes

A setup page where you maintain the reason codes that you select when you put billing schedules on hold or remove a hold.

Used by
Subscription billing manager, Subscription billing user, Subscription billing allocation, deferral, and billing manager and 1 more role
Business process
Bill subscriptions
Menu item
SubBillHoldCode
Main table
ReasonTable
Data entity
None for this page's own settings
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 maintain the reason codes that you select when you put billing schedules on hold or remove a hold.
What you do hereUse this page to keep the list of reasons that the hold and remove-hold processes ask for.
ExampleFor example, BEAT creates BEAT-HOLD with the Hold check box selected and uses it when a customer disputes an invoice.
Hold reason 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.

Setup steps on this page

Set up Hold reason codes

Use this page to keep the list of reasons that the hold and remove-hold processes ask for.

How to use it

  1. Go to Subscription billing > Recurring contract billing > Setup > Hold reason codes.
  2. Select New and enter the Reason code and a Default comment.
  3. Select the Hold check box so the code is marked for holds on billing schedules.
  4. Save. The code is in the shared Reasons table, so other modules' columns can be set on the same code.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it meansExample
Reason codeThe code users select.Checked in Dynamics 365BEAT-HOLD
Default commentThe text that defaults with the code.Checked in Dynamics 365
HoldMarks the code for holds on billing schedules.Checked in Dynamics 365Yes

Common errors and fixes

MessageWhat to do
The new reason code isn't offered in the dialogThis menu item opens the shared Reasons page. Select the module's check box on the code (for example Hold or Termination) to mark it for that use. Checked in Dynamics 365

Test checklist

  1. Create a code with the Hold check box selected.
  2. Filter the page on the Hold column.
  3. Use the code for holds on billing schedules.
  4. Check the reason is recorded with the change.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Hold reason codesA short list of hold reasons (for example customer dispute, service outage) with the Hold check box selected.Mass hold processing and Place hold ask for a reason code, and the reason is kept on the schedule's Hold tab.Which reasons are recorded for holds?Setting up reason codes but not the Remove hold user group override on Recurring contract billing parameters; users then can't remove holds.Test: Hold with a new reason

Feature management and licence

Feature to turn onSubscription billing (Must be on)Recurring contract billing (Must be on)
Licence or add-inTurn off the Revenue recognition feature first: Subscription billing can't be used while it is on. Then, in Feature management, turn on Subscription billing and after it Recurring contract billing. Revenue recognition was deprecated in January 2024 and replaced by Subscription billing. Subscription billing managers maintain this setup; Subscription billing users can view it.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneReversible: Codes and check boxes can be changed at any time; reasons already recorded stay on the history. Checked in Dynamics 365
If you change it laterThe code is a row in the shared Reasons table; the Hold check box decides that it is used for holds on billing schedules. Renaming or clearing it affects only later selections; recorded reasons stay on the history. Checked in Dynamics 365
Technical architect

6Technical

Menu itemSubBillHoldCode Checked in Dynamics 365
FormReasons Checked in Dynamics 365
TableReasonTableShown as “REASONS” in Record infoChecked in Dynamics 365
Data entitiesLedgerFinancialReasonEntityFinancial reasons (the shared reason codes and default comments of the Reasons table) Microsoft data model
Who can open itPrivilegesSubscription billing manager SubBillBillingMaintainSubscription billing user SubBillBillingViewDutiesSubscription billing user SubBillBillingInquireSubscription billing manager SubBillBillingMaintainSubscription billing module user with capabilities including billing, allocation, and deferral features SubBillInquireSubscription billing allocation, deferral, and billing manager SubBillMaintain
4 security rolesSubscription billing manager SubBillBillingMaintainSubscription billing user SubBillBillingViewSubscription billing allocation, deferral, and billing manager SubBillMaintainSubscription billing module user with capabilities including billing, allocation, and deferral features SubBillView
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSubscription billing manager SubBillBillingMaintainSubscription billing allocation, deferral, and billing manager SubBillMaintainTo use itSubscription billing user SubBillBillingViewSubscription billing module user with capabilities including billing, allocation, and deferral features SubBillViewGive people one of these roles. On this system, 4 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SubBillHoldCode
Data migrationLedgerFinancialReasonEntity (Financial reasons): the shared reason codes, loaded for each company in Microsoft's default template 025 - General ledger.Load order: Load reason codes with the General ledger setup, before billing schedules. Then check the Hold check box on the codes Subscription billing uses.Load first: Legal entitiesMicrosoft Learn
Table definitionReasonTable columns and relations Microsoft data model
Everyone

8Sources