Service Milestones and Milestone-based Billing

service milestones and milestone based billing are pivotal components in project based services and professional services, where payment is intricately linked to specific project milestones or achievements, rather than relying solely on time or material based billing methods within nue, products under the one time revenue model are typically billed as one time charges however, nue allows users to define two or more service milestones for these one time products and services these service milestones serve a dual purpose, functioning both as billing schedules and as milestones for fulfillment and provisioning this tutorial will guide you through the process of creating service milestones within a quote or an order for one time services or products we will also provide practical examples to illustrate how these service milestones play a vital role in the billing process, offering a comprehensive understanding of their significance let's get started! the products and pricing used in this tutorial are fictional they are for demo purposes only overview in the context of nue products with a one time revenue model, we're introducing the concept of 'milestones' to support milestone based billing typically, a quote line item or order product with a one time revenue model is billed based on a single start date, be it in advance or in arrears with service milestones, a one time revenue model item can now be divided into multiple milestones, each carrying its own unique start date these milestones are defined by key attributes such as the milestone date (essentially the start date) , quantity , percentage of total , and price as a result, each split line item will contain these milestone attributes, allowing for more precise and flexible billing, aligning with the specific characteristics of your products or services we also call these split line items milestone lines a milestone line is a split child line of a quote line item or an order product it's essentially a quote line item or an order product on its own, but it goes by the line type 'ramp' (rampitem) just like the original line item with a one time revenue model, a milestone line doesn't have an end date, and its start date is the milestone date this start date does double duty, handling fulfillment or provisioning and the billing schedule one thing to note is that the total price and quantity for all milestone lines must add up to match the total price and quantity of the original line item data model a new field 'milestone' is introduced on both quote line item and order product to store the milestone information this field is only available in salesforce, not in nue name data type api name description milestones long text area(32000) ruby milestones c if the line type is summary line, this field contains a json representation of the definition of all service milestones if the line type is ramp, this field contains the name of the milestone the following is an example of the json representation of all service milestones for a summary line (i e , the original line item containing the milestones) \[ { "id" "0ql8g0000007brswae", "name" "installment # 1", "quantity" 10, "actualquantity" 10, "price" 1440, "startdate" "2023 12 04", "subscriptionstartdate" "2023 12 04", "percentage" 10, "ismilestonenamemodifiedbyuser" false, "parentid" "0ql8g0000007brrwae", "rootid" "0ql8g0000007brrwae", "totalprice" 1440 }, { "id" "0ql8g0000007brtwae", "name" "installment # 2", "quantity" 20, "actualquantity" 20, "price" 2880, "startdate" "2024 01 04", "subscriptionstartdate" "2024 01 04", "percentage" 20, "ismilestonenamemodifiedbyuser" false, "parentid" "0ql8g0000007brrwae", "rootid" "0ql8g0000007brrwae", "totalprice" 2880 }, { "id" "0ql8g0000007bruwae", "name" "installment # 3", "quantity" 70, "actualquantity" 70, "price" 10080, "startdate" "2024 02 04", "subscriptionstartdate" "2024 02 04", "percentage" 70, "ismilestonenamemodifiedbyuser" false, "parentid" "0ql8g0000007brrwae", "rootid" "0ql8g0000007brrwae", "totalprice" 10080 } ] scenarios now let's look at some scenarios scenario in our fictitious scenario, smart revenue inc is interested in purchasing 10 user licenses of a 2 year subscription to the quote builder product, alongside an additional 50 hours of implementation services their unique requirement involves breaking down these 100 hours of implementation services into three phases requirement collection , implementation , and uat (user acceptance testing) with service acceptance each phase has a different commitment date they wish to establish a payment schedule that aligns with each phase's commencement specifically, they propose paying 20% at the beginning of requirement collection, 30% at the start of implementation, and the remaining 50% at the initiation of uat and service acceptance it's important to note that the percentages for each phase's payment don't necessarily mirror the actual distribution of service hours among these phases to implement this scenario, the sales rep has added quote builder as well as the add on product implementation services into the line editor she sets the subscription term to be 24 months (or 2 years) she also sets the quantity of quote builder to 10, and the quantity of implementation services to 50 the sales rep then clicks on the 'milestone' icon in the action column of the implementation services line, as shown in the below image create milestones upon clicking on the icon, the milestone popup launches she can click 'new milestone' button 3 times to quickly add 3 milestones, each representing an individual phase within the milestones popup, users have the flexibility to make several adjustments, including adding or deleting milestones customizing milestone names, which by default are set as 'milestone #{milestonenumber}' for instance, 'milestone #1', 'milestone #2', and so forth fine tuning the milestone date, percentage, quantity and total price for each milestone notably, when changes are made to the percentage of a milestone, the total price and quantity will be automatically recalculated based on the adjusted percentage, and the reverse holds true as well in addition, users have the ability to modify the quantity allocation to differ from the system's automatic allocation, providing further control over the billing and allocation process allocate milestones evenly users are provided with the choice to evenly distribute all milestones, including quantities and total prices when the user clicks 'allocate evenly' button, the following actions take place for each existing milestone displayed in the user interface the milestone date is automatically populated, starting from the parent line's start date and progressing in monthly intervals the quantity is evenly divided from the parent line's quantity, with precision to two decimal places for instance, if the parent quantity is 1, and there are three milestone items, it will be distributed as 0 33, 0 33, 0 34 similarly, the percentage is evenly divided, also with two decimal places with three milestone items, the percentage allocation will be 33 33%, 33 33%, and 33 34% the price is calculated based on the total price multiplied by the evenly distributed percentage these automatically generated values will override any user entered values, if applicable add milestones to quote or order after you've set up the milestones and you're satisfied with their allocation, a simple click on 'confirm' will add these milestone lines to your quote or order, as illustrated in the image below it's worth noting that each implementation service contains three milestone lines, each with their own configured quantity and total price keep in mind that the net sales price and discount % for each milestone line may vary because of the different quantity allocations, which could differ from the total price allocation additionally, the image showcases that quote builder is billed on an annual basis, while the implementation service is billed monthly the milestone billing schedule aligns with factors such as the billing cycle day, billing period, and billing timing, as configured for the account and the product for instance, if the billing cycle day falls on the 1st of each month, and the milestone dates are set at 12/05/2023, 01/05/2024, and 02/05/2024, considering a monthly billing period and in advance billing timing, the milestone amounts will be billed on 12/01/2023, 01/01/2024, and 02/01/2024, respectively after all the details of the quote or the order are finalized, the user can either close won the opportunity, which automatically finalizes and activates the primary quote of the order, or manually activate the order after the order is activated, the line item implementation services will be provisioned into an entitlement users can view the entitlement with quantity 50 hours in the lifecycle manager please note users can create milestones for any line item with a one time revenue model, including products of physical assets, customer support, or any custom product categories add milestones to change quote or order scenario as we near the end of the implementation cycle, smart revenue finds that they can cut back on 10 hours of implementation service due to the project needing fewer hours than originally anticipated the sales rep is on board with this adjustment, but they also engage in a negotiation regarding a refund plan the agreement is to provide a 50% refund on 01/01/2024 and the remaining 50% on 02/01/2024 for the 10 hours of services that were reduced to implement this scenario, as usual, the sales rep navigates to the lifecycle manager, and clicks on the entitlements tab she clicks on 'update quantity' and reduces 10 hours starting 01/01/2024 she clicks 'confirm' to add the change request to the change cart, and then checks out the change requests in the change cart to a quote or an order in the change order, the sales rep can view the original milestones, and can create new milestones for the reduced quantities in the image below, the user creates 2 additional milestones for the reduced 10 service hours, named refund #1 and refund #2 the sales rep then activates the order in the lifecycle manager's entitlements tab, the total quantity for implementation services is reduced to 40 generate invoices for milestones once milestones have been established for a one time line item, nue billing accelerator will generate invoices based on the start date of the milestone lines this process also takes into account the inherited billing timing and billing period from the parent line, ensuring seamless coordination with the milestone lines for the above example, the following invoices will be generated over time billing period amount line items 11/05/2023 11/04/2024 $4000 quote builder $2000 annual charge for the 1st yearimplementation service requirement collection $2000 charge 12/05/2023 12/05/2023 $3000 implementation service implementation $3000 charge 01/05/2023 01/05/2023 $5000 implementation service uat and service acceptance $5000 charge 11/05/2024 11/04/2025 $2000 quote builder $2000 annual charge for the 2nd year invoice milestones independently often times, companies prefer to create invoices for milestone services separately from their recurring invoices scenario vroom provides smart revenue with 100 hours of professional services for the installation of video conferencing, in addition to their existing vroom video conference subscriptions vroom prepares a quote which includes vroom professional edition, 100 seats, priced at $10,00 per month, effective from 03/22/2024, for a subscription term of one year installation services with two separate milestones $14,400 due on 04/01/2024 $28,800 due on 05/01/2024 vroom would like to starts monthly invoicing to smart revenue from 03/22/2024 onwards additionally, they plan to issue separate invoices for each milestone upon reaching the respective milestone dates by default, nue generates one invoice per billing period for each customer to implement scenario above, admin users need to enable the following billing group attribute service milestone please be aware that enabling this billing group attribute will produce a distinct invoice for milestone services alongside the recurring invoices generated for each billing period consequently, there might be more than one draft invoice per billing period therefore, it's essential to ensure there are no existing draft invoices in the system before activating this option, ensuring a clean starting point please follow the steps below to enable this option login to nue app, and navigate to settings in the setting's search box, search for "milestones", and select the option "generate invoices for service milestones independently" activate the toggle to enable this billing group attribute if there are draft invoices in the system, you will receive a notification stating that you must not have any draft invoices before enabling this option in such a scenario, please proceed to the invoices menu and either activate or cancel the draft invoices as required otherwise, you will receive a confirmation message that this option is successfully enabled once this billing group attribute is successfully enabled, the milestone services will be invoiced separately from the recurring invoices this also applies to invoice preview for quotes, orders, and accounts in the given scenario, assuming smart revenue has a monthly billing schedule with the billing cycle day set as the 22nd of each month if the billing group attribute "service milestone" is not enabled, smart revenue will receive the initial invoice on 03/22/2024 this invoice will include items for vroom professional edition and the first milestone, which is due on 04/01/2024 however, if the billing group "service milestone" is enabled, smart revenue will only receive the first invoice on 03/22/2024, containing the item for vroom professional edition subsequently, they will receive a separate invoice on 04/01/2024, exclusively containing the first milestone payment due on that date for more details about how nue billing groups work, please refer to billing groups docid\ fpgz9b2tc4se1thmnh9kw manage milestones in service milestones, it is not uncommon for changes to occur after customers have committed to these milestones but before the invoices are generated and paid various scenarios may necessitate updates to service milestones instances such as exceeding initially estimated service hours or alterations to the service plan are common triggers for adjustments this dynamic nature of service related engagements underscores the importance of a flexible and responsive system that allows for seamless modifications to service milestones, ensuring that the invoicing process accurately reflects the evolving nature of the services provided whether it involves accommodating changes in project scope or adapting to shifts in customer requirements, the ability to update service milestones plays a crucial role in maintaining transparency and alignment between service delivery and billing processes in nue, users can make the following adjustments to service milestones change milestone dates; merge multiple milestones into one, or create more milestones after milestones are created, users can view and manage milestones by following the steps below in nue on salesforce, find and open the account, and click 'manage customer lifecycle' button to launch the customer lifecycle manager navigate to entitlements, and search to find the entitlement in the entitlement card, you can see 'update quantity', 'manage milestones', and 'more ' button in the 'more' button, you can further access the following actions view change logs this initiates the change log modal popup view order history much like the subscription card, this function retrieves all orders associated with the given entitlement or asset and directs to the order tab view invoices similar to the invoice card, this function retrieves all invoices linked to the specified entitlement or asset and directs to the invoices tab click 'manage milestones' the milestone popup will launch in the milestones popup, all milestones created for the entitlement are displayed they are grouped into invoiced and scheduled invoiced these milestones have already been invoiced cancel the invoices before making any changes to the milestones in the invoiced milestone list, users view a list of milestones along with their corresponding invoices for the associated order products linked to the entitlement or asset the default display includes the following read only columns milestone total amount quantity milestone date invoice as these are one time milestones, only one invoice is available the invoice column displays the invoice with a hyperlink leading to the invoice page in the lifecycle manager you can click on the invoice link to view and optionally, cancel the invoice, if you would like to change the milestone date scheduled these milestones are scheduled but not yet invoiced you can modify the milestone dates, amounts, or split the milestones in the scheduled milestone list, users observe the following columns for the associated order products linked to the entitlement or asset milestone total amount quantity milestone date change milestone date the milestone date is editable directly within the inline editor upon clicking on the milestone date, a date picker is presented you can pick a different milestone date, and click 'confirm' you will receive the following alert message asking if you would like to proceed click 'yes' to change the milestone date the milestone date will be changed immediately merge and create new milestones users can also merge multiple milestones into one, and create more milestones before the milestones are invoiced scenario our fictional company vroom inc has committed 4 service milestones for customer smart revenue inc they are requirement collection 02/01/2024 implementation 03/01/2024 uat 04/01/2024 customer acceptance 05/01/2024 in the middle of feburary, in the requirement collection phase, smart revenue wants to shorten the implemention time (but not necessarily reduce the implementation hours) so they would like to merge the remaining 3 milestones implementation, uat and customer acceptance into 2 with new milestone dates implementation and uat 03/05/2024, 40% final acceptance 04/15/2024, 60% to implement this scenario, users can click "manage milestones" to launch the milestones popup as you can see in the following screenshot, the "requirement collection" milestone has been invoiced, so it cannot be changed "implementation", "uat", and "customer acceptance" are not invoiced yet you can click "update milestone" of each milestone, to add an update milestone request to the change cart after you add all update milestone change requests to the change cart, you can review these request in the change cart now you can click "checkout" to checkout the changes into a quote or an order if you expand the line item "implementation service", you will find the following changes have taken place all 3 selected milestones for updates are deleted they are merged into one new milestone with default milestone name "new milestone #1" the new milestone has the milestone date defaulted to today, or the earliest milestone date among all milestones requested for updates, whichever is earlier for example, if today is 03/01/2024, and the earliest date of milestones request for updates is 02/15/2024, then the milestone date will be set to 02/15/2024 if today is 01/25/2024, and the earliest date of milestones requested for updates is 03/01/2024, then the milestone date will be set to 01/25/2024 now you can click the "milestone" icon and adjust the milestones further update the default milestone name to "implementation and uat", and adjust its date to 03/05/2024 create a new milestone named "final acceptance", and set its date to 04/15/2024 allocate the percentage for both milestones to 40% and 60% respectively click 'confirm' to commit the changes after you finish adjusting all newly added milestones, you can click 'save and exit' on the line editor to save the quote or order when the quote is finalized into an active order, you can navigate to the lifecycle manager → entitlements, and click "manage milestones" to view the adjusted milestones putting it altogether in the realm of service milestones and milestone based billing, nue empowers users with an easy to use tool for creating billing structures that align with specific project milestones directly in the line editor we've delved into how this works, starting with a comprehensive overview of the concept as we've seen, the products under the one time revenue model in nue can now be seamlessly divided into multiple milestones, each carrying its own unique start date, quantity, percentage of total, and price we refer to these split lines as "milestone lines," and they offer a dynamic approach to billing now, let's explore how these concepts come to life with a practical scenario imagine smart revenue inc , a fictitious company, wants to purchase a 2 year subscription to quote builder and 100 hours of implementation services, divided into three phases requirement collection, implementation, and uat with service acceptance their payment schedule reflects the schedule of each phase, with payments of 20%, 30%, and 50% respectively while these percentages don't mirror the service hours, the flexibility of milestone based billing makes it all possible users can create and manage milestones directly in the line editor of a quote or an order users can add or remove milestones, customize their names, adjust percentages, quantities, and total prices additionally, for those wanting a balanced allocation of milestones, a 'allocate evenly' feature evens out milestone dates, quantities, percentages, and prices once the milestones are set up and validated, users can click 'confirm' to add them to the quote or order, ensuring the billing structure mirrors the unique project requirements it's important to note that each milestone line may carry distinct net sales prices and discount percentages due to varying quantity and total price allocations service milestones frequently require adjustments post customer commitment, often due to changes in service hours or plan modifications users can make updates to milestone dates, merge milestones or replace existing milestones with new ones finally, nue's billing accelerator generates invoices based on the milestone lines' start dates, syncing seamlessly with the inherited billing timing and billing period from the parent line this orchestration results in a finely tuned billing schedule in our example, we outlined the invoices that would be generated, showcasing the adaptability and precision of milestone based billing