BeyondERP.Newsletter
Menu

Setup step on the Mass hold processing page · Subscription billing

Decide whether a hold cuts the schedule

Pause billing for many contracts with the right effect on their lines.

Business process
Bill subscriptions
Menu item
SubBillMassHoldProcessing
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 periodic task dialog that places several billing schedules on hold, or removes a hold, at the same time.
What you do hereUse this page to apply or remove a hold on many billing schedules in one run, optionally cutting the billing schedule lines off at a hold date.
ExampleFor example, with a hold date of February 10, a February billing line is shortened to February 1 through 9 and later lines are removed.
Mass hold processing 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.

When to run it

When to run itWhen many subscriptions must be paused, for example during a service interruption or a customer dispute, or resumed afterwards.
How oftenOn demand, when a group of billing schedules must be put on hold or released.
What the output showsBilling schedules with status On hold, and with Adjust schedule Yes the lines after the hold date removed and the last period prorated daily (for example 1 to 9 February). After a removal the billing resumes from the Resumption date.

Source: Microsoft Learn

Setup steps on this page

Decide whether a hold cuts the schedule

Pause billing for many contracts with the right effect on their lines.

Steps from Microsoft

  1. Go to Subscription billing > Recurring contract billing > Periodic tasks > Mass hold processing.
  2. Set Process option to Apply hold or Remove hold and select a Reason code.
  3. For Apply hold, set Adjust schedule: Yes removes billing schedule lines after the Hold date you enter; No only changes the status to On hold. For Remove hold, enter the Remove date, Resumption date and Deferral date.
  4. Filter the billing schedules on Records to include, select View preview, mark schedules to leave out and select Remove, then select OK.
  5. Open All billing schedules and confirm that the status is On hold, or active again after a removal.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Process optionChooses whether the run applies a hold or removes a hold.Microsoft Learn Apply hold
Reason codeThe reason code recorded for the hold or its removal.Microsoft Learn
Adjust scheduleYes removes billing schedule lines after the hold date; No only changes the status to On hold.Microsoft Learn Yes
Hold dateThe date after which billing schedule lines are removed when Adjust schedule is Yes.Microsoft Learn 10 February
Remove dateThe date when the hold is removed.Microsoft Learn
Resumption dateThe date billing resumes when a hold is removed.Microsoft Learn
Deferral dateThe deferral date used for all deferrable lines when a hold is removed.Microsoft Learn

Common errors and fixes

MessageWhat to do
A user can't remove a holdRemoving a hold needs a user group with Allow remove hold. Set it in Remove hold user group override on Recurring contract billing parameters and add the user to the group. Microsoft Learn
Terminate isn't available for a billing scheduleOnly Active billing schedules and lines can be terminated. Remove the hold first, then terminate. Microsoft Learn

Test checklist

  1. The selected billing schedules have status On hold.
  2. With Adjust schedule Yes, no lines remain after the Hold date.
  3. After Remove hold, the billing periods restart on the Remove date.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Decide whether a hold cuts the scheduleAdjust schedule = Yes with a hold date when the service stops, so lines after the hold date are removed and the period is prorated; No when only a status flag is needed.With Yes a 200.00 February line held on 10 February becomes 1 to 9 February at 64.29 and later lines are removed; No changes only the status.Should holds adjust the billing schedule?Holding with Adjust schedule = No and expecting billing to stop; or removing a hold without the Remove hold user group override set up.Test: Hold prorates the period

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 run this task.

Microsoft Learn

Solution architect

5Design impact

Can it be undoneReversible: Remove hold restores billing from the Remove date; the user needs the Remove hold user group override.
If you change it laterApplying a hold sets the billing schedules to On hold, and with Adjust schedule set to Yes it removes the billing schedule lines after the hold date. Microsoft Learn
Technical architect

6Technical

Menu itemSubBillMassHoldProcessing Checked in Dynamics 365
FormSubBillMassHoldProcessing Checked in Dynamics 365
Roles to set it up and use itTo use itSubscription billing manager SubBillBillingMaintainSubscription billing allocation, deferral, and billing manager SubBillMaintainGive people one of these roles. On this system, 2 roles can run this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SubBillMassHoldProcessing
Data migrationLoad order: Mass hold processing has no data entity in Data management, so there is nothing to load from a file or a configuration template. To bring holds over, load the billing schedules and place holds with the Subscription billing schedule line place hold entity or this task.Microsoft Learn
Everyone

8Sources

To cite this step: SB-PER-050, Decide whether a hold cuts the schedule. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SB-PER-050