Preview Invoices

preview invoices for quotes and orders often times, while creating a quote or an order, sales reps may want to create an order form that shows the first invoice, or invoices that span the entire subscription term of the quote previewing invoices when creating quotes or orders in b2b selling is a common practice and can vary in popularity depending on the specific industry, company, and customer preferences in nue, we provide the ability to preview invoices for a quote or an order by constructing an order payload (including all non summary order products), and sending the payload to the billing accelerator for billing preview optionally, the invoice previews can be persisted in salesforce so that they can be additional information presented on the order form preview invoices for customers customer account managers also have a need to preview customers' future unbilled invoices to proactively engage with customers to discuss billing expectations, address any potential concerns, and ensure a smooth invoicing process in nue, we provide the ability to instantly preview invoices for a customer by constructing a payload containing all currently active orders of the customer, and sending the payload to the billing accelerator for billing preview optionally, the invoice previews can be persisted in salesforce, so that it also provides valuable insights for finance operations and facilitates better cash flow management as well let's get started! please note that the products and prices used in this tutorial are fictional, and are for demo purposes only preview invoices on the line editor system setting required this feature requires the following system setting to be enabled lifecycle manager > quotes and orders preview invoices for quotes and orders after invoice preview is enabled for your nue organization, users can prevew invoices for a quote or an order, before an order is activated to preview invoices, you can follow the steps below login to salesforce, and navigate to nue on salesforce app from the app launcher navigate to an opportunity click 'new quote' or 'new order' button to create a new quote or a new order you can also open an existing quote or order fill up the quote or order information, and click 'save and next' in the line editor, add a few line items optionally, you can click on the 'wrench' icon to add the following columns into the line item grid billing timing, billing period this helps you to understand how the invoices and invoice items are generated by the invoice preview click 'quick save' click 'preview invoices' button in the button bar choose one of the 3 following preview options, and click confirm preview options description first invoice only if this option is chosen, the system will generate the first invoice using either the current date (today) or the earliest next billing date among all the line items in the quote or order, whichever comes later, as the target date for the invoice all invoices for the entire term if this option is chosen, the system will generate all invoices spanning the entire term of the products or services in this quote (or order) for preview a specific invoice target date if this option is chosen, the system will generate all invoices using the specified target date a modal popup window will be launched with the previewed invoices you can click 'cancel' or 'close' to close the preview window, or you can click 'save previewed invoices' to save the previewed invoices in salesforce user scenarios now let's use the following a few scenarios to look at the details of invoice preview preview invoices for a multi year subscription with one time services scenario our fictional company smart revenue inc wants to purchase a 2 year subscription of quote builder with a ramp pricing, where the second year has a 5% discount the company also wants to purchase 100 hours of implementation services the company would like to know the invoice amount of the first year, and second year respectively let's assume that system admin has configured bill cycle day to align with the first subscription's subscription start date for more information about billing cycle day, please refer to this article docid\ a7nuwldozr54jykg0wjeq to implement this scenario, the sales rep has added quote builder (and its bundled subscription price builder) as well as implementation services into the line editor she sets the subscription term to be 24 months (or 2 years) in the following image, we can see that quote builder has a 2 year subscription term with ramp pricing the first year is $10,000 and the second year is $9,500 at the same time, there is a one time implementation service of $20,000 charged on 11/04/2023 the billing timing of all line items is in advance now, the sales rep clicks 'preview invoices', select the opton to preview all invoices for the entire subscription term, and click 'confirm' in the preview popup window, you can see there are 2 annual invoices the 1st invoice has the billing period 2023 11 04 to 2024 11 03 this invoice contains the 1st year charge of quote builder, as well as the entire charge of the implementation services this comes to a total of $30,000 the 2nd invoice has the billing period 2024 11 04 to 2025 11 03 this invoice contains the 2nd year charge of quote builder this comes to a total of $9,500 invoice preview of the 1st year invoice preview of the 2nd year preview invoices for line items with mixed billing periods scenario our fictional company smart revenue also wants to add another 1 year subscription of nue self service to the same quote that contains quote builder and implementation services but they only want to add it on the 2nd year nue self service is billed monthly smart revenue wants to know exactly the invoice amount of the 1st year and 2nd year with the additional of nue self service added on the 2nd year only to implement this scenario, the sales rep adds nue self service to the quote with a start date of 11/04/2024, for 12 months in the following image, you can see the billing period of the newly added nue self service product line is monthly the sales rep clicks 'preview invoices' in the invoice preview window, you can see starting the first billing period of the 2nd year, nue on salesforce will be billed with a $100 monthly charge preview invoices on a change quote or order scenario when it's close to renewal, our fictional company smart revenue wants to renew quote builder subscription for a 3rd year, and add 10 more licenses upon renewal they would like to preview the invoices of the 3rd year the sales rep navigates to the lifecycle manager, find the quote builder subscription, and click 'renew', where she selects to renew for 1 more year, and at the same time, add 10 more licenses she checks out the change cart into a new quote the following image shows the line editor of the quote in this quote, you can see that the original 50 licenses are renewed, and 10 more licenses are added upon renewal now she clicks on 'preview invoices', and selects 'preview invoices for the entire term' in the following image, you can see that the 3rd year invoice will contain the annual charge of 60 licenses note when you preview invoices of an order that contains changes of existing subscriptions, assets or entitlements, the previewed invoices will only contain the quote line items or the order products of the change quote or order they do not contain previewed invoice amounts of existing active orders preview invoices for accounts scenario chloe placed an order for customer smart revenue that contains a subscription starting 01/01/2024, ending 12/31/2024 the customer is on a monthly billing schedule, and has been billed for january and february 2024 now the customer wants to add 10 more licenses to the subscription, starting 03/16/2024 chloe places the new order with 10 more licenses the customer calls to ask about the invoice details of the next invoice, including the prorated amount of the additional 10 licenses the next invoice will be issued on march 1st, 2024 you can follow the steps below to preview invoices for a particular account navigate to accounts in salesforce, and click to open the account click 'manage customer lifecycle' to launch the lifecycle manager click 'invoices' tab click 'preview future invoices' action to launch the invoice preview modal popup in the popup, select one of the preview options in our case, we select to preview the invoice with a specific invoice target date 03/01/2024 click 'confirm' now you can see the previewed invoices in our case, the previewed invoice of march 2024 contains the initial 100 licenses, as well as 10 licenses added on 03/15/2024, prorated for a partial month if your organization has enabled multiple currencies, invoices for an account will be grouped by each currency when previewed preview invoices in different currencies jpg save previewed invoices users can save previewed invoices in salesforce when the user clicks 'save previewed invoices' in the invoice preview popup window, the previewed invoices will be saved in salesforce as invoice records the invoice records will be saved as preview status, and will be displayed in the invoices tab of the lifecycle manager please note that previewed invoices do not have an invoice number (the invoice id in salesforce is used as the invoice number) they cannot be activated or canceled however, each previewed invoice has a reference to the quote or order the previewed invoices are also not accessible in nue app they are accessible in nue on salesforce only the saved previewed invoices can be used to configure the invoice amounts in the order form generated from a quote or order preview invoices using apex global methods we also provide apex global methods to preview invoices and optionally, saved the previewed invoices in salesforce preview the first invoice ruby invoicepreviewservice previewservice = new ruby invoicepreviewservice(); // specify the object id and objecttype the object type can be quote or order string objecttype = 'quote'; id objectid = '0q08g0000006aobsam'; // the quote id ruby invoicepreviewservice invoicespreviewapiresponse response = previewservice previewinvoices( objectid, objecttype, ruby invoicepreviewservice option first invoice, null); // optionally, save the previewed invoices list\<ruby invoice c> invoices = previewservice saveinvoicepreview(response); preview all invoices of the entire term ruby invoicepreviewservice previewservice = new ruby invoicepreviewservice(); // specify the object id and objecttype the object type can be quote or order string objecttype = 'quote'; id objectid = '0q08g0000006aobsam'; // the quote id ruby invoicepreviewservice invoicespreviewapiresponse response = previewservice previewinvoices( objectid, objecttype, ruby invoicepreviewservice option all invoices, null); // optionally, save the previewed invoices list\<ruby invoice c> invoices = previewservice saveinvoicepreview(response); preview invoices with an invoice target date ruby invoicepreviewservice previewservice = new ruby invoicepreviewservice(); // specify the object id and objecttype the object type can be quote or order string objecttype = 'quote'; id objectid = '0q08g0000006aobsam'; // the quote id date targetdate = date parse('1/1/2025'); ruby invoicepreviewservice invoicespreviewapiresponse response = previewservice previewinvoices( objectid, objecttype, ruby invoicepreviewservice option invoices with target date, targetdate); // optionally, save the previewed invoices list\<ruby invoice c> invoices = previewservice saveinvoicepreview(response); putting it altogether in summary, the invoice preview feature in nue allows for a comprehensive understanding of invoicing details when creating quotes and orders, catering to the specific needs and preferences of various industries and customers enable the system setting before you begin, ensure that the "preview invoices" system setting is enabled in your nue organization previewing invoices after enabling invoice preview, follow these steps log in to salesforce and access nue via the app launcher navigate to an opportunity and create a new quote or order fill in the necessary information and proceed to the line editor add line items and configure billing details as needed use the 'preview invoices' button to select from three preview options "first invoice only" "all invoices for the entire term" "a specific invoice target date" a modal window will display the previewed invoices user scenarios we provided a few scenarios to illustrate the practical application of invoice preview these scenarios include multi year subscriptions, adding products to existing quotes, and renewals with additional items saving previewed invoices users can save the previewed invoices in salesforce for future reference these invoices are stored with a "preview" status and can be accessed in the invoices tab of the lifecycle manager calling apex global methods developers can call apex global methods to preview invoices and save previewed invoices remember that previewed invoices do not have invoice numbers, cannot be activated or canceled, and are accessible only within nue on salesforce they are useful for configuring invoice amounts in the order forms generated from quotes and orders incorporating the invoice preview feature into your b2b sales process provides clarity and transparency, ensuring that you and your customers have a clear understanding of the invoicing details associated with quotes and orders this can lead to smoother transactions and enhanced customer satisfaction so, take advantage of this feature and streamline your invoicing process today