BeyondERP.Newsletter
Menu

Setup step on the Item group setup page · Subscription billing

Set up Item group setup

Use this page to define item groups for support and renewal proration, alignment dates for renewal items and the top billing functionality.

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
SubBillItemGroupSetup
Main table
SubBillItemGroupSetup
Data entity
SubBillItemGroupSetupEntity
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 setup page where you set, for each item group, support and renewal proration, renewal date alignment and top billing.
What you do hereUse this page to define item groups for support and renewal proration, alignment dates for renewal items and the top billing functionality.
ExampleFor example, set Number of top lines to 2 for item group A so that only the two most expensive items in that group are charged on the invoice.
Item group setup 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 accounts receivable › Bill subscriptions
Menu pathSubscription billing › Recurring contract billing › Setup › Item group setup
Set up firstRecurring contract billing parameters Microsoft Learn
Used next byGenerate invoice Microsoft Learn
Related pagesUnbilled revenue setup Microsoft Learn
In this process Set up Milestone templates · Set up Hold reason 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

Set up Item group setup

Use this page to define item groups for support and renewal proration, alignment dates for renewal items and the top billing functionality.

Steps from Microsoft

  1. Go to Subscription billing > Recurring contract billing > Setup > Item group setup.
  2. Select New and select the item group.
  3. Select Prorate support and renewal and Adjust renewal dates as needed.
  4. Enter Number of top lines, or 0 when the group's items use unbilled revenue.
  5. Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Prorate support and renewalWhether the support or renewal amount for items in the group is prorated based on the dates.Microsoft Learn SubBillProration
Adjust renewal datesWhether the renewal start and end dates are updated from the alignment date for the group.Microsoft Learn SubBillAdjustDates
Number of top linesHow many of the most expensive items in the group are charged on an invoice; zero means top billing isn't used.Microsoft Learn 2SubBillNumberTopLines

Common errors and fixes

MessageWhat to do
Unbilled revenue doesn't reconcile with the invoices after top billingTop billing and unbilled revenue don't work together. Set Number of top lines to 0 on every item group that has unbilled revenue items. Microsoft Learn
Consolidate by item is switched off on Generate invoiceConsolidate by item is set to No when any item group has Number of top lines above 0. Microsoft Learn

Test checklist

  1. For an item group without unbilled revenue, set Number of top lines to 2.
  2. Add three items of that group with different prices to a billing schedule.
  3. Generate the invoice and check only the two most expensive items are charged.
  4. For a group with Prorate support and renewal selected, add a renewal item mid-period and check the amount is prorated.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Item group setupNumber of top lines = 0 for every item group when you use unbilled revenueTop billing and unbilled revenue don't work together; Learn says to leave the page blank or set Number of top lines to 0 if you use unbilled revenue.Is top billing used?Setting Number of top lines above zero for a group whose items use unbilled revenue. Invoices then bill only the top lines while the initial entry covered all items, which causes reconciliation problems.Test: Top two lines billed

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

Can it be undoneReversible: The values can be changed; they affect invoices generated and renewal dates set after the change.
If you change it laterSetting Number of top lines above zero turns on top billing for the group, and top billing can't be used together with unbilled revenue. Microsoft Learn
Technical architect

6Technical

Menu itemSubBillItemGroupSetup Checked in Dynamics 365
FormSubBillItemGroupSetup Checked in Dynamics 365
TableSubBillItemGroupSetupShown as “SUBSCRIPTION BILLING ITEM GROUP SETUP” in Record infoKey field: ItemGroupIdChecked in Dynamics 365
Data entitiesSubBillItemGroupSetupEntitySubscription billing item group setup Checked in Dynamics 365
Who can open itPrivilegesSubscription billing manager SubBillBillingMaintainMaintain Subscription billing billing setup SubBillBillingSetupMaintainView Subscription billing billing setup SubBillBillingSetupViewSubscription billing user SubBillBillingViewSubscription billing allocation, deferral, and billing manager SubBillMaintainSubscription billing module user with capabilities including billing, allocation, and deferral features SubBillViewDutiesSubscription 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=SubBillItemGroupSetup
Integrate withSubBillItemGroupSetupEntity data entity Checked in Dynamics 365
Data migrationSubBillItemGroupSetupEntity (Subscription billing item group setup): one row per item group.Load order: Load the setup in reference order: support and renewal levels, milestone templates and consumer price index schedules first; then billing schedule groups (a group can name a milestone template), item setup, item group setup, revenue split templates and unbilled revenue setup (they name items, templates and main accounts); then Recurring contract billing parameters, which name the default billing schedule group and support and renewal level; billing schedules come last.Load first: Item groupsMicrosoft Learn
Everyone

8Sources

To cite this step: SB-SETUP-090, Set up Item group setup. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SB-SETUP-090