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
Go to Subscription billing > Recurring contract billing > Setup > Item group setup.
Select New and select the item group.
Select Prorate support and renewal and Adjust renewal dates as needed.
Enter Number of top lines, or 0 when the group's items use unbilled revenue.
Whether the support or renewal amount for items in the group is prorated based on the dates.Microsoft Learn
SubBillProration
Adjust renewal dates
Whether the renewal start and end dates are updated from the alignment date for the group.Microsoft Learn
SubBillAdjustDates
Number of top lines
How many of the most expensive items in the group are charged on an invoice; zero means top billing isn't used.Microsoft Learn
2
SubBillNumberTopLines
Common errors and fixes
Message
What to do
Unbilled revenue doesn't reconcile with the invoices after top billing
Top 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 invoice
Consolidate by item is set to No when any item group has Number of top lines above 0. Microsoft Learn
Test checklist
For an item group without unbilled revenue, set Number of top lines to 2.
Add three items of that group with different prices to a billing schedule.
Generate the invoice and check only the two most expensive items are charged.
For a group with Prorate support and renewal selected, add a renewal item mid-period and check the amount is prorated.
Number 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 on
Subscription billing (Must be on)Recurring contract billing (Must be on)
Licence or add-in
Turn 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.
Reversible: The values can be changed; they affect invoices generated and renewal dates set after the change.
If you change it later
Setting 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 item
SubBillItemGroupSetupChecked in Dynamics 365
Form
SubBillItemGroupSetupChecked in Dynamics 365
Table
SubBillItemGroupSetupShown as “SUBSCRIPTION BILLING ITEM GROUP SETUP” in Record infoKey field: ItemGroupIdChecked in Dynamics 365
Data entities
SubBillItemGroupSetupEntitySubscription billing item group setup Checked in Dynamics 365
Who can open it
PrivilegesSubscription 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 SubBillMaintain4 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 SubBillViewChecked in Dynamics 365
Roles to set it up and use it
To 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
SubBillItemGroupSetupEntity data entity Checked in Dynamics 365
Data migration
SubBillItemGroupSetupEntity (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