Skip to content
Bitta Apps

Chapter 3 of 8Page 2 of 6

Change subscriptions

Hold and resume

Pause subscriptions from a date with an optional resume date and a reason, credit the days already billed, restart billing on resume, or reverse a started hold.

updated: applies-to: 1.3.5.0

A hold pauses subscriptions from a date, optionally until a resume date. Nothing is billed during the hold. Days already billed inside the hold are credited, and billing restarts on the resume date, automatically or when you resume by hand.

Use it when a customer pauses, for example a seasonal business that stops until January, or a customer who has asked to suspend service while a dispute is settled.

Before you start

  • You have the Bitta Subscriptions - User permission set and a licensed seat. Resuming a hold needs no seat.
  • The daily tasks are scheduled (see Get started), so holds resume on their own.

To place a hold

  1. Open the customer contract, the Customer Contracts list or the subscription, and choose Hold (in the Lifecycle group). A locked contract is refused at once, before the wizard opens (see Approvals and the contract lock).

  2. Pause the subscriptions. Enter:

    • Hold From: the first day without service.
    • Resume On: the day billing restarts. Leave it blank for a hold that lasts until you resume it.
    • Reason Code (optional).
    • Extend Term: moves the end of the term by the length of the hold. The default comes from the setup.

    A date that cannot work is refused as soon as you enter it: a Resume On that is not after Hold From, a subscription that is already on another hold, or a line that starts during the hold and was never billed.

  3. Choose the subscriptions. Select Include for each subscription to hold. Add-ons of an included plan and its promotions are included with it. Opened from a subscription, only that subscription is selected.

  4. Review the hold. Check the Estimated Credit and the Lines on Hold, with the billed-to date and the credit period of each line. Each line is named by its plan or add-on (for example Cloud Suite Pro), with the Serial No. of the device in its own column. Next checks everything that Finish checks, so a hold that cannot be placed is refused before the review.

  5. Choose Finish.

Place Hold wizard with the hold start date, the resume date and the reason code
Place Hold review step with the estimated credit and the lines on hold Review the credit for billed days before you finish. The contract and the subscription show the hold in Lifecycle Status, and the contract lines show it in the Hold column.

To resume a hold

A hold with a Resume On date resumes on that date through the daily task. To resume earlier or later, or to resume an open-ended hold:

  1. Open the contract or the subscription, and choose Resume. It is enabled only while a hold is active. You can also choose Resume on the Subscription Holds list or the hold card.
  2. Enter the Resume Date, and then choose OK.
Resume Hold dialog with the date on which billing restarts

To cancel a hold

A hold that has not started yet (Hold From is after today and nothing was credited) can be canceled. Open the hold, and choose Cancel Hold. The lines get their original end dates and terms back.

To reverse a hold that has started

When a hold was placed by mistake, or the customer used the service after all, you can undo it after it has started. Open the hold (on the Subscription Holds list or from the contract's Holds), and choose Reverse Hold. It applies to an active hold that Cancel Hold cannot undo any more: it has started, or it credited billed days.

  1. Business Central checks the hold first and lists every problem at once, each with a way to fix it:
    • a credit of the hold that waits in a billing proposal (open Recurring Billing and delete its billing lines) or on an unposted invoice or credit memo (post or delete the document);
    • a line whose end date changed after the hold;
    • a promotion that the hold removed because it had not started (resume the hold instead).
  2. Confirm. If a hold approval workflow applies to the contract, an approval request is sent instead, and the hold is reversed when the request is approved and applied.

What the reversal does:

  • Each held line gets back its end date, term and renewal term, so Microsoft bills the days on hold from the line's next billing date, as if the hold had never been placed.
  • A credit for billed days that was never billed is deleted. A credit that was already billed or invoiced is charged again with a charge line for the same days.
  • A line that Microsoft closed after its end date (it was fully billed) continues on a new line from the day after its last billed day.
  • Lines that a termination ended stay ended. The hold gets the status Reversed, with the date and user in Reversed Date and Reversed By (under Show more).

A locked contract refuses the reversal until it is unlocked. The holds API reverses a hold too (holds({id})/Microsoft.NAV.reverse, refused when the reversal needs approval).

A reversed hold in reports and the API

A reversed hold paused nothing, so the reports treat it like a canceled hold:

  • Contract Lifecycle Log: one event Hold reversed on the day it was reversed, no Hold placed.
  • Hold Register: the outcome Reversed with the date; the hold is listed in the period it was placed or reversed.
  • Hold Summary: counted under Canceled or reversed, with no days on hold, no paused MRR and no credit.
  • Hold Confirmation: not printed or sent for a reversed hold, as for a canceled one.
  • Subscription Customer Aging: a reversed hold never flags the contract On Hold.
  • The holds API returns status Reversed with reversedDate and reversedBy.

What happens in Microsoft Subscription Billing

  • Each held line ends the day before Hold From, or at the end of the billed period if that is later (Microsoft does not accept an earlier end date for billed days).
  • Billed days inside the hold get a credit line that Microsoft bills with the next invoice.
  • On resume, each held line continues on a new subscription line from the resume date, with its original end date and terms (moved by the hold length when Extend Term is on). Microsoft bills the new line as usual.
  • Resuming earlier than planned charges back the days that were credited but now have service; resuming later than planned, inside a billed period, credits the extra days.
  • A term that ended during the hold does not continue.
  • Promotions on held lines end with the hold and do not resume.

Limits

  • Usage-based lines are not put on hold.
  • A line that starts during the hold and was never billed is refused, with the dates that work. Unstarted promotions are removed.
  • Lines in an open billing proposal or on an unposted document are refused until the proposal or document is gone.
  • A subscription with an open or scheduled amendment cannot be held until the amendment is applied or canceled.
  • Holding a very large contract at once is slower than the 10-second target: about 18 s to preview and 24 s to finish for 2,400 lines in our volume test.

See also

Next step

Ready to try Bitta Subscriptions?