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 Items
Use this page to set up default support and renewal items, and a default milestone template, for an item relation.
Steps from Microsoft
Go to Subscription billing > Recurring contract billing > Setup > Items.
Select New and select the Item relation.
Select the default Support item and Renewal item.
For milestone items, select the default Milestone template.
Item setup rows only for items that need a default support item, renewal item or milestone template; choose them on the sales order or in Milestone allocation for the restLearn says Item setup is required only if you want default support and renewal items, and a default milestone template makes its events appear automatically on milestone billing schedule lines.
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: Item setup rows are defaults copied when sales order lines or billing schedule lines are created; changing them doesn't change existing billing schedules.
If you change it later
A default milestone template on an item makes its milestone events appear automatically on billing schedule lines for that item. Microsoft Learn
Technical architect
6Technical
Menu item
SubBillItemSetupChecked in Dynamics 365
Form
SubBillItemSetupChecked in Dynamics 365
Table
SubBillItemSetupShown as “SUBSCRIPTION BILLING ITEM SETUP” in Record infoKey field: ItemRelation, SubBillParentRetailVariantIdChecked in Dynamics 365
Data entities
SubBillItemSetupEntitySubscription billing item 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
Developer
7Developer
Open it by URL
https://<your-environment>/?mi=SubBillItemSetup
Integrate with
SubBillItemSetupEntity data entity Checked in Dynamics 365
Data migration
SubBillItemSetupEntity (Subscription billing item setup): one row per item relation.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: Released products, Milestone templatesMicrosoft Learn