BeyondERP.Newsletter
Menu

Setup page · Subscription billing

Items

A setup page (titled Item setup) where you link items to default support items, renewal items and milestone templates.

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
SubBillItemSetup
Main table
SubBillItemSetup
Data entity
SubBillItemSetupEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page (titled Item setup) where you link items to default support items, renewal items and milestone templates.
What you do hereUse this page to set up default support and renewal items, and a default milestone template, for an item relation.
ExampleFor example, link item D001 to support item ITEM27 and renewal item D007 in renewal item group IG1.
Items 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.

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

  1. Go to Subscription billing > Recurring contract billing > Setup > Items.
  2. Select New and select the Item relation.
  3. Select the default Support item and Renewal item.
  4. For milestone items, select the default Milestone template.
  5. Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Item relationThe item that the setup line applies to.Microsoft Learn ItemRelation
Milestone templateThe default milestone template for the item.Microsoft Learn SubBillMilestoneTemplateId
Support item / Renewal itemThe default support item and renewal item associated with the item.Microsoft Learn

Common errors and fixes

MessageWhat to do
The renewal start date can't be changedThe renewal start date can be edited only until the first renewal invoice is created and posted. Plan the date on the sales order. Microsoft Learn
Generate invoice skips a milestone lineEach milestone event needs an end date before it can be invoiced. Set it on the line or with Update completion date process. Microsoft Learn

Test checklist

  1. On Item setup link an item relation to a support item and a renewal item.
  2. Create a sales order with the item and select Support and renewal > Add support and renewal; check the support and renewal items default in.
  3. Invoice the sales order and check a billing schedule with the renewal item is created.
  4. For an item with a milestone template, add it to a billing schedule as Item type Milestone and check the milestone events are added automatically.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up ItemsItem 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.Which items get default support, renewal and milestone setup?Expecting to fix a renewal start date later. It can be edited only until the first invoice for the renewal billing schedule is created and posted.Test: Defaults on the sales order

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: Defaults can be changed at any time and apply to lines created afterwards. Renewal lines already created keep their items, and their start date is locked once the first renewal invoice is posted. Microsoft Learn
If you change it laterA 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 itemSubBillItemSetup Checked in Dynamics 365
FormSubBillItemSetup Checked in Dynamics 365
TableSubBillItemSetupShown as “SUBSCRIPTION BILLING ITEM SETUP” in Record infoKey field: ItemRelation, SubBillParentRetailVariantIdChecked in Dynamics 365
Data entitiesSubBillItemSetupEntitySubscription billing item 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=SubBillItemSetup
Integrate withSubBillItemSetupEntity data entity Checked in Dynamics 365
Data migrationSubBillItemSetupEntity (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
Everyone

8Sources