BeyondERP.Newsletter
Menu

Setup step on the Milestone templates page · Subscription billing

Set up Milestone templates

Use this page to create templates that you assign to billing schedule items that use milestone billing.

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
SubBillMilestoneTemplate
Main table
SubBillMilestoneTemplate
Data entity
SubBillMilestoneTemplateHeaderEntity
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 define milestone templates whose lines split an amount across milestone items by percentage or amount.
What you do hereUse this page to create templates that you assign to billing schedule items that use milestone billing.
ExampleFor example, BEAT sets up an implementation template with Percentage: Design 30, Build 50 and Go-live 20, totalling 100, and assigns it to the Milestone billing schedule group.
Milestone templates 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 Milestone templates

Use this page to create templates that you assign to billing schedule items that use milestone billing.

Steps from Microsoft

  1. Go to Subscription billing > Recurring contract billing > Setup > Milestone templates.
  2. Select New.
  3. Enter a unique identifier in the Milestone template field, and enter a description.
  4. Select an allocation method and, optionally, enter the total amount.
  5. Select Add, and select the item number for each line.
  6. Enter the percentage or amount for each line, depending on the allocation method.
  7. Select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Milestone templateThe unique identifier of the template.Microsoft Learn SubBillMilestoneTemplateId
DescriptionA description of the template.Microsoft Learn SubBillMilestoneTemplateDescription
Allocation methodHow the amount is allocated to the lines: percentage of completion, percentage, variable amount or equal amount.Microsoft Learn SubBillAllocationMethod
Total amountThe milestone amount for the whole template.Microsoft Learn
Item numberThe milestone item on the template line.Microsoft Learn ItemId
PercentageThe allocation percentage for the line; all lines must add up to 100.Microsoft Learn SubBillPercentage
AmountThe allocation amount for the line.Microsoft Learn SubBillTemplateLineAmount
Remaining amountThe header total amount minus the sum of the line amounts.Microsoft Learn

Common errors and fixes

MessageWhat to do
A milestone template can't be savedWith Percentage, the line percentages must total 100; with a Total amount, the line amounts must leave a Remaining amount of 0. 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
A milestone line can't be invoiced although its end date is setMilestone lines need a Site and Warehouse under Line details > Product > Storage dimensions. Microsoft Learn

Test checklist

  1. Create a Percentage template with three items totalling 100 and check Total percentage is 100.
  2. Create a billing schedule group with Item type Milestone and this template.
  3. Add a Milestone line to a billing schedule and check the milestone events are added with blank end dates.
  4. Set an end date on one milestone event and select Generate invoice; check only that milestone is invoiced.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Milestone templatesOne template per billing pattern, using Percentage for fixed splits and Percentage of completion where progress is reported, and set as default on the group or item only when it always applies.The allocation method decides how the amount is split, and a default template adds the milestone events to new lines automatically.Which allocation method should the milestone template use?Saving a Percentage template whose lines don't total 100, or a template with a Total amount whose line amounts leave a Remaining amount; the totals must balance.Test: Percentage template totals 100

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: Templates can be edited or deleted. They default the lines in Milestone allocation, where you can still change them per billing schedule line.
If you change it laterWhen a total amount is set on the template, changing a line percentage recalculates its amount, and changing the amount recalculates the percentage. Microsoft Learn
Technical architect

6Technical

Menu itemSubBillMilestoneTemplate Checked in Dynamics 365
FormSubBillMilestoneTemplates Checked in Dynamics 365
TableSubBillMilestoneTemplateShown as “SUBSCRIPTION BILLING MILESTONE TEMPLATE HEADER” in Record infoKey field: SubBillMilestoneTemplateIdChecked in Dynamics 365
Data entitiesSubBillMilestoneTemplateHeaderEntitySubscription billing milestone template header 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=SubBillMilestoneTemplate
Integrate withSubBillMilestoneTemplateHeaderEntity data entity Checked in Dynamics 365
Data migrationSubBillMilestoneTemplateHeaderEntity (Subscription billing milestone template header): the template headers.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 productsMicrosoft Learn
Everyone

8Sources

To cite this step: SB-SETUP-080, Set up Milestone templates. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SB-SETUP-080