The API Refence can be accessed <a href="https://api-docs.nue.io">here</a>.&nbsp; Please email to <a href="mailto:cs@nue.io">cs@nue.io</a> if you have any questions.&nbsp;&nbsp;

large_API Reference.png

medium_API Reference.png

small_API Reference.png

thumbnail_API Reference.png

API Reference.png

API Reference

With Nue, you can create accurate and detailed quotes and orders as simple and intuitive as possible. When you create a quote and order, we provide a variety of visual effects that make it easy to see how prices are changing, while producing accurate pricing calculations and booking metrics.&nbsp; Let's dive in!
&nbsp;
<hr />
&nbsp;
In the <a title="Get Started with Price Builder" href="../get-started-price-builder">last guide</a>, we have created a set of Vroom products and bundles, configured a price tag for overage pricing, as well as a discount tag for 3-year subscription ramp pricing.&nbsp; Now we're going to create quotes and orders in Nue on Salesforce, and see these products and prices in action at operational time.&nbsp;&nbsp;
&nbsp;
In this guide, we will provide practical examples using a hypothetical prospect/customer named Smart Revenue Inc.&nbsp;This potential buyer is interested in the Vroom products.&nbsp;&nbsp;
&nbsp;
<h2><a id="create-account-n-opportunity"></a>Create Account and Opportunity</h2>
Login to your Salesforce Org, and in Salesforce App Launcher, search for Nue on Salesforce, and select to open the app.&nbsp;
&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Navigate to Accounts, and click &lsquo;New&rsquo;</li>
<li style="font-weight: 400;" aria-level="1">Create an account named &lsquo;Smart Revenue Inc.&rsquo;, and navigate to the detail page of this account.</li>
<li style="font-weight: 400;" aria-level="1">On the account detail page, click &lsquo;New&rsquo; in opportunity related list to create an opportunity with the following values:
<ul>
<li style="font-weight: 400;" aria-level="1">Opportunity Name: New Sales for Smart Revenue</li>
<li style="font-weight: 400;" aria-level="1">Close Date: 04/30/2023</li>
<li style="font-weight: 400;" aria-level="1">Stage: Prospecting</li>
<li style="font-weight: 400;" aria-level="1">Amount: $100,000</li>
<li style="font-weight: 400;" aria-level="1">Click &lsquo;Save&rsquo;</li>
</ul>
</li>
</ul>
Now you have your account and opportunity ready, let&rsquo;s go ahead and create a quote for the account you just created.
&nbsp;
<h2><a id="create-quote"></a>Create Quote and Add Line Items</h2>
Now let&rsquo;s create a quote for Smart Revenue Inc.:
&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">On the opportunity detail page, click &lsquo;New Quote&rsquo;. This opens the Create Quote flow.&nbsp;</li>
<li style="font-weight: 400;" aria-level="1">Fill up the quote form as follows:&nbsp;</li>
</ul>
<ul>
<li style="list-style-type: none;">
<ul>
<li style="font-weight: 400;" aria-level="1">Quote Name: VROOM 100 LICENSES</li>
<li style="font-weight: 400;" aria-level="1">Subscription Start Date: Today (Default Value)</li>
<li style="font-weight: 400;" aria-level="1">Notice that the Opportunity field is automatically populated.&nbsp;&nbsp;</li>
<li style="font-weight: 400;" aria-level="1">Check Primary Quote
<ul>
<li style="font-weight: 400;" aria-level="1">Quote line items of a primary quote will be synchronized to the opportunity as opportunity products</li>
</ul>
</li>
<li style="font-weight: 400;" aria-level="1">Fill up the Billing Address and Quote Address</li>
<li style="font-weight: 400;" aria-level="1">Click &lsquo;Create Contact&rsquo; to create a new Bill To Contact:&nbsp;</li>
</ul>
</li>
</ul>
<ul>
<li style="list-style-type: none;">
<ul>
<li style="list-style-type: none;">
<ul>
<li style="font-weight: 400;" aria-level="1">First Name: Alice</li>
<li style="font-weight: 400;" aria-level="1">Last Name: Lee</li>
<li style="font-weight: 400;" aria-level="1">Account Name: Smart Revenue, inc.</li>
<li style="font-weight: 400;" aria-level="1">Phone: 555-123-7890</li>
<li style="font-weight: 400;" aria-level="1">Title: IT Director</li>
</ul>
</li>
<li style="font-weight: 400;" aria-level="1">Click 'Save and Next'.&nbsp;&nbsp;</li>
</ul>
</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Create_Quote_241244c5e9.png" />
&nbsp;
Now you are navigated to the Quote Line Editor page.
<ul>
<li>Select Subscription Term as 12 in the quote header.&nbsp; Notice that the End Date is recalculated automatically.&nbsp; </li>
<li>In the "Add New Product" panel on the right side, seach for product VROOM BUSINES.&nbsp; The following 2 VROOM BUSINESS entries are returned:&nbsp;
<ul>
<li>VROOM BUSINESS with License/Month UOM, priced at $19.99;&nbsp;</li>
<li>VROOM BUSINESS with License/Year UOM, priced at $119.99.</li>
</ul>
</li>
<li>Drag the one with License/Month UOM to the line editor on the left side</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_24_at_4_39_12_PM_c11100ed66.png" />
<h3><a id="product-configurator"></a><a id="configure-bundle-product"></a>Configure Bundle Product</h3>
Since this product is a bundle product, the Product Configurator launches.
<ul>
<li>In the Product Configurator, you can see all the bundled product options, as well as add-on product options.&nbsp; The default quantities, list prices, as well as whether the product options are recommended or required are all displayed in each product option tile.&nbsp;</li>
<li> Enable 'Only display add-on options' toggle to show add-on products only.&nbsp;&nbsp;</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_1_05_31_PM_7049b096f9.png" />
<ul>
<li>In the Price Summary panel on the upper right side, you can see the estimated prices for 1 License/Month for 12 months.&nbsp; This gives you a general idea of the total prices of the product options you configure into this bundle.</li>
<li>In the 'Vroom Webinar' product panel, since we configured the Vroom Webinar to include 100 free units, so you can see the default unit is 100.&nbsp;&nbsp;</li>
<li>Click on the '$' icon to see the Price Tag.&nbsp; You can see the Webinar Price Tiers being applied to this product option.&nbsp;&nbsp;</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_24_at_4_53_55_PM_847dc7c685.png" />
<ul>
<li>Now enter '300' total units.&nbsp; This will trigger the subtotal to be recalculated as $414.&nbsp;&nbsp;
<ul>
<li>How is $414 calculated?&nbsp;
<ul>
<li>The Webinar Price Tiers has a $0 price tier per unit for 0-250 participants, and a $0.69 price tier per unit for 250-300 participants.&nbsp;</li>
<li>The Price Model is Tiered Pricing.</li>
<li>So the total price is equal to: ($0 * 250 + $0.69 * 50) * 12 (months) = $414</li>
</ul>
</li>
<li>You can also try different numbers of partcipants, and see the pricing engine in action in real-time.</li>
</ul>
</li>
<li>Enter 2 total units (Each) for Vroom Phone.&nbsp; The subtotal is changed to $5.99 because we configured the bundle to include 1 phone for free, and each additional phone is $5.99.</li>
<li>Enter 100 total units (Hours) for Professional Services.&nbsp; The subtotal is changed to $8,000, because we configured the bundle to include 20 professional services hours for free, and any additional hour will be priced at $100 per hour.
<ul>
<li>You can also try to enter 250 Total Units.&nbsp; Because we configured this production option to have a maximum quantity 200 in this bundle, you will receive the following error message:&nbsp; Units must be between 1 and 200</li>
</ul>
</li>
<li>Click Confirm.&nbsp; The VROOM BUSINESS bundle as well as the configured products are automatically added to the Line Editor.&nbsp;&nbsp;</li>
<li>Click 'Add new product' vertical tab on the right side to close the Select Product panel.</li>
</ul>
<a id="edit-line-items"></a>
<h3>Edit Line Items</h3>
In the Line Editor, you can see the dates and pricing details of each line item, including Product Name, List Price, Net Sales Price, Start Date, End Date, Subscription Term, Total Price, Total Amount, Discount, and so on.
&nbsp;
Please refer to <a title="Understand Pricing Fields" href="../understand-pricing-fields">this document</a> for the details of different pricing fields on each line item.&nbsp;&nbsp;
&nbsp;
You notice that some cells have purple-colored fonts, and some are not.&nbsp; The cells with purple-colored fonts are inline editable.&nbsp; Now we are going to make some quick changes.&nbsp;
&nbsp;
<h4><a id="change-bundle-quantity"></a><a id="change-bundle-quantity"></a>Change Bundle Quantity</h4>
First, the customer would like to purchase 100 licenses of VROOM BUSINESS.&nbsp; You can click into the Quantity field of the VROOM BUSINESS line item, and change the value from 1 to 100 in quantity.&nbsp; Notice that the quantity of all its children line items, except for Vroom Phone and Professional Services, has been changed to 100 as well, and the Total Amount as well as other pricing fields, have been recalculated for each line item and aggregated to the quote level.&nbsp;&nbsp;
&nbsp;
The reason why the quantity of Vroom Phone and Professional Services is not changed together with the quantity of the bundle, is that we configured these product options to be not connected to bundle quantity.&nbsp; Therefore, the quantity of these product options can be independently configured.&nbsp;&nbsp;
&nbsp;
<h4><a id="change-subscription-term"></a><a id="change-term"></a>Change Subscription Term</h4>
In the quote header, change the Subscription Term from 12 to 36.&nbsp; This automatically split the VROOM BUSINESS into 4 Ramp Line items, each having a different start and end date.&nbsp;&nbsp;The first ramp line item reflects the 1-month free trial, and the subsequent 3 ramp line items reflect subscription ramp prices for each year in the 36-month subscription term.&nbsp; &nbsp;
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_1_32_38_PM_625a0357fd.png" />
<h4>&nbsp;</h4>
<h4><a id="change-total-price"></a>Change Total Price</h4>
In the quote header, change the Total Price to $80,000, which is the negotiated price of the customer.&nbsp; After this change is made, we automatically calculate the discount amount, as well as the discount percentage, and propage the discount percentage evenly to each line item.&nbsp;&nbsp;
&nbsp;
You can also try to change the Start Date, End Date of the quote header, and the Start Date and End Date of each line item (as long as it's shown as purple text) to experience the power of the real-time price calculation of the Line Editor.&nbsp;
&nbsp;
When you change the Start Date, the End Date either at the quote header, or each line item, will be recalculated according to the new Start Date, and the Subscription Term.&nbsp; If you change the End Date, the Subscription Term will be recalculated from the Start Date according to the new End Date.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_1_58_46_PM_3ac2390132.png" />
<h4><a id="add-metrics-fields"></a>Add Metrics Fields</h4>
You can also click the 'wrench' icon on the upper right corner of the LIne Editor grid to configure more fields into the grid.&nbsp; Now configure the following fields into the grid:&nbsp;
<ul>
<li>Delta ACV</li>
<li>Delta TCV</li>
<li>Delta ARR</li>
<li>Delta MRR</li>
</ul>
These are the line-level metrics that are automatically calculated while you configure the quote.&nbsp; Delta MRR and Delta ARR are not available for Vroom Phone and Professional Services products because their Revenue Model is One Time.
&nbsp;
Now you can click 'Save and Exit' to save this quote.&nbsp; Only after a few minutes, we have completed creating a quote with complex configuration and pricing.&nbsp;&nbsp;
&nbsp;
You can come back to the Line Editor later by clicking 'Edit Line Item' button on the Quote Details page to reconfigure the quote.
&nbsp;
When the quote is saved, since we set it as a primary quote, its line items will be synchronized to the opportunity as opportunity products.&nbsp; The Opportunity Amount will be updated as the total amount of the quote.&nbsp;&nbsp;
&nbsp;
<h3><a id="approve-quote"></a><a id="submit-quotes-for-approval"></a>Submit Quotes for Approval</h3>
After a quote is created, it can be sent to the Deal Desk for approval.&nbsp; You can configure Salesforce approval processes to work with quotes in an automatically way.&nbsp; For example, you can set up an approval process when the discount % is over a certain threashold.&nbsp; We will skip this step in this guide.
&nbsp;
<h3><a id="generate-order-form"></a><a id="generate-order-forms"></a>Generate Order Forms</h3>
After a quote is approved, it can be generated into an order form using any document generation tool integrated with e-signature available on the Salesforce platform.&nbsp; For example, DocuSign, Ironclad are the common choices.&nbsp; You can send the order form to the customer for e-signature.&nbsp; Will will skip this step in this guide.
&nbsp;
<h2><a id="close-won-opportunity"></a><a id="close-won-opportunity"></a>Close Won Opportunity</h2>
After the order form is signed by the customer, it is time to Close Won the opportunity.&nbsp;&nbsp;
&nbsp;
In Nue, when an opportunity is Closed Won, its primary quote will be automatically converted into an active order.&nbsp; In this process, the following actions occur:&nbsp;
<ul>
<li>Each quote line item is generated into a corrspondingo order product;&nbsp;</li>
<li>When the order is activated, each order product will be provisioned into a subscription, an asset or an entitlement, according to the value of the Product Category.</li>
</ul>
By default, Nue supports 4 product categories, and they will be provisioned into object types specified in the following table:&nbsp;
&nbsp;
<table style="border-collapse: collapse; width: 70%; height: 28px;" border="1">
<tbody>
<tr style="height: 14px;">
<td style="width: 49.5977%; height: 14px;">Product Category</td>
<td style="width: 49.5977%; height: 14px;">Provision Object Type</td>
</tr>
<tr style="height: 14px;">
<td style="width: 49.5977%; height: 14px;">Physical Goods</td>
<td style="width: 49.5977%; height: 14px;">Asset</td>
</tr>
<tr>
<td style="width: 49.5977%;">Recurring Services</td>
<td style="width: 49.5977%;">Subscription</td>
</tr>
<tr>
<td style="width: 49.5977%;">Professional Services</td>
<td style="width: 49.5977%;">Entitlement</td>
</tr>
<tr>
<td style="width: 49.5977%;">Customer Support</td>
<td style="width: 49.5977%;">Entitlement</td>
</tr>
</tbody>
</table>
&nbsp;
You can add your own custom product category, and also create custom mapping for the provisioning object type.&nbsp; For example, you can add 'Training Classes' as a product category, and map it to Entitlement.
&nbsp;
Please follow the steps below to close won the opportunity:&nbsp;
<ul>
<li>Navigate to the Opportunity Detail page</li>
<li>Click on the 'Closed' stage in the progress bar, and set the Close Stage as 'Closed Won'</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Close_Won_Oppty_2afc10ef9b.jpg" />
&nbsp;
Now you can navigate to Nue Lifecycle Manager to view the orders, subscriptions, assets and entitlements.&nbsp;
<ul>
<li>Click on the Account name of the opportunity to navigate to the account page.&nbsp;&nbsp;</li>
<li>Click on button 'Manage Customer Lifecycle'.&nbsp;&nbsp;</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Customer_Lifecycle_e2cab5c6b6.png" />
&nbsp;
In the Customer Lifecycle Manager, you can see the general information of the account, including the account metrics, orders, subscriptions, assets, entitlements, invoices, usage and credits. In our example:&nbsp;
<ul>
<li>VROOM BUSINESS is provisioned into a Subscription that contains children subscriptions, assets and entitlements, including
<ul>
<li>Group Meetings</li>
<li>Private and Group Chat</li>
<li>Vroom Webinar</li>
<li>VROOM Phone Hardware as a Service</li>
<li>Professional Services</li>
</ul>
</li>
<li class="MuiTypography-root-6567 jss8437 MuiTypography-body1-6569">VROOM Phone Hardware as a Service - Poly VVX 250 is provisioned into a physical asset</li>
<li class="MuiTypography-root-6567 jss8437 MuiTypography-body1-6569">Professional Services is provisioned into an entitlement</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_4_38_39_PM_11c26df7f4.png" />
&nbsp;
&nbsp;
<hr />
&nbsp;
Congratulations! Now you created the first quote, and activated the first order.&nbsp; Next, we will walk you through how to use <a title="Get Started with Lifecycle Manager" href="../get-started-lifecycle-manager">Nue Lifecycle Manager</a> to upsell, cross-sell and make other changes to customers' subscriptions, assets and entitlements.&nbsp;&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
<pre>&nbsp;</pre>
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;

Explore our guides and examples to integrate nue

large_Quote Builder.png

medium_Quote Builder.png

small_Quote Builder.png

thumbnail_Quote Builder.png

Quote Builder.png

Create Quotes and Orders

<h1>Price Builder Settings</h1>
This article contains detailed information about system configuration options for functionalities in Nue Price Builder, including Pricing Attributes, Product Category Mappings, etc.
&nbsp;
<hr />
&nbsp;
<h1><a id="pricing-attributes"></a>Pricing Attributes</h1>
You can define one or more pricing attributes to enable multi-attribute pricing.&nbsp; Please refer to <a title="Multi-attribute Pricing" href="../../../docs/use-cases/multi-attribute-pricing/">Multi-attribbute Pricing</a> for detailed information about setting up pricing attributes.&nbsp;&nbsp;

large_PriceBuilder.jpg

medium_PriceBuilder.jpg

small_PriceBuilder.jpg

thumbnail_PriceBuilder.jpg

PriceBuilder.jpg

Price Builder Settings

large_SubscriptionMetrics.jpg

medium_SubscriptionMetrics.jpg

small_SubscriptionMetrics.jpg

thumbnail_SubscriptionMetrics.jpg

SubscriptionMetrics.jpg

Subscription and Order Metrics

<h1>Billing Parameters</h1>
In this guide, we will explore Nue's key billing parameters that facilitate the generation of invoices and credit memos. You will gain a deep understanding of fundamental concepts such as Billing Period, Bill Cycle Day, Billing Timing, Partial Billing Period Prorations, and more. You will learn about how these parameters work together to ensure accurate and efficient billing processes.
&nbsp;
<hr />
<h2><a id="billing-period"></a>Billing Period</h2>
A billing period refers to a specific timeframe during which goods or services are provided, and for which customers are billed by a business or service provider. It is a predetermined period of time over which the billing activities and charges are calculated and accumulated.
&nbsp;
The duration of a billing period can vary depending on the industry, business model, and agreement between the provider and the customer. Common billing periods include monthly, quarterly, semi-annually, or annually.
&nbsp;
The billing period is an essential component of the billing process as it sets the timeframe for which charges are calculated and billed. It provides clarity and structure to both the business and the customer regarding the billing cycle, enabling accurate and timely invoicing.
&nbsp;
Nue supports the following billing periods:
<ul>
<li>Monthly</li>
<li>Quarterly</li>
<li>Semi-Annual</li>
<li>Annual</li>
<li>Same as Subscription Term</li>
</ul>
It is also important to configure the Start Month of the billing period, which determines the start month of the first billing cycle in a year.
&nbsp;
The Billing Period can be configured at the organization level and can be overridden for a specific customer or product. &nbsp;For example, the default billing period is annual, but a customer may want to be billed quarterly or a specific product needs to be billed monthly.
&nbsp;
The default Billing Period of an order product will be in the following priority order and can be changed in the Quote Line Editor:
Product Billing Settings --&gt; Order Billing Settings --&gt; Account Billing Settings&nbsp;--&gt; Nue System Billing Settings.
&nbsp;
By default, the billing period is monthly, starting January. Admin users can configure the organization-level billing period by following the steps below:&nbsp;
<ul>
<li>Login to <a title="Nue.io" href="https://app.nue.io">Nue App</a></li>
<li>Navigate to Settings &rarr; Billing Schedules</li>
<li>Configure the Billing Period, and set the Start From month.&nbsp;&nbsp;
<ul>
<li>If the Biling Cycle Day is set to Auto-Set to the First Subscription, then the billing start month cannot be changed.&nbsp; It will be default to the Start Date of the first subscription.&nbsp;&nbsp;</li>
</ul>
</li>
<li>Additionally, admin users can set the billing period to align with the customer's first order or subscription by checking the 'Automatically align the billing period of an account with its initial Subscription/Order'. When this setting is checked, the account's billing period will be set to the billing period of the customer's first subscription or order automatically.</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Billing_Period_System_Settings_5e0ebecc78.jpg" alt="Billing Period System Settings.jpg" />
&nbsp;
<h4>Users can override the organization default Billing Period and Start Month for a specific customer:&nbsp;</h4>
<ul>
<li>Login to Salesforce and navigate to Accounts</li>
<li>Click to open the customer account</li>
<li>In account details, edit Billing Period and Bill Cycle Start Month. &nbsp;</li>
</ul>
If a customer account has a different billing period than the organization default, the billing period of a newly created order will be set to the customer's billing period instead.
&nbsp;
<h4>Users can also override the organization default Billing Period for a specific product:&nbsp;</h4>
<ul>
<li>Login to Nue and navigate to Product Catalog:</li>
<li>Click to open the product</li>
<li>In the product edit page, edit Billing Period. &nbsp;</li>
</ul>
If a product has a different billing period than the organization default, when adding the product to an order, the billing period of the order product will be set to the product's billing period instead.
&nbsp;
<h4>Same as Subscription Term</h4>
This option is typically used when you bill your customers in total just once when the first billing cycle day comes, instead of periodically doing it in each billing cycle. Please note that if you choose this option as the billing period for any of your products or customers, the&nbsp;Bill Cycle Day&nbsp;and&nbsp;Bill Cycle Start Month&nbsp;will be ignored. Instead, the subscription's billing cycle day will be set as the start date of the subscription.
&nbsp;
<h2><a id="bill-cycle-day"></a>Bill Cycle Day</h2>
The bill cycle day refers to a specific day of the month on which a business or service provider initiates the billing cycle for a customer. It serves as a reference point to determine the start and end dates of the billing period and influences the timing of invoice generation and payment due dates.
&nbsp;
When a customer's billing cycle begins and ends is determined by the bill cycle day. For example, if the bill cycle day is the 15th of the month, the billing period for that customer would typically span from the 15th of one month to the 14th of the following month.
&nbsp;
The Bill Cycle Day can be configured at the organization level, and can be overridden for a specific customer.&nbsp;
<h3><a id="anniversary-billing"></a>Anniversary Billing</h3>
Anniversary billing is commonly used in subscription-based industries such as telecommunications, software-as-a-service (SaaS), and membership-based services. It allows businesses to align their billing practices with the customer's initial sign-up date.&nbsp;
&nbsp;
In anniversary billing, the billing cycle and charges are determined based on the individual customer's specific activation or subscription start date. For example, if a customer signs up for a service on July 5th, their anniversary billing date would occur on July 5th of each subsequent year.
&nbsp;
This billing method allows for personalized billing cycles tailored to each customer's unique subscription or service start date. It ensures that customers are billed consistently on the same day each year, providing predictability and clarity in the billing process.
&nbsp;
By default, the Bill Cycle Day is 1st of Month, Admin users can configure the organization-level Bill Cycle Day by following the steps below:&nbsp;
<ul>
<li>Login to <a title="Nue.io" href="https://app.nue.io">Nue App</a></li>
<li>Navigate to Settings &rarr; Billing Schedules</li>
<li>Configure the Bill Cycle Day
<ul>
<li>To set a specific day of the month for invoice generation and align the Billing Cycle Day for all customers, choose the option "Specific Day of Month".&nbsp; If 31st of Month is selected, Nue billing engine will generate invoices in the last day of the month.&nbsp;&nbsp;</li>
<li>To configure Anniversary Billing, select "Auto-Set to the First Subscription" to Subscription Start Date.<img src="https://nervous-kaput-low.media.strapiapp.com/Bill_Cycle_Day_System_Settings_9abc7cbbe2.jpg" alt="Bill Cycle Day System Settings.jpg" />&nbsp;
<ul>
<li>Optionally, you can align the Bill Cycle Day to a different date of the first subscription, for example, Ordered On, or even a custom date field, such as Service Acceptance Date.</li>
</ul>
</li>
<li>If customers have multiple subscriptions with different start dates, select "Auto-Set to the Subscription's Start Date." This way, each subscription will have its own Anniversary Billing starting on its start date.<img src="https://nervous-kaput-low.media.strapiapp.com/Auto_Set_Subscription_Start_Date_bfda6a3d9d.jpg" alt="Auto-Set Subscription Start Date.jpg" /></li>
</ul>
</li>
</ul>
&nbsp;
Users can override the organization default Bill Cycle Day for a specific customer:&nbsp;
<ul>
<li>Login to Salesforce and navigate to Accounts</li>
<li>Click to open the customer acccount</li>
<li>In account details, edit Bill Cycle Day.&nbsp;&nbsp;</li>
</ul>
If a customer account has a different Bill Cycle Day than the organization default, Nue billing engine will generate invoices according to the customer's specific Bill Cycle Day.
<h2><a id="billing-timing"></a>Billing Timing</h2>
Billing Timing determiens whether the products or services are billed before or after the products or services are delivered or consumed.&nbsp;&nbsp;
&nbsp;
Nue supports 2 different billing timing options: Bill In Advance and Bill in Arrears.&nbsp;
<h4>Bill In Advance</h4>
Bill In Advance option allows for the invoicing of customers before the provision of products or services. With this billing timing option, customers are charged in advance for a specified billing period.&nbsp;
<h4>Bill In Arrears</h4>
Bill in Arrears option allows for the invoicing of customers after the products or services have been provided or consumed. In this billing model, customers are billed for the usage or consumption that has already occurred within a specific billing period.
&nbsp;
For example, if you have a monthly subscription service and utilize bill in arrears, your customers would be billed at the end of each month for the services they have already received during that month. The charges are based on the actual usage or consumption of the products or services.
<h4>Organization Defaults</h4>
Nue sets default billing timing for different revenue models.&nbsp;
<ul>
<li>One-time, Recurring, Credit Burndown and Credit: Bill In Advance</li>
<li>Overage Usage: Bill In Arrears</li>
</ul>
Admin users can change the organization defaults by following the steps below: 
<ul>
<li>Login to <a title="Nue.io" href="https://app.nue.io">Nue App</a></li>
<li>Navigate to Settings &rarr; Billing Schedules</li>
<li>Configure the Billing Timing for selected Revenue Model</li>
</ul>
<h4><img src="https://nervous-kaput-low.media.strapiapp.com/Billing_Timing_af90e2c20c.png" /></h4>
<h3>Biling Timing Overrides</h3>
Users can override the organization-default billing timing configuration for specific products or price book entries.
&nbsp;
For example, a company sells OAuth API as a Service&nbsp;with the following different pricing options:
<table style="border-collapse: collapse; width: 100%; height: 42px;" border="1">
<tbody>
<tr style="height: 14px;">
<td style="width: 40.1315%; text-align: center; height: 14px;">Price Plan</td>
<td style="width: 9.80573%; text-align: center;">Default?</td>
<td style="width: 50.0627%; text-align: center; height: 14px;">Billing Timing</td>
</tr>
<tr style="height: 14px;">
<td style="width: 40.1315%; height: 14px;">$100 per month for unlimited API calls</td>
<td style="width: 9.80573%; text-align: center;">Yes</td>
<td style="width: 50.0627%; height: 14px;">Bill In Advance</td>
</tr>
<tr style="height: 14px;">
<td style="width: 40.1315%; height: 14px;">$50 per month for the first 100K API calls, and $10 per month for each additional 10K API calls</td>
<td style="width: 9.80573%; text-align: center;">No</td>
<td style="width: 50.0627%; height: 14px;">Bill In Arrears</td>
</tr>
</tbody>
</table>
In this example, admin user can configure the following:
<ul>
<li>Set the billing timing of the OAuth API to Bill In Advance</li>
<li>Set the billing timing of the second price book entry to Bill In Arrears</li>
</ul>
You can set the biling timing for specific products by following the steps below:&nbsp;
<ul>
<li>Login to <a title="Nue.io" href="https://app.nue.io">Nue App</a></li>
<li>Navigate to Price Builder &rarr; Product Catalog</li>
<li>Search for the product, and click 'View' icon to open the product details</li>
<li>Set the Billing Timing to your preferred value, if different from the organization default.</li>
<li>Toggle to 'Advanced Mode'</li>
<li>Click 'Prices', where you can see all the list prices of the product</li>
<li>Click 'Edit' icon of a specific price book entry, and set the Billing Timing to your preferred value, if different from the organization default.</li>
</ul>
<h2><a id="partial-period-proration"></a>Partial Billing Period Proration</h2>
Partial period proration determines when the prorated amount for a subscription will be invoiced, if the order product(s) related to the subscription start in the middle of a billing period.&nbsp;&nbsp;
<ul>
<li>If enabled, the order products that start in the middle of a billing period will be prorated and billed for the partial billing period;</li>
<li>Otherwise, the order products that start in the middle of a billing period will be prorated, but the prorated amount will be rolled into the next billing period.&nbsp;</li>
</ul>
<table style="border-collapse: collapse; width: 100%; background-color: #d9dae2;">
<tbody>
<tr>
<td style="width: 99.4987%;">
EXAMPLE
&nbsp;
Chloe placed an order starting 10/01/2022 for a 12-month subscription of monthly recurring CMRR of $100.
&nbsp;
The customer has a billing period of &lsquo;Annual&rsquo; starting 1/1 on a year.
&nbsp;
If &lsquo;Partial Period Protection&rsquo; is enabled, the user will receive a prorated bill of $100 *3 = $300 for the billing period of 01/01/2022 and 12/31/2022.
&nbsp;
Otherwise, the user receives an invoice on 01/01/2023 for a total of $1500 for the service period between 10/01/2022 and 12/31/2023.
</td>
</tr>
</tbody>
</table>
&nbsp;
By default, the partial billing period is enabled.&nbsp; To configure this setting,&nbsp;
<ul>
<li>Login to <a title="Nue.io" href="https://app.nue.io">Nue App</a></li>
<li>Navigate to Settings &rarr; Billing Schedules</li>
<li>Toggle the value for Enable billing proration for partial periods.&nbsp;&nbsp;</li>
</ul>
<h2><a id="invoicing"></a></h2>

large_Biling Parameters.jpg

medium_Biling Parameters.jpg

small_Biling Parameters.jpg

thumbnail_Biling Parameters.jpg

Biling Parameters.jpg

Billing Parameters

large_CancelSubscription.jpg

medium_CancelSubscription.jpg

small_CancelSubscription.jpg

thumbnail_CancelSubscription.jpg

CancelSubscription.jpg

Cancel Subscriptions

large_6.png

medium_6.png

small_6.png

thumbnail_6.png

6.png

Nue Object Model - Billing and Usage Accelerator

<h1>Upsell and Downsell</h1>
With Nue Lifecycle Manager, you can easily upsell or downsell a subscription, an add-on subscription, an asset or an entitlement.&nbsp; In this article, we'll outline several common upsell and downsell scenarios.
&nbsp;
<hr />
&nbsp;
Users can login to Salesforce, and navigate to an account.&nbsp; Click 'Manage Customer Lifecycle" to navigate to the Lifecycle Manager.&nbsp;
&nbsp;
<h2><a id="add-quantity"></a>Upsell - Add Product Quantity</h2>
In the upsell scenarios, customers want to make mid-term changes to add product quantities.&nbsp; With Nue, you can easily add quantities in the Lifecycle Manager for one or more subscripitons, entitlements and assets, and checkout the change requests into a quote or an order.&nbsp; Nue will automatically process the changes in quantity, and in total price.&nbsp; When the Opportunity is Closed Won, or the order is activated, the subscriptions, entitlements, or assets will be versioned with the quantity added, and the metrics recalculated.&nbsp;&nbsp;
&nbsp;
<h3><a id="add-quantity"></a>Add quantity to subscriptions</h3>
Scenario: A user wants to add more units to an existing subscription and coterm the added units with the subscription's end date.
&nbsp;
For example, the customer Smart Revenue has a subscription starting 1/1/2023 and ending 12/31/2023 with 110 users.&nbsp; A sales rep wants to add 1 user to this subscription starting 07/01/2023, and she wants the 1 additional user to also end on 12/31/2023.&nbsp;&nbsp;
&nbsp;
You can follow the steps below to implement this scenario.&nbsp;&nbsp;
<ul>
<li>Navigate to the Lifecycle Manager &gt; Subscriptions Tab</li>
<li>Use 'Search Subscriptions' to use Subscription Number or Product Name to find the subscription.</li>
<li>Click 'Update Quantity'</li>
<li>Add 1 User starting 07/01/2023</li>
<li>Click 'Confirm'.</li>
<li>Now the change request is added to the Change Cart.&nbsp;</li>
<li>Checkout from the Change Cart into a new quote or order.&nbsp;&nbsp;</li>
<li>Follow the Create Quote (or Create Order) process.&nbsp;&nbsp;
<ul>
<li>If you are creating a new quote, you will need to associate the quote to an existing opportunity, or create a new opportunity.&nbsp;&nbsp;</li>
</ul>
</li>
<li>Click 'Save and Next'</li>
<li>In the Line Editor, expand the Summary Line to see the change line.&nbsp; You can see 1 user is added starting 07/01/2023, and the total price is prorated for 6 months only.&nbsp;</li>
<li>You can change the Discount or the Net Sales Price.&nbsp;&nbsp;</li>
<li>You can click 'Edit' icon in the Change Line to edit the quantity or start date.&nbsp; The prices will be recalculated when you confirm the edits..</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Add_Quantity_5b4aed9eda.png" />
Click Save and Exit, and Close Won the opportunity if you chose to create a primary quote, or activate the order directly if you chose to create an order.&nbsp;
&nbsp;
When the order is activated, the subscription will be versioned to reflect this change.&nbsp; If you navigate back to the lifecycle manager, you can see the Subscription is changed to Version 2, and the quantity is updated to 111.
&nbsp;
<h3><a id="add-quantity-bundle"></a>Add quantity to bundle subscriptions</h3>
Scenario: A user wants to add more units to an existing bundle subscription and coterm the added units with the subscription's end date.&nbsp;&nbsp;
&nbsp;
You can follow the exact same steps to add quantity to a bundle subscription.&nbsp; When you check out into a quote or order, in the Line Editor, Nue will automatically add quantities not only to the bundle subscription itself, but also to all children subscriptions that are connected to the bundle quantity.&nbsp;&nbsp;
<ul>
<li>When adding a product to a bundle, if you configure "Link to Bundle Quantity" as true, then the quantity of the product will go along with the quantity of the bundle.&nbsp;&nbsp;</li>
</ul>
Child product quantity = Bundle Quantity x Product Option Quantity In the screenshot below, both children subscriptions "Group Meetings" and "Private and Group Chats" are updated with added 10 units, together with the bundle.&nbsp;&nbsp; 
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_04_28_at_6_21_58_PM_e44786e076.png" />
When you Close Won the opportunity or activate the order, the bundle subscription, as well as its children subscriptions that are connected to the bundle quantity will be updated to a newer version.
&nbsp;
<h3><a id="add-quantity-addon"></a>Add quantity to add-on subscriptions</h3>
Scenario: A user wants to add more units to an add-on subscription that is not connected with the bundle quantity, and coterm the added units with the subscription's end date. &nbsp;
&nbsp;
For example, Smart Revenue has a subscription VROOM BUSINESS, which has an add-on Vroom Webinar.&nbsp; Vroom Webinar is based on an overage usage revenue model, thus it s not configured to connect with the bundle quantity.&nbsp;
&nbsp;
You can use the exact same steps to add more quantity to the add-on subscription ("Vroom Webinar").
&nbsp;
When you search for "Vroom Webinar" in the Lifecycle Manager's Subscriptions tab, the Vroom Webinar Subscription will be displayed under the VROOM BUSINESS parent subscription, so that you are aware that it is not a standalone subscription.&nbsp;&nbsp;
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Add_Addon_Quantity_84690e14b9.png" />
<h3>&nbsp;</h3>
<h3><a id="add-quantity-assets-entitlements"></a><a id="add-quantity-assets-entitlements"></a>Add quantity to assets and entitlements</h3>
Scenario:&nbsp;A user wants to add quantity to an asset or entitlement, starting a specific date.&nbsp;
&nbsp;
You can follow the steps below to quickly add new units to an asset or entitlement.
<h4>Add Quantity to Asset</h4>
<ul>
<li>Navigate to the Lifecycle Manager</li>
<li>Click Assets tab.&nbsp; Search for Asset name or Asset number or other fields</li>
<li>Click Update Quantity.&nbsp;&nbsp;</li>
<li>Specify the number of added quantity, and the effective date.&nbsp;</li>
<li>Click 'Confirm'.&nbsp; This will add the change request to the Change Cart.&nbsp; You can further edit the changes in the Change Cart.</li>
</ul>
<h4>Add Quantity to Entitlement</h4>
<ul>
<li>Navigate to the Lifecycle Manager</li>
<li>Click Assets tab.&nbsp; Search for Entitlement name or Entitlement number or other fields</li>
<li>Click Update Quantity.&nbsp;&nbsp;</li>
<li>Specify the number of added quantity, and the effective date.&nbsp;</li>
<li>Click 'Confirm'.&nbsp; This will add the change request to the Change Cart.&nbsp; You can further edit the changes in the Change Cart.</li>
</ul>
When you checkout from the change cart and create a quote or order from the change cart, Nue will calculate the total price for the added quantities and show in the LIne Editor.
&nbsp;
When you Close Won the opportunity or activate the order, Nue will version the asset or the entilement wih the new quantity.&nbsp;
<a id="change-history"></a>
<h2><a id="change-history"></a>Change History</h2>
All changes will be logged as Change Log records in the Change History.&nbsp; You can navigate to the Subscription card and click Change History, or navigate to the Asset and Entitlement card and click See Details to view the Change History.
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_04_28_at_7_05_15_PM_c32c364967.png" />
&nbsp;
<h2><a id="down-sell"></a>Downsell - Reduce Product Quantity</h2>
In the downsell scenarios, customers want to make mid-term changes to reduce product quantities.&nbsp; With Nue, you can easily reduce quantities in the Lifecycle Manager for one or more subscripitons, entitlements and assets, and checkout the change requests into a quote or an order.&nbsp; Nue will automatically process the changes in quantity, and in total price (mostly negativa amounts).&nbsp; When the Opportunity is Closed Won, or the order is activated, the subscriptions, entitlements, or assets will be versioned with the quantity reduced, and the metrics recalculated.&nbsp;&nbsp;
&nbsp;
<h3><a id="reduce-quantity"></a><a id="reduce-quantity-from-subs-assets-entitlements"></a>Reduce quantity from subscriptions, assets and entitlements</h3>
Scenario: A user want to reduce quantity of a subscription, a bundle subscription with children subscriptions, or an add-on subscription.&nbsp;&nbsp;
&nbsp;
For example, the customer Smart Revenue has a subscription starting 1/1/2023 and ending 12/31/2023 with 110 users.&nbsp; A sales rep wants to reduce 10 users to this subscription starting 10/01/2023.&nbsp; She expects that after the change, the subscription has 111 users till 09/30/2023, and has 100 user since 10/01/2023.
&nbsp;
You can follow the similar steps as adding quantities:
<ul>
<li>Find the subscription in the Lifecycle Manager, and click 'Update Quantity'.&nbsp;</li>
<li>Select Action as 'Reduce' as shown in the screenshot below.&nbsp; Set the quantity to reduce as 10, starting 10/01/2023.&nbsp;</li>
<li>Click 'Confirm' to add to the change cart.&nbsp;&nbsp;</li>
<li>Additionally, if you want to reduce quantities for other subscriptions, add-on subscriptions assets or entitlements, you can repeat these steps.&nbsp; All the change requests will be added to the change cart.</li>
<li>When you are ready, click Change Cart, and make final review or edits of your changes, and click Checkout.&nbsp;&nbsp;</li>
<li>You can choose to checkout into a new quote, a new order, an existing quote or an existing order.&nbsp; Simply follow the checkout page flow.&nbsp;&nbsp;
<ul>
<li>If you checkout into a new quote, in the Create Quote step, you must either create a new opportunity, or choose an existing opportunity, so that the changes in ARR and total amounts can be rolled into the opportunity pipeline.</li>
</ul>
</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_05_01_at_3_23_16_PM_c4bfbb3201.png" />
&nbsp;
In the Line Editor, you can see that Nue has created a Change Line with a negative quantity of 10, starting from 10/01/2023 to 12/31/2023.&nbsp; This means, 10 units are reduced starting 10/01/2023.&nbsp; This also reflects to the Total Price of the line item, and rolled up to the price summary at the header level.&nbsp; Nue also calculates the Delta ARR and other metrics for the negative quantity.&nbsp;
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Reduce_Quantity_d2c3ebc050.jpg" />
&nbsp;
After the opportunity is Closed Won or the order is activated, you can navigate back to the Lifecycle Manager &rarr; Subscriptions tab, and see that this subscription is versioned with the updated quantity, total price, and booking metrics.&nbsp; You can see the Revenue Stream being redrawn reflecting the downsell starting 10/1/2023.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Revenue_Stream_After_Downsell_71603103c5.jpg" />
<h3>&nbsp;</h3>
<h3><a id="reduce-bundle-subscription"></a><a id="reduce-quantity-bundle"></a>Reduce quantity for bundle subscriptions</h3>
You can follow the exact same steps to reduce quantities for bundle subscriptions.
&nbsp;
After the change requests to reduce quantities for bundle subscriptions are checked out, all children subscriptions in the bundle that are linked to the bundle quantity also have their quantities reduced.&nbsp; Users can see a change line for each child subscription having the quantity reduced.&nbsp;&nbsp;
&nbsp;
<h3><a id="additional-notes"></a><a id="additional-notes"></a><a id="additional-notes"></a>Additional notes on price calculation</h3>
In the downsell scenario, Nue uses the same Net Sales Price of the units that were purchased as the Net Sales Price of the units when calculating the quantity reduction.&nbsp; This ensures that the exact same dollar values be refunded or credited to the customer.
&nbsp;
For example, in the following complex scenario:&nbsp;
<ul>
<li>Smart Revenue Inc. subscribed to 10 user licenses for $10 each with subscription term 1/1/2023 to 12/31/2023.</li>
<li>On 07/01/2023, they added 10 user licenses with only $8 per license, for the same subscription.</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_05_01_at_4_22_16_PM_8ee96400b6.png" />
<ul>
<li>Smart Revenue wants to reduce 15 user licenses starting 10/01/2023.&nbsp;</li>
<li>Note that, among these 15 user licenses, 10 were priced at $10, and 5 were priced at $8.&nbsp; So in the Line Editor, you will see 2 Change Lines, one contains the quantity reduction of 10 units at $10, the other contains the quantity reduction of 5 units at $8:&nbsp;</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Reduce_Quantity_Advanced_d995d9c4c4.jpg" />
&nbsp;
When the order is activated, you will see the reduction in quantity in the Revenue Stream.&nbsp;
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Revenue_Stream_Quantity_Reduction_44a782e825.png" />
<h2><a id="change-categories"></a>Change Categories</h2>
The Change Type field present in each line specifies the nature of the change made, such as modifying the quantity or altering the term.
&nbsp;
For both Add or Reduce quantity cases, the Change Type is Update Quantity.&nbsp; However, in the <a title="ARR Momentum" href="../../../tutorial/tutorial-nue-analytics/arr-momentum/" target="_blank" rel="noopener">ARR Momentum chart</a>, it is represented as either Upsell/Expansion if the change in quantity is positive, or Downsell/Contraction if the change quantity is negative.&nbsp;&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
<h2>&nbsp;</h2>
&nbsp;

large_LifecycleManager.jpg

medium_LifecycleManager.jpg

small_LifecycleManager.jpg

thumbnail_LifecycleManager.jpg

LifecycleManager.jpg

Upsell and Downsell

<h1>Calculate Taxes with Stripe Tax Integration</h1>
This article outlines how Nue seamlessly integrates with Stripe Tax, enabling users to achieve accurate tax calculations for quotes, orders, invoices, and credit memos while ensuring compliance. It explains the configuration process for this integration in detail.&nbsp; Let's get started!
&nbsp;
<hr />
<table style="border-collapse: collapse; width: 50%; height: 118px; background-color: #f4ebff;" border="0">
<tbody>
<tr style="height: 118px;">
<td style="width: 99.5671%; height: 118px;">
PERMISSIONS REQUIRED
&nbsp;
To manage Stripe integrations, users need the following permissions:&nbsp;
&nbsp;
Integrations
<ul>
<li>Manage Stripe Integration</li>
</ul>
</td>
</tr>
</tbody>
</table>
<h1><a id="setup-connection"></a>Setup Stripe Integration</h1>
Users can follow the steps <a title="Stripe Connection" href="https://docs.nue.io/docs/tutorial/tutorial-integrations/stripe-integration/#setup-stripe-connection" target="_blank" rel="noopener">here</a> to setup the Stripe connection.&nbsp;&nbsp;
&nbsp;
<h1>Configure Stripe Tax</h1>
Users can enable Stripe Tax with the following options:&nbsp;
<ul>
<li>Enable Stripe Tax for quotes and orders 
<ul>
<li>If enabled, taxes will be calculated for quotes and orders.</li>
</ul>
</li>
<li>Enable Stripe Tax for invoices and collections
<ul>
<li>If enabled, taxes will be calculated for invoices, credit memos and collections.&nbsp;</li>
</ul>
</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_12_12_at_9_46_30_PM_04c4921a8d.png" />
&nbsp;
Please note that you may only use one Tax provider. &nbsp;For instance, if you currently have Stripe Tax Tax as your chosen tax provider and you decide to enable Stripe Tax, you will be prompted to disable Stripe Tax Integration before enabling Stripe Tax.
<h1><a id="configure-tax-codes"></a>Configure Tax Codes</h1>
Once Stripe Tax is enabled, taxation is enabled in Nue.&nbsp; Transactions are subject to taxations according to the tax codes associated to the products or services involved in the transactions.&nbsp;&nbsp;
&nbsp;
<h1><a id="configure-tax-codees"></a><a id="configure-tax-codes"></a></h1>
Stripe offers an extensive range of <a title="Stripe Tax Codes" href="https://stripe.com/docs/tax/tax-codes" target="_blank" rel="noopener">tax codes</a> catering to various businesses. However, most companies require only a limited set of tax codes for their operations. Nue simplifies this process by providing a convenient way to restrict the available tax codes, ensuring your company can easily select and use the necessary ones.
&nbsp;
You can find the entire list of tax codes supported by Stripe <a title="Stripe Tax Code" href="https://stripe.com/docs/tax/tax-codes" target="_blank" rel="noopener">here</a>.&nbsp;&nbsp;
&nbsp;
To configure a set of Tax Codes to select and use for your company, login to <a title="Nue App" href="https://app.nue.io" target="_blank" rel="noopener">Nue App</a> and navigate to Revenue Manager &rarr; Tax Codes.&nbsp;
<ul>
<li>Click New Tax Code, and enter Name, Status, Tax Code, and Description.&nbsp;&nbsp;
<ul>
<li>Name: The tax code name used in your company.&nbsp; For example, 'Core Platform'.&nbsp;&nbsp;</li>
<li>Tax Code: Copy the Stripe Tax Code</li>
<li>Description: Enter your own description or copy the Stripe Tax Code description.</li>
<li>Status: Set the status to Active to be used by the product catalog.&nbsp; You can switch the status to be inactive if this tax code is no longer used.&nbsp;&nbsp;</li>
</ul>
</li>
<li>Click Save.</li>
</ul>
<table style="border-collapse: collapse; width: 100%; background-color: #f4ebff;" border="0">
<tbody>
<tr>
<td style="width: 99.5671%;">
NOTE
&nbsp;
If the Nue tax code is inactive, it cannot be selected or used by any product in the product catalog. Nonetheless, the tax code will still be applied for tax calculations in existing products until admin users explicitly modify the tax code on these products.
</td>
</tr>
</tbody>
</table>
&nbsp;
<h1><a id="configure-tax-for-products"></a>Configure Tax Information for Products</h1>
To configure tax information for products, you can follow the steps below:&nbsp;
<ul>
<li>Login to <a title="Nue App" href="https://app.nue.io" target="_blank" rel="noopener">Nue App</a> and navigate to Price Builder &rarr; Product Catalog</li>
<li>Click to edit a product or bundle product.</li>
<li>You should see 2 tax related fields:&nbsp;
<ul>
<li>Tax Mode: "Tax Mode" refers to the method used to calculate and apply taxes to product prices or transaction amounts. There are two primary tax modes: Inclusive and Exclusive.
<ul>
<li>Inclusive: Inclusive tax mode means that the tax amount is already included in the price of the product or service.&nbsp;</li>
<li>Exclusive: Exclusive tax mode means that the tax amount is added on top of the price of the product or service at the time of purchase.&nbsp; This is the default value.&nbsp;&nbsp;</li>
</ul>
</li>
<li>Tax Code: This refers to Nue Tax Code you created in the last step.&nbsp; For example, you can select 'Core Platform'. Only active tax codes are available to use.</li>
</ul>
</li>
<li>Click 'Save and Exit'.&nbsp;</li>
</ul>
<h1 class="p4"><a id="assign-exempt-code"></a></h1>
&nbsp;
<h1><a id="calculate-taxes-quotes-orders"></a>Calculate Taxes for Quotes and Orders</h1>
In an automated tax calculation system like Stripe Tax, once a product is associated with a specific Tax Code, it means that the product is linked to a predefined tax treatment, such as a particular tax rate or exemption status. When a transaction occurs, the tax amount applied to that product will be determined by several factors, including:
<ol>
<li>
Shipping Address: The tax rate may vary depending on the location of the customer's shipping address. Different jurisdictions have different tax rates and rules, and the tax calculation will consider the applicable rate based on the customer's location.
</li>
<li>
Transaction Date: Tax rates can change over time due to legislative updates or other factors. Therefore, the date of the transaction is considered to ensure that the correct tax rate at that specific time is applied.
</li>
<li>
Tax Code of the Product: As mentioned, the product's Tax Code defines how it should be taxed. It may have different tax treatments based on its category, usage, or any applicable tax exemptions.
</li>
</ol>
When users create a quote or an order, they can enter Billing Address and Shipping Address in the General Informations step.&nbsp; For example:&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_08_01_at_9_46_17_PM_c6e09079d8.png" />
&nbsp;
After users add products to the quote or order in the Line Editor step and click Quick Save, the taxes will be automatically calculated and shown in both the Price Summary and each line item.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Line_Editor_35a183cb7d.jpg" />
&nbsp;
Please note that:&nbsp;
<ul class="ul1">
<li class="li1">When the Tax Mode is Exclusive for a product, the Total Amount is the sum of the Total Price and the Tax Amount.</li>
<li class="li1">When the Tax Mode is Inclusive for a product, the Total Amount is equal to the Total Price.</li>
<li class="li1">If the quote or order contains both Tax Exclusive and Tax Inclusive products, the Total Amount in the Price Summary may not be equal to the sum of Total Price and Total Amount, due to different tax treatments for various products.</li>
</ul>
Additionally, users can view the detailed breakdown of taxes by clicking on the 'Tax Breakdown' icon located in the price summary section. In the summary view, the Tax Amount, Taxable Amount, and Tax Rate for the current quote or order will be displayed. In case users require more information, they can expand the tax summary to a full view of the tax breakdown list in a popup window, which will display all the relevant details, including tax code, type, and region information.
<img src="https://nervous-kaput-low.media.strapiapp.com/Tax_Breakdown_in_Line_Editor_2c283208be.jpg" alt="Tax Breakdown in Line Editor.jpg" />
<img src="https://nervous-kaput-low.media.strapiapp.com/Tax_Breakdown_in_Line_Editor_Full_View_f15fd8bfb7.jpg" alt="Tax Breakdown in Line Editor - Full View.jpg" />
&nbsp;
<h2 class="p2"><a id="shipping-address"></a>Shipping Address</h2>
If there is no shipping address entered in the quote or order, the shipping address of the customer will be used.&nbsp; If there is no shipping address of the customer, and there are products subject to taxations, a warning sign will be displayed next to Tax and Total Amount fields in the price summary, indicating the shipping address is required.
<h2 class="p2"><a id="validate-address"></a></h2>
&nbsp;
The taxes will be recalculated when users click Quick Save or Save and Exit.
&nbsp;
<h1 class="p4"><a id="calculate-taxes-for-invoices"></a>Calculate Taxes for Invoices and Credit Memos</h1>
When an order is activated, invoices and credit memos may be generated upon order activation or in a billing schedule job.&nbsp; The billing engine will also calculate taxes according to the tax code, tax mode, invoice date and shipping address of the associated order or customer.&nbsp;&nbsp;
&nbsp;
During the billing process, the following fields on Invoice and Invoice Item, Credit Memo and Credit Memo Items will be calculated:&nbsp;
&nbsp;
<table class="t1" style="border-collapse: collapse; width: 100%; height: 224px;" border="1" cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 16px;">
<td class="td1" style="width: 15.331%; height: 16px;" valign="top">
OBJECT
</td>
<td class="td1" style="width: 29.0329%; height: 16px;" valign="top">
FIELD
</td>
<td class="td1" style="width: 55.6361%; height: 16px;" valign="top">
DESCRIPTION
</td>
</tr>
<tr style="height: 16px;">
<td class="td1" style="width: 15.331%; height: 16px;" valign="top">
Invoice
</td>
<td class="td1" style="width: 29.0329%; height: 16px;" valign="top">
Tax Amount
</td>
<td class="td1" style="width: 55.6361%; height: 16px;" valign="top">
The total tax amount of all invoice items in the invoice
</td>
</tr>
<tr style="height: 32px;">
<td class="td1" style="width: 15.331%; height: 32px;" valign="top">
Invoice
</td>
<td class="td1" style="width: 29.0329%; height: 32px;" valign="top">
Amount Without Tax
</td>
<td class="td1" style="width: 55.6361%; height: 32px;" valign="top">
The total transaction amounts of all invoice items.
</td>
</tr>
<tr style="height: 64px;">
<td class="td1" style="width: 15.331%; height: 64px;" valign="top">
Invoice
</td>
<td class="td1" style="width: 29.0329%; height: 64px;" valign="top">
Invoice Amount
</td>
<td class="td1" style="width: 55.6361%; height: 64px;" valign="top">
The total invoice amount aggregated from Invoice Items.&nbsp;
For tax inclusive products, the invoice amount is the same as the transaction amount.&nbsp; For tax exclusive products, the invoice amount includes the transaction amount plus the tax amount.
</td>
</tr>
<tr style="height: 32px;">
<td class="td1" style="width: 15.331%; height: 32px;" valign="top">
Invoice Item
</td>
<td class="td1" style="width: 29.0329%; height: 32px;" valign="top">
Tax Amount
</td>
<td class="td1" style="width: 55.6361%; height: 32px;" valign="top">
Tha tax amount of the invoice item.
</td>
</tr>
<tr style="height: 16px;">
<td style="width: 15.331%; height: 16px;">
Invoice Item
</td>
<td style="width: 29.0329%; height: 16px;">
Transaction Amount Without Tax
</td>
<td style="width: 55.6361%; height: 16px;">
The taxable amount of the invoice item.
</td>
</tr>
<tr style="height: 32px;">
<td class="td1" style="width: 15.331%; height: 32px;" valign="top">
Invoice Item
</td>
<td class="td1" style="width: 29.0329%; height: 32px;" valign="top">
Transaction Amount
</td>
<td class="td1" style="width: 55.6361%; height: 32px;" valign="top">
The total amount of the invoice item.
The transaction amount includes the taxable amount plus the tax amount.
</td>
</tr>
</tbody>
</table>
<div class="">
<h1 class="relative flex h-full flex-1 items-stretch md:flex-col" role="presentation"><a id="Send_Invoices_To_Stripe"></a>Send Invoices to Stripe</h1>
&nbsp;
<h2><a id="Tax_Calculations"></a>Tax Calculations</h2>
Once an invoice is activated, it will be automatically sent to Stripe, and the tax calculation details will be included in the invoice.
</div>
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Stripe_Invoice_with_Tax_bd7c7eff79.jpg" alt="Stripe Invoice with Tax.jpg" />
The tax calculation details will be grouped based on the Tax Rate and Tax Mode of each invoice item. Items with the same tax rate and tax mode will be combined.
For example, if an invoice with invoice items having different tax rates and tax modes as below:
&nbsp;
<table style="border-collapse: collapse; width: 100%; height: 70px;" border="1">
<tbody>
<tr style="height: 14px;">
<td style="width: 14.7154%; height: 14px;">Item Number</td>
<td style="width: 12.9968%; height: 14px;">Tax Rate</td>
<td style="width: 11.3856%; height: 14px;">Tax Mode</td>
<td style="width: 11.3856%; height: 14px;">Amount</td>
<td style="width: 14.9302%; height: 14px;">Tax</td>
<td style="width: 15.7895%; height: 14px;">Total Amount</td>
<td style="width: 18.797%; height: 14px;">Total Excluding Tax</td>
</tr>
<tr style="height: 14px;">
<td style="width: 14.7154%; height: 14px;">I-001</td>
<td style="width: 12.9968%; height: 14px;">10%</td>
<td style="width: 11.3856%; height: 14px;">Inclusive</td>
<td style="width: 11.3856%; height: 14px;">$100</td>
<td style="width: 14.9302%; height: 14px;">$9.10</td>
<td style="width: 15.7895%; height: 14px;">$100</td>
<td style="width: 18.797%; height: 14px;">$90.90</td>
</tr>
<tr style="height: 14px;">
<td style="width: 14.7154%; height: 14px;">I-002</td>
<td style="width: 12.9968%; height: 14px;">10%</td>
<td style="width: 11.3856%; height: 14px;">Inclusive</td>
<td style="width: 11.3856%; height: 14px;">$200</td>
<td style="width: 14.9302%; height: 14px;">$18.18</td>
<td style="width: 15.7895%; height: 14px;">$200</td>
<td style="width: 18.797%; height: 14px;">$181.82</td>
</tr>
<tr style="height: 14px;">
<td style="width: 14.7154%; height: 14px;">I-003</td>
<td style="width: 12.9968%; height: 14px;">10%</td>
<td style="width: 11.3856%; height: 14px;">Exclusive</td>
<td style="width: 11.3856%; height: 14px;">$100</td>
<td style="width: 14.9302%; height: 14px;">$10</td>
<td style="width: 15.7895%; height: 14px;">$110</td>
<td style="width: 18.797%; height: 14px;">$100</td>
</tr>
<tr style="height: 14px;">
<td style="width: 14.7154%; height: 14px;">I-004</td>
<td style="width: 12.9968%; height: 14px;">0%</td>
<td style="width: 11.3856%; height: 14px;">Inclusive</td>
<td style="width: 11.3856%; height: 14px;">$100</td>
<td style="width: 14.9302%; height: 14px;">$0</td>
<td style="width: 15.7895%; height: 14px;">$100</td>
<td style="width: 18.797%; height: 14px;">$100</td>
</tr>
</tbody>
</table>
The tax calculations included in the invoice will be:
<ul>
<li>10% inclusive on $272.72 (I-001, I-002)</li>
<li>10% on $100 (I-003)</li>
<li>0% inclusive on $100 (I-004)</li>
</ul>
<h2><a id="Tax_Transactions"></a>Tax Transactions</h2>
If you need the tax transaction data to complete your tax filings and returns, you can export your Stripe Tax transaction data from Stripe -&gt; Tax -&gt; Registrations:
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Stripe_Tax_Transactions_67548628e5.jpg" alt="Stripe Tax Transactions.jpg" />
&nbsp;
Sample of exported tax transactions:
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Stripe_Tax_Transactions_Sample_87fbdb5f8e.jpg" alt="Stripe Tax Transactions Sample.jpg" />
&nbsp;

large_Taxation.jpg

medium_Taxation.jpg

small_Taxation.jpg

thumbnail_Taxation.jpg

Taxation.jpg

Calculate Taxes via Stripe Tax

<h1>Release 2303.1</h1>
Scheduled on Wednesday, 04/27/2023
Release 2303.1 includes the following feature enhancements and bug fixes.&nbsp;
&nbsp;
<h2>Feature Enhancements</h2>
<h3>Nue Price Builder</h3>
<h4>Ability to support multi-currency</h4>
&nbsp;
<ul>
<li>From this release, we will be able to support creating price book entries in multiple currencies. If the connected Salesforce Org is enabled with multi-currency, Nue will read the currency configurations from Salesforce.&nbsp; Users will be able to use different currencies available in Salesforce to configure price book, and price book entries.&nbsp; For more information, please contact <a href="mailto:cs@nueio">cs@nueio</a>.&nbsp;</li>
</ul>
&nbsp;
<h4>Ability to add products into a bundle with a different UOM term dimension</h4>
<ul>
<li data-pm-slice="1 1 []">When building a bundle, if the default UOM is User/Year (e.g., the UOM Term Dimension is Year), previously we can only add &ldquo;Recurring Services&rdquo; revenue model products with Term Dimension as Year into the bundle.</li>
<li data-pm-slice="1 1 []">&nbsp;</li>
<li>So in the Product Selector of the bundle builder, we have relaxed this constraints - all products with all UOMs willl be able to add to the bundle.</li>
</ul>
&nbsp;
<h3>Nue Revenue Manager</h3>
<h4>Ability to configure Stripe connection, add and update customer mapping between Salesforce and Stripe.</h4>
&nbsp;
<ul>
<li>Users can configure Strpe integration in Nue app, and import the mapping between existing customers in Stripe (if there are any) with Salesforce accounts.&nbsp; For more details please refer to <a title="Stripe Integration" href="https://docs.nue.io/docs/tutorial/tutorial-integrations/stripe-integration/" target="_blank" rel="noopener">this document.</a></li>
</ul>
&nbsp;
<h3>Nue Platform</h3>
<h4>Ability to export and import products with credit conversions in the Export / Import API</h4>
&nbsp;
<ul>
<li>When exporting or importing a product in Overage Usage or Pay As You Go revenue model, and the product has a credit conversions defined, the credit conversions will be exported and imported as well.&nbsp;&nbsp;</li>
</ul>
&nbsp;
<h4>Ability to export and import products with multi-attribute pricing</h4>
&nbsp;
<ul>
<li>The product export/import APIs are now able to export and import products having multi-attribute pricing.</li>
</ul>
&nbsp;
<h4>Ability to query credits and credit flows using graphQL for a specific subscription.</h4>
<ul>
<li>You can use graphQL to query credits and credit flows by filtering on a specific subscription.</li>
</ul>
&nbsp;
<h4>Ability to execute an API to synchronize orders from Salesforce to Nue</h4>
<ul>
<li>Now you can execute a Nue API to resynchronize orders from Salesforce to Nue for further invoice processing.</li>
</ul>
&nbsp;
<h4>Ability to execute an API to synchronize usage-type subscriptions from Salesforce to Nue</h4>
<ul>
<li>Now you can execute a Nue API to resynchronize orders from Salesforce to Nue for further usage processing.</li>
</ul>
&nbsp;
<h2>Bug Fixes</h2>
&nbsp;
<h3>Nue Lifecycle Manager</h3>
<h4 class="_1wyb1tcg _vwz41f4h _k48pbfng _1dyzz5jk _1bsb1osq _19pkidpf _2hwxidpf _otyridpf _18u0idpf _ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _syaz1fxt _mc2h1hna _14fy1hna" data-test-id="issue.views.issue-base.foundation.summary.heading" data-testid="issue.views.issue-base.foundation.summary.heading">The default sort order of subscriptions is not working sometimes</h4>
<ul>
<li>In the Lifecycle Manager, sometimes the subscriptions were not ordered by the Ordered Date in a descending manner.&nbsp; This is fixed.&nbsp;&nbsp;</li>
</ul>
&nbsp;
<h4 class="_1wyb1tcg _vwz41f4h _k48pbfng _1dyzz5jk _1bsb1osq _19pkidpf _2hwxidpf _otyridpf _18u0idpf _ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _syaz1fxt _mc2h1hna _14fy1hna" data-test-id="issue.views.issue-base.foundation.summary.heading" data-testid="issue.views.issue-base.foundation.summary.heading">The default sort order of invoices is not working sometimes</h4>
<ul>
<li>In the Lifecycle Manager, sometimes the invoices were not ordered by the Invoice Date in a descending manner.&nbsp; This is fixed.&nbsp;&nbsp;</li>
</ul>
&nbsp;
<h3>Nue Revenue Manager</h3>
<h4 class="_1wyb1tcg _vwz41f4h _k48pbfng _1dyzz5jk _1bsb1osq _19pkidpf _2hwxidpf _otyridpf _18u0idpf _ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _syaz1fxt _mc2h1hna _14fy1hna" data-test-id="issue.views.issue-base.foundation.summary.heading" data-testid="issue.views.issue-base.foundation.summary.heading">When the credit pool is of Cash Type, the credits are not provisioned properly.</h4>
<ul>
<li>This issue is fixed.&nbsp;&nbsp;</li>
</ul>

large_Release Notes.png

medium_Release Notes.png

small_Release Notes.png

thumbnail_Release Notes.png

Release Notes.png

Release 2303.1 - 04/27/2023

<h1>Integrate with Existing Usage Systems</h1>
For businesses that already have a usage metering system in place, integrating that system with Nue, while still generating invoice items using Nue's billing engine, results in a streamlined approach to managing usage data and billing operations. This article will guide you through how to ingest rated usage from your existing metering system into Nue, allowing for seamless billing and invoicing.
<h1 class="p1"><a id="separation-rating-billing"></a>The Separation of Rating and Billing</h1>
Nue is designed with a clear separation between usage rating and billing processes. This flexibility allows businesses to maintain their existing usage metering system - such as Metronome - while benefiting from Nue&rsquo;s robust billing capabilities. Rather than relying on Nue to rate raw usage data, companies can ingest usage data that has already been rated by their existing system. This means you can continue using the processes and systems you are familiar with while gaining the additional advantages of Nue&rsquo;s billing engine.
<h1 class="p1"><a id="how-it-works"></a>How It Works</h1>
The diagram below demonstrates the usage processing flow when integrating an external usage metering and rating system, such as Metronome, with Nue. While Metronome is used as an example in this illustration, the process is applicable to any external usage metering and rating systems.
&nbsp;
<ol>
<li class="p3">Define Price Tags: In the initial stage, you define the price tags for your products and services within Nue. This ensures that the correct tiered pricing structure is in place for your usage products when the rated usage is ingested.</li>
<li class="p3">Pre-Rate &amp; Order Processing: While your existing usage metering system manages the rating of usage data in real-time or on a scheduled basis, Nue handles pre-rating and order processing. This ensures that your quotes and orders, particularly those involving committed usage amounts or credit burndown models, are accurately calculated according to the tiered pricing structure defined in step 1 and are correctly presented to your customers.</li>
<li class="p3">Ingesting Rated Usage: Once usage has been rated by your metering system (e.g., Metronome), the data is ingested into Nue via API, specifically through the /<code>usage/rated-usage</code> endpoint. This data can be ingested in real-time or on a scheduled basis, depending on your needs. Nue also provides a UI to upload the rated usage record. &nbsp;Once the rated usage is ingested, Nue associates it with the pre-rated order products to prepare for subsequent billing processing.</li>
<li class="p3">Billing &amp; Invoicing: After the rated usage data has been ingested, Nue&rsquo;s billing engine takes over. It loads the rated usage and generates invoice items for the corresponding product lines. Whether your billing model is based on overage or credit burndown models, Nue ensures that the correct billing structure is applied. At the end of the billing period, invoices are generated with accuracy and efficiency.</li>
<li class="p3">Visualization &amp; Display: With the rated usage data in the system, Nue also provides valuable trending and reporting capabilities. You can forecast future usage trends, display relevant data, and use these insights to make informed business decisions.<img src="https://nervous-kaput-low.media.strapiapp.com/Usage_System_Integration_7fba26f243.png" /></li>
</ol>
<h1><a id="ingest-usage"></a>Ingest or Upload Rated Usage</h1>
Nue provides 2 ways to ingest or upload rated usage: through API or on UI.
<h2><a id="ingest-api"></a>Ingest Rated Usage through API</h2>
Users can ingest rated usage through the <a title="Upload Rated Usage" href="https://api-docs.nue.io/#upload-rated-usage" target="_blank" rel="noopener">Upload Rated Usage</a> API. This approach is recommended when there is a need to frequently ingest large volumes of rated usage.
<h3>Endpoint</h3>
<pre class="language-bash"><code>POST https://api.nue.io/usage/rated-usage</code></pre>
&nbsp;
<h3 class="p1">Example</h3>
<pre class="language-bash"><code>curl --location 'https://api.nue.io/usage/rated-usage' \
--header 'Content-Type: application/json' \
--header 'nue-api-key: {{nue-api-key}}' \
--data '{
 "transactionId": "USAGE-240823144251", 
 "data": [
 {
 "transactionId": "USAGE-240823144251-001",
 "customerId": "001Ru00000GuO3HIAV",
 "subscriptionNumber": "SUB-000030",
 "timestamp": "2024-07-31T09:00:06.000Z",
 "quantity": 129,
 "ratedAmount": 199,
 "properties": {
 "region": "EU-1",
 "clusterId": "1"
 }
 },
 {
 "transactionId": "USAGE-240823144251-002",
 "customerId": "001Ru00000GuO3HIAV",
 "subscriptionNumber": "SUB-000030",
 "timestamp": "2024-07-31T09:00:06.000Z",
 "quantity": 398,
 "ratedAmount": 299,
 "properties": {
 "region": "EU-1",
 "clusterId": "1"
 }
 }
 ]
}'</code></pre>
The <code>transactionId</code> uniquely identifies each usage record, ensuring that usage with the same <code>transactionId</code> cannot have different data. This makes the API idempotent - running the API multiple times with the same transactionId and identical content will not result in data duplication.
&nbsp;
The following outlines the properties of the ingested rated usage:
<table style="border-collapse: collapse; width: 100.052%; height: 440.938px;" border="1">
<tbody>
<tr style="height: 13.6364px;">
<td style="width: 35.0925%; height: 13.6364px;">PROPERTY</td>
<td style="width: 37.3238%; height: 13.6364px;">DESCRIPTION</td>
<td style="width: 27.5872%; height: 13.6364px;">REQUIRED</td>
</tr>
<tr style="height: 41.875px;">
<td style="width: 35.0925%; height: 41.875px;">transactionId</td>
<td style="width: 37.3238%; height: 41.875px;">The <code>transactionId</code> uniquely identifies each usage record, ensuring that usage with the same <code>transactionId</code> cannot have different data.&nbsp;</td>
<td style="width: 27.5872%; height: 41.875px;">Yes</td>
</tr>
<tr style="height: 63.9773px;">
<td style="width: 35.0925%; height: 63.9773px;">customerId</td>
<td style="width: 37.3238%; height: 63.9773px;">
The unique ID of the customer.&nbsp;&nbsp;
&nbsp;
For customers from Salesforce, the ID needs to be the 18-character Salesforce ID of the account.&nbsp;&nbsp;
</td>
<td style="height: 175.937px; width: 27.5872%;" rowspan="2">The customer ID and customer name are both valid methods for identifying a customer. Typically, the customer ID is required. However, if users prefer not to search for the customer ID in Nue when ingesting rated usage from an external system, they can provide the customer name - provided the customer name is unique across all customers and can accurately identify the customer.</td>
</tr>
<tr style="height: 111.96px;">
<td style="width: 35.0925%; height: 111.96px;">customerName</td>
<td style="width: 37.3238%; height: 111.96px;">
The customer name.&nbsp;&nbsp;
&nbsp;
The customerName value is not required if customerId is provided. Users may also provide a customerName value alone, but only if the customer name is unique across all customers, allowing Nue to accurately locate the corresponding customer ID.
</td>
</tr>
<tr style="height: 90.8381px;">
<td style="width: 35.0925%; height: 90.8381px;">subscriptionId</td>
<td style="width: 37.3238%; height: 90.8381px;">
The subscription ID.&nbsp;&nbsp;
&nbsp;
For subscriptions from Salesforce, the ID needs to be the 18-character Salesforce ID of the subscription.&nbsp;&nbsp;
</td>
<td style="height: 154.943px; width: 27.5872%;" rowspan="4">The subscription ID, subscription number, product SKU, and product name are all valid methods for identifying a subscription. Typically, the subscription number is required. However, if users prefer not to search for the subscription number in Nue when ingesting rated usage from an external system, they can provide the product SKU or even the product name&mdash;as long as there is only one subscription for that product under the same customer and the product name uniquely identifies the product.</td>
</tr>
<tr style="height: 23.5085px;">
<td style="width: 35.0925%; height: 23.5085px;">subscriptionNumber</td>
<td style="width: 37.3238%; height: 23.5085px;">
The subscription number.
</td>
</tr>
<tr style="height: 20.2699px;">
<td style="width: 35.0925%; height: 20.2699px;">productSKU</td>
<td style="width: 37.3238%; height: 20.2699px;">The product SKU.</td>
</tr>
<tr style="height: 20.3267px;">
<td style="width: 35.0925%; height: 20.3267px;">productName</td>
<td style="width: 37.3238%; height: 20.3267px;">The product name.</td>
</tr>
<tr style="height: 13.6364px;">
<td style="width: 35.0925%; height: 13.6364px;">timestamp</td>
<td style="width: 37.3238%; height: 13.6364px;">The timestamp when the usage is rated.&nbsp;&nbsp;</td>
<td style="width: 27.5872%; height: 13.6364px;">&nbsp;</td>
</tr>
<tr style="height: 13.6364px;">
<td style="width: 35.0925%; height: 13.6364px;">quantity</td>
<td style="width: 37.3238%; height: 13.6364px;">The quantity of the usage.</td>
<td style="width: 27.5872%; height: 13.6364px;">&nbsp;</td>
</tr>
<tr style="height: 13.6364px;">
<td style="width: 35.0925%; height: 13.6364px;">ratedAmount</td>
<td style="width: 37.3238%; height: 13.6364px;">The rated amount in the currency of the subscription.&nbsp;</td>
<td style="width: 27.5872%; height: 13.6364px;">&nbsp;</td>
</tr>
<tr style="height: 13.6364px;">
<td style="width: 35.0925%; height: 13.6364px;">properties</td>
<td style="width: 37.3238%; height: 13.6364px;">The additional properties associated with the usage.</td>
<td style="width: 27.5872%; height: 13.6364px;">&nbsp;</td>
</tr>
</tbody>
</table>
<h2><a id="ingest-ui"></a>Upload Rated Usage on UI</h2>
Alternatively, users can upload rated usage through the UI by following these steps:
&nbsp;
<ul>
<li>Log in to the Nue App.</li>
<li>In the menu search box, type "Usage" and navigate to the Usage page.</li>
<li>Click on the "Upload" action and select "Rated Usage."</li>
<li>Just like uploading raw usage, you can download a template and create a CSV file containing the rated usage based on the template.</li>
<li>Import the rated usage file.</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Upload_Rated_Usage_22b312dec4.png" />
&nbsp;
Once the usage records are successfully uploaded, they will be marked as "Rated." These records will be processed by the billing engine to generate invoice items at the end of the billing period, as products and services under the "Overage Usage" revenue model are typically billed in arrears. You can cancel the rated usage as long as it has not reached the "Billed" status.
&nbsp;
When rated usage is ingested via API or UI, the Source field will be populated with the value "ExternalUsage" to distinguish it from raw usage ingested and rated by Nue, which will be tagged with the value "RawUsage.".&nbsp; An example is shown below.&nbsp;&nbsp;
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/External_Usage_47499cde1a.png" />
<h1>&nbsp;</h1>
<h1>Postman API Collection</h1>
You can find the Usage Postman API Collection <a title="Postman API Collection" href="https://documenter.getpostman.com/view/17660807/2sA3kdAHG3#24996241-6402-4326-aecc-50b8872fbfc7" target="_blank" rel="noopener">here</a>. Click the 'Run in Postman' button to import the collection into your Postman workspace.
&nbsp;
&nbsp;

large_Upload Rated Usage.png

medium_Upload Rated Usage.png

small_Upload Rated Usage.png

thumbnail_Upload Rated Usage.png

Upload Rated Usage.png

Integrate with Existing Usage Systems

Hi there! We hope you're enjoying using Nue and that it's helping you streamline your sales process and drive growth.
&nbsp;
If you ever run into any issues or have any questions, our Customer Success team is always here to help. Just shoot us an email at <a href="mailto:cs@nue.io" target="_new">cs@nue.io</a>, and we'll get back to you as soon as possible. Our team is dedicated to making sure you get the most out of Nue, so please don't hesitate to reach out if you need anything. Thanks for choosing Nue!

large_The Nue Platform.png

medium_The Nue Platform.png

small_The Nue Platform.png

thumbnail_The Nue Platform.png

The Nue Platform.png

Submit a support ticket

<h1>Release 2304.2</h1>
Scheduled on Monday, 06/12/2023
&nbsp;
<h2><a id="erq"></a><a id="feature-erq"></a>Feature Enhancements</h2>
<h3><a id="lm"></a>Nue Lifecycle Manager</h3>
<h4>Be able to drag and drop products into the quote when the number of products in the Product Selector is large</h4>
<ul>
<li>If the number of products available in the Product Selector is large, there may be an issue while trying to drag a product in the Product Selector panel and drop it into the Line Editor.&nbsp; We enhanced this behavior so that the droppable area on the left side takes the entire left panel.</li>
</ul>
<h3><a id="platform"></a><a id="rm"></a>Nue Revenue Manager</h3>
<h4>[Stripe Integration] As Finance Ops, I am able to cancel a "Paid" invoice&nbsp;</h4>
<ul>
<li>Occasionally, you might create an incorrect order, which generates an invalid invoice.&nbsp; The invoice could get paid via Stripe automatically since the customer has a default credit card on file, or has credits in the credit balance&nbsp; In this case, the invoice's Payment Status becomes PAID, in both Stripe and Nue.&nbsp; Previously, you may only refund a Paid invoice, which would in turn generate a credit memo.&nbsp; Now you are able to cancel a Paid invoice, which will trigger the following operations:&nbsp; 
<ol>
<li>Issue a Credit Note in Stripe for the invoice amount, whch will trigger a Credit Card refund or add the credit balance back to the customer</li>
<li>Cancel all related payment applications associated to the invoice in Nue (as well as Nue on Salesforce)</li>
<li>Cancel all related debit memos associated to the invoice in Nue (as well as Nue on Salesforce)</li>
<li>Change the invoice statatus from Active to Canceled</li>
</ol>
</li>
<li>For more information, please refer to<a href="https://docs.nue.io/docs/tutorial/tutorial-integrations/stripe-integration/#cancel-invoices" target="_blank" rel="noopener"> this article</a> in Nue Knowlege Center.&nbsp;</li>
</ul>
<h2><a id="bug-fixes"></a>Bug Fixes</h2>
<h3><a id="pb"></a><a id="pb"></a>Nue Price Builder</h3>
<h4>Should be able to create a UOM without a term dimension</h4>
<ul>
<li>We fixed this regression issue where a Unit of Measure had to have a term dimension.&nbsp; Now you can create a UOM without a term dimension specified, e.g., Each, Hour.&nbsp;&nbsp;</li>
<li>For more information about creating UOMs, please refer to <a title="Create Unit of Measure" href="https://docs.nue.io/docs/get-started/get-started-price-builder/#uom" target="_blank" rel="noopener">this article</a> in the Nue Knowledge Center</li>
</ul>
<h3><a id="lm"></a><a id="lm"></a>Nue Lifecycle Manager</h3>
<h4>Without "Sync primary quote line items to opportunity products" enabled, users can't automatically finalize quote/activate order when Close/Won an opportunity</h4>
<ul>
<li>Users had to enable "Sync primary quote line items to opportunity products" setting in order to automatically generate an order when from the primary quote when Close/Won an opportunity.&nbsp; This issue is fixed.&nbsp;&nbsp;</li>
<li>For more information about Lifecycle Manager settings, please refer to<a title="Lifecycle Manager Settings" href="https://docs.nue.io/docs/tutorial/tutorial-the-nue-platform/lifecycle-manager-settings/" target="_blank" rel="noopener"> this article </a>in the Nue Knowledge Center.</li>
</ul>

Release 2304.2 - 06/12/2023

With Nue, you can automate your sales process from the initial order to renewals, upsells, and cross-sells, all through a user-friendly interface inspired by eCommerce. Our platform is designed to help you streamline your customer lifecycle management and maximize revenue growth.&nbsp; Let's dive in!
&nbsp;
<hr />
&nbsp;
In <a title="Get Started with Quote Builder" href="../get-started-with-quote-builder">the last guide</a> we have walked you through how to create the first quote, close-won the opportunity and activate the first order.&nbsp; After the order was activated, you can see the subscriptions, assets and entitlements in the Lifecycle Manager by clicking on Manage Customer Lifecycle button in the account detail page.
&nbsp;
In this guide, we'll walk you though the steps to upsell, cross-sell and renew a customer using the Lifecycle Manager.&nbsp;&nbsp;
&nbsp;
<h1 style="text-align: left;"><a id="upsell-and-renew"></a>Upsell and Renew Subscription</h1>
&nbsp;
In Nue, all changes (including changes to assets, subscriptions and entitlements) are managed using the Lifecycle Manager.&nbsp;
&nbsp;
In the detail page of our hypothetical account Smart Revenue Inc., click on 'Manage customer Lifecycle', and navigate to the Lifecycle Manager.
&nbsp;
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_4_38_39_PM_11c26df7f4.png" />
&nbsp;
Click on the Subscriptions tab.&nbsp; In the Subscription created, you can see the Subscription Total TCV and other metrics, including Today's Quantity, Today's CMRR, Today's ARR, etc.&nbsp; All metrics for 'Today' are calculated nightly, because they could potentially change overnight.&nbsp;&nbsp;
&nbsp;
You can also see a Subscription Revenue Steam that spans through the entire subscription term.&nbsp; In our use case, we have applied a discount tag for the 3-year subscription ramp pricing.&nbsp; So you can see the price ramping clearly from the revenue stream chart.&nbsp;
&nbsp;
In the 'Included Items' panel, you can see the included products in this subscription.&nbsp; These are children subscriptions, assets and entitlements.&nbsp; You can click on any of the children subscriptions.&nbsp; The subscription panel will expand to load the child subscription information as well.&nbsp;&nbsp;
&nbsp;
Under the subscription summary information, there are several subscription actions:&nbsp;
&nbsp;
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Subscription_Actions_fef09870af.jpg" />
&nbsp;
These actions help you to quickly upsell, renew, co-term, reconfigure, or cancel the subscription.&nbsp;&nbsp;
&nbsp;
<h2 style="text-align: left;"><a id="use-case"></a>The Use Case</h2>
Our customer Smart Revenue wants to renew the VROOM BUSINESS subscription for another 12 months (currently, they have a 36-month subscription), and at the same time add 10 licenses.&nbsp;
&nbsp;
They also want to purchase 10 more hours of Professional Services and 1 more Vroom Phone Hardware as a Service starting the beginning of next month.&nbsp;&nbsp;
&nbsp;
Smart Revenue has a small team that wants to add 10 licenses to VROOM PRO at the beginning of next month.&nbsp; But they want to co-term VROOM PRO with VROOM BUSINESS after renewal.&nbsp;&nbsp;
&nbsp;
This sounds complicated, doesn't it?&nbsp;
&nbsp;
Let's see how we can achieve this easily using Lifecycle Manager.&nbsp;
&nbsp;
<ul>
<li style="text-align: left;">Click Renew action.&nbsp;&nbsp;</li>
<li style="text-align: left;">Fill the form to renew for another 12 months, and add 10 licenses upon renewal.</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_5_21_34_PM_1830341aa9.png" />
&nbsp;
<ul>
<li>Click Confirm. The popup closes, and the renewal requests are added to the Change Cart.</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_9_49_30_PM_a007463674.png" />
&nbsp;
The Change Cart is just like a shopping cart when you shop on Amazon.&nbsp; The changes to existing subscriptions are saved in the Change Cart.&nbsp; You can mouse over each change to edit the change information if your customer wants to make modifications.&nbsp; Once you are ready, you can click 'Checkout' to checkout into a quote or an order.
&nbsp;
If you are a Sales Rep or a Customer Success Manager, you may have more than one customers.&nbsp; So you can also expand to see the change requests you issued for other customers as well.
&nbsp;
<h3>Add More Entitlements</h3>
You can add more units of Professional Services by following steps below:&nbsp;
<ul>
<li>Navigate to Entitlements</li>
<li>In the Professional Services card, click Update Quantity</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_5_28_46_PM_a6115d37e9.png" />
<ul>
<li>Add 10 Units starting the beginning of next month.&nbsp;&nbsp;</li>
<li>Click Confirm.&nbsp; This adds a new change request to the Change Cart.</li>
</ul>
<h3>Add More Assets</h3>
You can add more units of Vroom Phone by following steps below:&nbsp;
<ul>
<li>Navigate to Assets</li>
<li>In the Vroom Phone card, click Update Quantity</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_9_51_05_PM_86e85a82c2.png" />
<ul>
<li>Add 1 Unit starting the beginning of next month</li>
<li>Click Confirm.&nbsp; This adds a new change request to the Change Cart.</li>
</ul>
Now we're ready to check out these changes to the existing subscriptions and entitlements of the customer.&nbsp; We click on the Change Cart, and find all our change requests are available in the cart:&nbsp;
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_9_46_54_PM_b75ff51e5e.png" />
&nbsp;
<ul>
<li>Click Checkout to check out from Change Cart.&nbsp;&nbsp;</li>
</ul>
<h3><a id="change-cart"></a>More about Change Cart</h3>
Change Cart is designed to simplify the process of making changes to subscriptions, assets, and service entitlements for enterprise sales users.
&nbsp;
What makes the feature truly unique is that it allows users to add change requests into a cart without having to create an empty quote or order first.
&nbsp;
This means that users can make changes to different objects as they navigate through their workflow, and they can add these changes to the cart as they go. Only when the user is ready to proceed with the changes do they need to checkout into a quote or order, which reverses the typical flow of creating a quote first, finding the subscriptions, making amendments, and then converting into an order.
&nbsp;
By using Change Cart, enterprise sales users can avoid creating empty quotes or orders, which can be time-consuming and lead to junk data. Instead, they can simply add change requests to the cart and then checkout when they're ready.
&nbsp;
The feature also provides a range of other benefits, such as the ability to group changes into different carts based on different criteria, such as Customer, Price Book, and Currency. Users can easily delete or discard items from the cart, and the contents of the cart persist across multiple sessions.
&nbsp;
<h2><a id="checkout"></a>Checkout Change Cart</h2>
After you click Checkout, you will be asked whether you want to check out into a new quote, a new order, or an existing quote, an existing order. These options are configurable to suite for the specific needs of your company.&nbsp;&nbsp;
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_9_45_45_PM_c17883ad70.png" />
&nbsp;
We choose to checkout into a new quote.&nbsp;&nbsp;
&nbsp;
In the Create Quote screen, you notice that the Quote Name is already automatically populated.&nbsp; We call these quotes (and orders) Change Quotes&nbsp;because unlike new sales quotes, they are making changes to existing subscriptions, assets and entitlements.
&nbsp;
You need to create a new opportunity to associate with this quote, so that the ARR of the change quote can be rolled into the opportunity pipeline as well.&nbsp;
&nbsp;
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Create_Upsell_Quote_cfb084163d.jpg" />
&nbsp;
Click Create Opportunity to create a new upsell opportunity.&nbsp; In a typical sales process, there may be more than one opportunity record types, e.g., Upsell, Renewal, each associated with a different sales process.&nbsp; So when you create a new opportunity for a Change Quote, you may be prompted to choose a record type first.&nbsp;&nbsp;
&nbsp;
In our hypothetical company, Vroom, there are no additional record types.&nbsp; So we'll fill up the opportunity form with the following information:&nbsp;
<ul>
<li>Opportunity Name: Upsell Opportunity for Smart Revenue</li>
<li>Close Date: The last day of this month, e.g., 04/30/2023</li>
<li>Stage: Proposal / Price Quote</li>
<li>Click 'Save'.</li>
</ul>
Check 'Primary Quote', and click 'Save and Next'.&nbsp;
&nbsp;
In the Line Editor, you can see there are 3 products being changed:&nbsp;
<ul>
<li>Professional Services</li>
<li>VROOM Phone Hardware as a Service</li>
<li>VROOM BUSINESS</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_7_31_41_PM_4e38addb48.png" />
&nbsp;
You can expand each product to see the change details.&nbsp; For example, let's expand VROOM BUSINESS.&nbsp;
&nbsp;
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Change_Details_319c2f2cd2.jpg" />
&nbsp;
Please note the following:&nbsp;
<ul>
<li>Under the Change Summary Line, you can see the original subscription version, e.g. SUB-001184 v1</li>
<li>For each change request, in this example, a Renewal and an Update Quantity request, there is a Change Line generated that captures the subscription term changes and the price changes.&nbsp;&nbsp;
<ul>
<li>In each Change Line, the Quantity field captures the Change in Quantity, and the Subscription Term field captures the Change in Subscription Term;&nbsp;</li>
<li>You can also add Delta CMRR, Delta ARR fields to the Line Editor grid, and see the change in CMRR, ARR accordingly;&nbsp;</li>
<li>Each Change Line has a Change Type, which captures the actual changes.&nbsp; We can use this information to analyze the change in ARR for different types of changes.&nbsp;&nbsp;</li>
</ul>
</li>
<li>The Summary Line (the line being expanded) shows the status of the subscription after the changes occur.&nbsp; In this example, after renewal and upsell, the total quantity will be 110 licenses, and the subscription term will be extened to 48 months.&nbsp; When the upsell opportunity is Closed Won, the Summary Line will become the newer version of the subscription.</li>
<li>Let's suppose Smart Revenue wants to add 20 licenses upon renewal, instead of 10.&nbsp; You can click on the 'Edit' icon in the change line to edit the changes.&nbsp; Change the quantity to 20, and click 'Confirm'.&nbsp; The prices are automatically updated according to the new change.&nbsp;&nbsp;</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Click_to_Edit_Changes_f3a5889e30.jpg" />
<h1><a id="cross-sell"></a>Cross-sell and Coterm</h1>
Now we need to add a VROOM PRO product with 10 licenses for the small team Smart Revenue has.&nbsp;&nbsp;
&nbsp;
With Nue, it is super easy to cross-sell a new product.&nbsp; We just need to add VROOM PRO into this change quote.&nbsp;&nbsp;
&nbsp;
<ul>
<li>Click 'Add new product' vertical tab on the right side to open the Select Product panel.</li>
<li>Search VROOM PRO, and drag the price book entry with UOM License/Month into the quote.</li>
<li>When the Product Configurator launches, leave everything as the default configuration, and click Confirm.</li>
<li>Now a popup launches that asks if you want to coterm with VROOM BUSINESS wiht the new End Date of VROOM BUSINESS after it's renewal.<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_9_43_37_PM_91eea2425c.png" /></li>
</ul>
<ul>
<li>This is so smart! I select VROOM BUSINESS and click Confirm.</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Cross_sell_with_co_term_7a90f1f49d.jpg" />
&nbsp;
Well done! Only after a few clicks, you not only upsell an existing subscription upon renewal, but also cross-sell a new product that co-terms with the existing subscription after it is renewed.&nbsp;&nbsp;
&nbsp;
<ul>
<li>Click Save and Exit.&nbsp;&nbsp;</li>
<li>Click the Upsell Opportunity for Smart Revenue, and Close Won the opportunity.&nbsp; This will convert the quote into a Change Order, and activate the order.&nbsp;&nbsp;</li>
<li>Click into account Smart Revenue Inc., and click Manage Customer Lifecycle.&nbsp;&nbsp;</li>
<li>Click Subscriptions tab.</li>
<li>You can see that VROOM BUSINESS Subscription has been updated into V2.&nbsp; The quantity is changed to 120 licenses, and the Start and End Date, the Subscription Term are updated to reflect the renewal of 12 months.&nbsp;</li>
<li>In the Subscription Stream, you can clearly see a renewal, and an expansion.&nbsp;&nbsp;</li>
<li>Click on 'Change History' tab in the subscription panel.&nbsp; You can find the change log.&nbsp;&nbsp;</li>
<li>You can also see a new Subscription VROOM PRO with 10 licenses, cotermed with VROOM BUSINESS version V2.&nbsp;&nbsp;</li>
</ul>
<img style="display: block; margin-left: auto; margin-right: auto;" src="https://nervous-kaput-low.media.strapiapp.com/Screen_Shot_2023_04_25_at_8_29_38_PM_5afd89eaff.png" />
&nbsp;
<hr />
&nbsp;
Congratulations! You have completed the Get Started Guide.&nbsp; You learned to:&nbsp;
<ul>
<li style="text-align: left;">Build complex products and bundles;&nbsp;</li>
<li style="text-align: left;">Create initial quotes, orders, subscriptions, assets and entitlements;&nbsp;</li>
<li style="text-align: left;">Create change quotes and orders to upsell, renew, cross-sell and co-term subscriptions.</li>
</ul>
&nbsp;
&nbsp;
&nbsp;
&nbsp;

large_Lifecycle Manager.png

medium_Lifecycle Manager.png

small_Lifecycle Manager.png

thumbnail_Lifecycle Manager.png

Lifecycle Manager.png

Upsell and Renew Subscriptions

large_Price Builder.png

medium_Price Builder.png

small_Price Builder.png

thumbnail_Price Builder.png

Price Builder.png

Configure Products and Prices

large_Permission Sets.png

medium_Permission Sets.png

small_Permission Sets.png

thumbnail_Permission Sets.png

Permission Sets.png

Nue Object Model - Lifecycle Manager

<h1>Release 2404</h1>
Scheduled on Sunday, 04/28/2024
&nbsp;
<table style="border-collapse: collapse; width: 100%; background-color: #f4ebff; height: 92px;" border="0">
<tbody>
<tr style="height: 92px;">
<td style="width: 99.6244%; height: 92px;">
&nbsp;
<ul>
<li>This update introduces a new revenue model "Credit"&nbsp;for creating prepaid, credit-type products as well as a series of Stripe integration enhancements, including tax details viewing for invoices, credit memos and orders, and collection method preferences setting for invoices, providing more control over payment processes.&nbsp;&nbsp;</li>
</ul>
</td>
</tr>
</tbody>
</table>
&nbsp;
<h2><a id="fe"></a>Feature Enhancements</h2>
<h3><a id="fe-npb"></a>Nue Price Builder</h3>
<h4>One-Time Credit</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Introducing a new revenue model - Credit.&nbsp; Unlike Credit Burndown, Credit offers a fresh approach for businesses to create prepaid, credit-type pricing models.&nbsp; With Credit, users can issue one-time credits, allowing customers to use these as deposits towards future payments or services. For more detailed information, please refer to <a title="One-time Credits" href="https://docs.nue.io/docs/tutorial/tutorial-usage-accelerator/one-time-credits/" target="_blank" rel="noopener">this article</a>.</li>
<li style="font-weight: 400;" aria-level="1">On the Salesforce side, a new value "Credit" needs to be added to the Revenue Model picklist, which is a restricted picklist, on the Product object. Please follow the steps below: (1) Go to Setup &rarr; Object Manager &rarr; Product (Product2) &rarr; Fields &amp; Relationships &rarr; Revenue Model (2) Add a new value: Credit </li>
</ul>
<h3><a id="fe-nlm"></a>Nue Lifecycle Manager</h3>
<h4>Ability to limit Opportunity record types when creating a change quote or order</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">When users check out the change requests in the Change Cart into a change quote or order, they have the option to create a new opportunity. &nbsp;In cases where multiple active record types are linked to the opportunity, only those assigned to users' profiles will be accessible for selection. This significantly simplifies the overall experience of creating opportunities in the change quote or order flow.&nbsp;&nbsp;</li>
</ul>
<h3><a id="fe-nba"></a>Nue Billing Accelerator</h3>
<h4>Customizable payment terms</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Presently, Nue offers the following payment terms: Due Upon Receipt, Net 15, Net 30, Net 45, and Net 60.&nbsp; This enhancement allows admin users to create custom payment terms tailored to their unique business requirements, such as Net 7 or Net 90. These custom payment terms can subsequently be used when creating quotes or orders. The Due Date of the resulting invoices will be calculated based on the selected custom payment terms. For more information, please refer to <a title="Custom Payment Terms" href="https://docs.nue.io/docs/use-cases/custom-payment-terms/" target="_blank" rel="noopener">this article</a>.&nbsp;&nbsp;</li>
</ul>
<h4>Ability to select more than one default payment methods</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Customers now have the flexibility to choose between multiple payment methods when making payments through the Stripe payment URL received via email. This new feature allows users to select either ACH or Credit Card as their preferred payment method for invoices.&nbsp;</li>
<li style="font-weight: 400;" aria-level="1">For upgrade customers wishing to use this feature, please add the &lsquo;Payment Methods&rsquo; field to the detail page layout for Account, Quote, and Order.</li>
</ul>
<h4>Ability to manage the lifecycle of debit memos</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">This update brings enhancements to the Debit Memo feature, including the introduction of a Transaction Date field, a Status field for improved management of the debit memo lifecycle, and refinements to the debit memo creation process. These improvements offer enhanced control and visibility throughout the Debit Memo lifecycle, facilitate upfront review before activation, and ensure seamless synchronization with invoicing actions in Stripe.</li>
</ul>
<h4>Support displaying custom fields for Invoice Item and Credit Memo Item in Nue</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Users can now configure Invoice Item and Credit Memo Item list views to include custom fields, providing greater flexibility in surfacing relevant data columns.</li>
</ul>
<h3><a id="fe-np"></a>Nue Platform</h3>
<h4>API request logs categorized by API keys</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Admin users can now view logs of all API requests made to the Nue system within the last 15 days. This new logging view provides better visibility into API usage patterns and allows admin users to easily monitor which API keys are being used and how heavily they are being utilized.</li>
<li style="font-weight: 400;" aria-level="1">This feature improves transparency around API consumption and allows admin users to quickly isolate issues related to specific API keys if needed.</li>
</ul>
<h4>Use relative dates in the graphQL builder and filters</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Users can now use relative dates when filtering data in GraphQL queries. This allows for more dynamic filters based on values like "Today", "Now", plus/minus a specified number of days/months/years. There is a "Use Absolute Date" option to switch back to the regular date picker if needed.</li>
</ul>
<h4>"Copy ID" for list components</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Users can click the first text or lookup column of each row of any list components in Nue to copy the record ID into the clipboard.&nbsp; This helps users to quickly capture the record ID and use it in the self-service APIs or integrations with 3rd party systems.&nbsp; </li>
<li style="font-weight: 400;" aria-level="1">To copy an ID to the clipboard, users can:&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Locate the item in the list</li>
<li style="font-weight: 400;" aria-level="1">Hover over first non-action column on the list. A "Copy record ID" tooltip will be displayed.&nbsp;</li>
<li style="font-weight: 400;" aria-level="1">Click to copy the record ID.</li>
</ul>
</li>
</ul>
<h4>Enhanced user experience of System Settings page</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">In Nue app, the System Settings experience has been refined with the ability to close modal panels. Previously, users were unable to dismiss Settings modals once opened. Users can now close any Settings modal by clicking the 'X' icon in the top right.&nbsp;This allows users to return to the default Settings state easily after updating configurations or reviewing information.</li>
</ul>
<h4>Ability to see Log Out option when clicking on the profile picture</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">When the user clicks on their Profile picture, a popover menu appears with two options: &ldquo;Edit Profile&rdquo; and &ldquo;Log Out&rdquo;. This enhancement provides a more intuitive way to access the logout functionality.</li>
</ul>
<h3><a id="fe-si"></a>Stripe Integration</h3>
<h4>Ability to view tax details for invoices, credit memos, and orders</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Users can now easily access detailed tax breakdown information for invoices, credit memos, and orders when Stripe Tax is enabled. A new "Tax Breakdown" icon is available in the action column on the invoice, credit memo, and order list views. Clicking the icon opens a popup window displaying the tax breakdown line items.</li>
</ul>
<h4>Collection method preferences for invoices in Stripe</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Finance users can now set their preferred method for collecting invoice payments from customers in Stripe. To configure the collection method preference, navigate to: Nue Settings &rarr; Integrations &rarr; Stripe &rarr; Collection Method Preference</li>
<li style="font-weight: 400;" aria-level="1">The "Automatically Charge" option will attempt to charge the customer's default payment method, falling back to email if no valid method is available; while the "Send Email" option ensures invoices are always emailed to customers with payment instructions, and the "Smart Collection" option intelligently determines whether to charge a stored payment method or send the invoice by email based on the customer's payment capabilities.</li>
<li style="font-weight: 400;" aria-level="1">This new configuration allows finance teams to align invoice collection with their preferred processes while still maintaining flexibility based on the customer's payment capabilities.</li>
</ul>
<h2><a id="bf"></a>Bug Fixes</h2>
<h3><a id="bf-npb"></a>Nue Price Builder</h3>
<h4>Unable to copy Product Code from SKU when a product or bundle is replicated</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">This addresses an issue where the Product Code was not being correctly copied from the SKU when replicating a product or bundle. Please note that the Product Code of the copied product matches the SKU, even if Product Code and SKU were different on the original product.</li>
</ul>
<h3><a id="bf-nlm"></a>Nue Lifecycle Manager</h3>
<h4>Invoice Preview of Account is missing the last date of the term</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">Previously, when previewing invoices for an account, the last date of the subscription term was missing. This bug has been resolved, and the Invoice Preview now correctly displays the last date of the subscription term, the transaction amounts for each month are accurate.</li>
</ul>
<h4>Percentage formula field is not rendered correctly in the Subscription view</h4>
<ul>
<li style="font-weight: 400;" aria-level="1">A rendering issue causing incorrect display of the percentage formula field in the Subscription view has been resolved in this release. The field now renders accurately, ensuring correct representation of data.</li>
</ul>

Release 2404 - 04/28/2024

<h1>Release 2409</h1>
Scheduled on Sunday, 11/10/2024
&nbsp;
<table style="border-collapse: collapse; width: 100%; background-color: #f4ebff; height: 92px;" border="0">
<tbody>
<tr style="height: 92px;">
<td style="width: 99.6244%; height: 92px;">
&nbsp;
<ul>
<li>This release introduces several major feature enhancements across Price Builder, Lifecycle Manager, and Everything Billing, including custom quantity tier attributes for price tags, customizable list views, granular filter management permissions, flexible subscription billing period modifications, and timezone-based usage rating. The update also brings improvements to the Nue Platform with pre-built permission sets and entity-level configurations.&nbsp; &nbsp;In this release, we have introduced a series of Nue permission set groups in Salesforce designed to cater to various user roles, such as Sales Reps, Finance Ops, Deal Desk, and more.</li>
<li>The new package features a core permission set named Nue Basic, which encompasses a fundamental set of permissions necessary for the proper functioning of Nue. This permission set is protected for upgrade to ensure consistency and integrity during updates. It is crucial to assign the Nue Basic permission set to all users who will be using Nue in Salesforce, regardless of their specific user roles, to maintain seamless operation across the platform.</li>
</ul>
</td>
</tr>
</tbody>
</table>
&nbsp;
<h2><a id="fe"></a>Feature Enhancements</h2>
<h3><a id="fe-pb"></a>Price Builder</h3>
<h4>Ability to use custom quantity tier attributes for price tags</h4>
<ul>
<li>This feature allows for more flexible and dynamic pricing based on custom quantity tiers, enabling pricing and discounts to be determined by factors beyond just the line item quantity, such as the number of users, integrations, or any other relevant metric.</li>
<li>Key capabilities are:
<ul style="list-style-type: circle;">
<li>Custom Quantity Tier Attributes: Admin users can now create up to 10 custom quantity tier attributes. Attributes can be mapped to numeric fields on related objects (Quote, Order, Opportunity, Account, or custom objects). Accessible via Settings -&gt; Price Builders -&gt; Quantity Tier Attributes.</li>
<li>Enhanced Price and Discount Tags: New "Quantity Tier Attribute" field available when creating price or discount tags. It allows selection of a custom attribute to determine pricing tiers. Applicable for volume-based pricing models with quantity as the UOM dimension</li>
<li>Dynamic Pricing at Quote/Order Time: Pricing tiers are now determined by the selected quantity tier attribute value. It supports various scenarios like user-based subscription plans or integration-based discounts.</li>
<li>Change Order Support: Update Quantity, Update Term, and Renewal change orders now consider the current quantity tier attribute value. A new option "True up price to current quantity tier" has been added to the modal popup for Adjust Price change orders.</li>
<li>Line Prices Recalculation: Sales reps can recalculate line prices based on the latest quantity tier attribute values.</li>
</ul>
</li>
<li>To start using this feature:
<ul style="list-style-type: circle;">
<li>Navigate to Settings &rarr; &nbsp;Price Builders &rarr; Quantity Tier Attributes</li>
<li>Create your custom attributes and map them to relevant fields</li>
<li>Use these attributes as quantity dimensions your price and discount tags</li>
<li>Update your quoting processes to leverage the new dynamic pricing capabilities</li>
</ul>
</li>
<li>For more information about this feature, please refer to <a href="https://docs.nue.io/docs/tutorial/tutorial-price-builder/quantity-tier-attributes-for-price-tags/" target="_blank" rel="noopener">this article.</a></li>
</ul>
<h3><a id="fe-lm"></a>Lifecycle Manager</h3>
<h4>Customizable list view fields in the Product Configurator</h4>
<ul>
<li>Sales reps can now personalize their list view layouts with browser-persistent configurations, while administrators can manage field visibility through the following field sets: Product Columns on Product object, Product Option Columns on Product Optio object, and Product Configurator Columns on Quote Line Item object.&nbsp;&nbsp;</li>
<li>The enhancement maintains backward compatibility, and doesn't affect the grid view functionality. For more information, please reference <a href="https://docs.nue.io/docs/tutorial/tutorial-integrations/nue-on-salesforce-configurations/" target="_blank" rel="noopener">Nue on Salesforce Layout Configuration</a>.&nbsp;&nbsp;</li>
</ul>
<h4>Custom filter management permissions</h4>
<ul>
<li>In this release we've introduced granular permissions for managing product filters in the Nue Product Configurator on Salesforce. The following three new permissions have been added:
<ul style="list-style-type: circle;">
<li>Create Nue Custom Filter: Allows users to create new custom filters and manage their own filters</li>
<li>Edit Nue Custom Filter: Enables users to modify any existing custom filters</li>
<li>Delete Nue Custom Filter: Permits users to remove any existing custom filters</li>
</ul>
</li>
<li>Filter ownership and permissions
<ul style="list-style-type: circle;">
<li>New filters are automatically assigned to their creator</li>
<li>Existing filters will not have an initial owner. First editor of an ownerless filter becomes its owner.</li>
<li>Users can always manage their own filters</li>
<li>Editing others' filters requires the "Edit Nue Custom Filter" permission</li>
<li>Deleting others' filters requires the "Delete Nue Custom Filter" permission</li>
</ul>
</li>
<li>This feature provides organizations with better control over who can create, edit, and delete custom filters, improving filter management for larger teams. For more information, please check out <a href="https://docs.nue.io/docs/tutorial/tutorial-quote-builder/manage-filters/" target="_blank" rel="noopener">this article</a>.&nbsp;&nbsp;</li>
</ul>
<h3><a id="fe-eb"></a>Everything Billing</h3>
<h4>Ability to modify subscription billing periods during renewal</h4>
<ul>
<li>Sales reps can now change subscription billing periods (e.g., from quarterly to annual) when creating change orders or quotes, providing much-needed flexibility in billing management.</li>
<li>When creating a change order, users can modify the billing period on the general page, with a confirmation dialog to decide whether to override all existing line items' billing periods or maintain their original settings.</li>
<li>The billing period field is editable for summary line items in the line editor while remaining read-only for change lines, ensuring consistent billing period updates across related items.</li>
<li>After activation, the new billing period is synchronized with Nue and applies to any unbilled terms, meaning if a quarterly subscription has been partially billed and is changed to annual, the remaining period will follow the new annual billing cycle.</li>
</ul>
<h4>Rate and bill usage based on the Sales Account's timezone</h4>
<ul>
<li>We're introducing account-level timezone management to ensure accurate usage calculation and billing based on each customer's specific timezone.</li>
<li>Key improvements
<ul style="list-style-type: circle;">
<li>Salesforce Account Timezone Management
<ul style="list-style-type: square;">
<li>Added new picklist field Ruby__Timezone__c to Account object</li>
<li>Timezone options match Nue Organization Timezone selections</li>
<li>Automatic timezone inheritance for new subscriptions during order activation</li>
<li>Existing subscriptions maintain their current timezone settings</li>
</ul>
</li>
<li>Usage Rating and Billing Enhancements
<ul style="list-style-type: square;">
<li>Usage rating now respects customer's timezone settings</li>
<li>Improved billing schedule management for multi-timezone operations</li>
<li>Enhanced usage grouping based on subscription timezones</li>
</ul>
</li>
</ul>
</li>
<li>This feature addresses critical timezone-related issues affecting usage aggregation and invoice generation for customers operating across multiple timezones.</li>
</ul>
<h4>UI enhancements to Invoice detail and Credit Memo detail screens</h4>
<ul>
<li>Finance operations users can now manage an invoice directly from the invoice or credit memo detail page with the ability to activate, cancel, or delete the invoice or credit memo.</li>
<li>The credit memo detail page now offers comprehensive visibility into associated invoices, displaying key information such as amount, balance, dates, and payment status, creating a more streamlined billing management experience.</li>
</ul>
<h4>Collections webhook events</h4>
<ul>
<li>Collections webhook events are essential for integrating Nue with external collection systems like QuickBooks or NetSuite. They enable real-time synchronization, ensuring that payment updates or status changes are instantly reflected in Nue without manual intervention.</li>
<li>Webhook events introduced in this release
<ul style="list-style-type: circle;">
<li>Invoice Payment Processed: Triggered when an invoice payment attempt succeeds.</li>
<li>Invoice Refund Processed: Triggered when an invoice refund attempt succeeds.</li>
<li>Invoice Paid: Triggered when an invoice payment status is marked as paid.</li>
<li>Invoice Refunded: Triggered when an invoice payment status is marked as refunded.</li>
<li>Invoice Written Off: Triggered when an invoice has been written off or partially written off.</li>
<li>Invoice Unpaid: Triggered when an invoice has been unpaid.</li>
<li>Credit Memo Applied: Triggered when a credit memo is applied to an invoice or a debit memo.</li>
<li>Credit Memo Unapplied: Triggered when a credit memo is unapplied from an invoice or a debit memo.</li>
</ul>
</li>
<li>For detailed information about Nue webhooks, please refer to <a href="https://docs.nue.io/docs/tutorial/tutorial-integrations/webhooks/" target="_blank" rel="noopener">this article</a>.</li>
</ul>
<h4>Support Segoe UI Light font style for invoice templates and order forms</h4>
<ul>
<li>Users can now choose the Segoe UI Light font style for their invoice templates and order forms. This enhancement allows for greater flexibility in document design, ensuring that users can maintain a consistent and professional appearance in their business communications.</li>
</ul>
<h3><a id="fe-np"></a>Nue Platform</h3>
<h4>Pre-built permission sets for different roles</h4>
<ul>
<li>This release introduces a set of predefined permission sets tailored to various user roles within Salesforce, aiming to simplify the permission configuration process for customers by providing role-specific permissions out of the box.</li>
<li>Salesforce limitations prevent packaging standard objects and fields into a prebuilt fieldset. Users must follow the setup guide to add these manually to the "Nue Basic" and "Nue System Administration" permission sets after installing the Nue on Salesforce package.</li>
<li>Detailed documentation and setup guides are available at: <a href="https://docs.nue.io/docs/tutorial/tutorial-integrations/nue-on-salesforce-permission-sets/" target="_blank" rel="noopener">Nue on Salesforce Permission Sets</a>.</li>
</ul>
<h4>Configure language locales and document templates for entities</h4>
<ul>
<li>In this release we've added the ability to configure Language Locale and document templates at the entity level for more granular control over Invoice and Quote PDF generation.</li>
<li>Three new fields have been added to the entity create/update UI:
<ul style="list-style-type: circle;">
<li>Language Locale: Default to the Language Locale of the organization. The language locale of the entity will be used to format the currency, numbers and dates in the PDF. &nbsp;If there is no Language Locale, then the organization locale will be used.</li>
<li>Invoice Template and Quote Template: Entity-level templates serve as fallback options when no specific template is set on the Invoice / Quote.</li>
</ul>
</li>
<li>Please note that existing PDFs and templates are not affected by this change.</li>
</ul>
<h2><a id="bf"></a>Bug Fixes</h2>
<h3><a id="bf-lm"></a>Lifecycle Manager</h3>
<h4>Price tag propagation from Parent to Child is not working as expected</h4>
<ul>
<li>This issue affected the workflow of sales reps who rely on pre-applied price tags at the parent bundle level to streamline their quoting process. The recent fix addresses the propagation issue, ensuring that price tags are now correctly applied from the parent bundle to all child bundles.</li>
</ul>
<h4>Unable to close won opportunities when their quote names are longer than 80 characters</h4>
<ul>
<li>We have implemented a fix that automatically truncates the quote name to 80 characters when closing a won opportunity. This ensures that users can now close won opportunities without encountering errors, even if their quote names are longer than 80 characters.</li>
</ul>
<h4>Subscription renew stuck to Year instead of Month and default to 12</h4>
<ul>
<li>Previously, when renewing a subscription with a default term of 12 months, the renewal dialog incorrectly defaulted to years and could not be switched back to months. This bug has been fixed to ensure that the renewal dialog now correctly allows users to select between months and years.</li>
</ul>
<h4>Quote Header subscription term is not updated when the Quote Line Items are updated</h4>
<ul>
<li>Previously, when users created a quote with a bundle and then updated the Quote Line Items, the Quote Header subscription term did not update accordingly. This issue has been resolved. Quote Header now accurately reflects the subscription term based on the earliest Start Date and the latest End Date of the Quote Line Items.</li>
</ul>
<h4>The Min/Max/Allow editing of product quantity on a product option in a bundle is not enforced on a Quote Line Item when the Quote Line Item has ramp lines</h4>
<ul>
<li>Previously, there was a problem where the Min/Max/Allow editing of product quantity on a product option in a bundle was not enforced on a Quote Line Item when the Quote Line Item had ramp lines. This issue has been fixed in this release. The fix ensures that the Min/Max/Allow editing of product quantity settings are consistently enforced on Quote Line Items.</li>
</ul>
<h4>Editing pre-applied ramp tags adds extra ramp lines on top of the previous ramp tags</h4>
<ul>
<li>Users experienced issues with unnecessary ramp lines, inability to delete ramp lines, and reversed start and end dates when editing pre-applied ramp tags on quote lines. This issue has been resolved. The bug fix ensures accurate application and deletion of ramp tags, enhancing the usability of the ramp tagging feature.</li>
</ul>
<h4>The pricing fields on default line bucket won't update with changes on the quote</h4>
<ul>
<li>The pricing fields on the default line bucket were not updating with changes made on the quote. Specifically, when a discount amount was modified on the quote header, the default line bucket did not reflect this change, leading to discrepancies in the discount amount and total price/amount on the generated order.</li>
<li>The issue has been resolved. Now, when the discount amount is updated on the quote header, the default line bucket will correctly reflect the new discount amount, ensuring accurate pricing and totals on all generated orders.</li>
</ul>
<h4>Sales price for the updated quantity is incorrect when updating the quantity of an asset in an order</h4>
<ul>
<li>Previously, when updating the quantity of an asset in an order, the sales price for the updated quantity was incorrectly calculated, resulting in a negative discount. We have fixed this issue in this release. The system now correctly calculates the sales price for the updated quantity without applying a negative discount, ensuring accurate and consistent pricing for all orders.</li>
</ul>
<h4>Quote line billing period gets overwritten by header level billing period upon order creation</h4>
<ul>
<li>Previously, when creating an order from a quote that included line items with different billing periods (e.g., Annual and Monthly), all line items would inherit the billing period from the quote header level.</li>
<li>With this fix, the billing period set at the quote line level will now be preserved upon order creation. This ensures that users can maintain the intended billing periods for each line item, providing greater flexibility and accuracy in billing.</li>
</ul>
<h4>Before/After Calculation on UI Plugin does not show the correct value of Quote custom field in the header</h4>
<ul>
<li>We've fixed a critical issue where the Before/After Calculation UI Plugin wasn't reflecting updated values of Quote custom fields in the header, instead persisting the original value throughout subsequent changes.</li>
<li>The fix ensures that when Quote custom field values are updated in the header, the plugin now correctly displays and uses the current value for calculations, particularly important for implementations using these fields for custom UI Plugin calculations.</li>
</ul>
<h3><a id="bf-eb"></a>Everything Billing</h3>
<h4>Unable to delete canceled orders from Nue</h4>
<ul>
<li>When attempting to delete a canceled order in Salesforce, the system reported an error and the order was not deleted from Nue. This issue has been resolved in this release.</li>
</ul>

Release 2409 - 11/10/2024

large_ObjectModelCover.jpg

medium_ObjectModelCover.jpg

small_ObjectModelCover.jpg

thumbnail_ObjectModelCover.jpg

ObjectModelCover.jpg

Nue Object Model Overview

large_Stripe Integration Cover.jpg

medium_Stripe Integration Cover.jpg

small_Stripe Integration Cover.jpg

thumbnail_Stripe Integration Cover.jpg

Stripe Integration Cover.jpg

Stripe Integration

<h1>NetSuite Integration Setup</h1>
This document details the steps required to set up NetSuite and Nue to prepare for the following NetSuite integration:
<ul>
<li><a title="NetSuite ARM Connector" href="https://docs.nue.io/docs/tutorial/tutorial-integrations/netsuite-integration/" target="_blank" rel="noopener">NetSuite ARM Connector</a></li>
</ul>
<h1><a id="netsuite-setup"></a><a id="setup-netsuite"></a>Setup NetSuite</h1>
<h2><a id="permissions"></a>Permissions</h2>
To configure NetSuite and install the connector, you need Administrator or a similar role with adequate permissions.
<h2><a id="enable-features"></a>Enable Required Features</h2>
Ensure that Token-Based Authentication and SuiteAnalytics are enabled:
<ol>
<li>Navigate to Setup &gt; Company &gt; Enable Features.</li>
<li>On the SuiteCloud tab, check Token-Based Authentication.</li>
<li>On the Analytics tab, check SuiteAnalytics Workbook.</li>
</ol>
<h2><a id="create-custom-fields"></a>Create Custom Fields on the Transaction Line Object</h2>
In the Object Transaction Line, we are using the following fields to integrate with NetSuite ARM:&nbsp;
&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">custcol_nue_transactionlineid</li>
<li style="font-weight: 400;" aria-level="1">custcol_nue_term</li>
<li style="font-weight: 400;" aria-level="1">custcol_nue_start_date</li>
<li style="font-weight: 400;" aria-level="1">custcol_nue_end_date</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Create_Custom_Fields_ee56c2e955.jpg" alt="Create Custom Fields.jpg" />
<h2><a id="revenue-field-mapping"></a><a id="revenue-fields"></a>Revenue Fields Mapping for Revenue Recognition</h2>
To automate revenue plans in NetSuite ARM, follow the steps below to setup the field mapping:&nbsp;
&nbsp;
<ul>
<li>Login to NetSuite</li>
<li>Navigate to Setup &rarr;&nbsp; Accounting &rarr;&nbsp; Revenue Field Mapping &rarr;&nbsp; New</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Rev_Rec_Map_the_fields_Menu_5e8b193e9b.jpg" alt="Rev. Rec. Map the fields Menu.jpg" />
&nbsp;
<ul>
<li>Configure the following:
<ul>
<li>Source Record Type: Transaction Line</li>
<li>Source Field IDs: <code>custcol_nue_start_date</code>&nbsp;&rarr; Start Date; <code>custcol_nue_end_date</code>&nbsp;&rarr; End Date</li>
</ul>
</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Rev_Rec_Map_the_fields_4d0e56dc9d.jpg" alt="Rev. Rec. Map the fields.jpg" />
&nbsp;
If these fields are already mapped, verify that the configuration correctly populates the values from Nue.
<h1><a id="nue-setup"></a><a id="setup-nue"></a>Setup Nue</h1>
<h2><a id="permissions"></a>Permissions</h2>
The following permissions must be enabled in the user role:&nbsp; 
<ul>
<li>Integrations
<ul>
<li>Manage NetSuite Integration</li>
</ul>
</li>
<li>Collections
<ul>
<li>View Payment Application</li>
<li>Manage Payment Application</li>
</ul>
</li>
</ul>
<h2><a id="netsuite-connection"></a><a id="setup-netsuite-connection"></a>Setup NetSuite Connection</h2>
Next, follow these steps to set up the NetSuite Connector in Nue:
<ul>
<li class="p1">Go to System Settings.</li>
<li class="p1">Search for NetSuite Integration.</li>
<li class="p1">Click Configure to launch the Config-Wizard.</li>
<li class="p2">On the Config-Wizard page:
<ul>
<li class="p3">Create &ldquo;API Key-based&rdquo; authentication for Nue.&nbsp; Please follow the steps documented <a href="https://docs.nue.io/docs/tutorial/tutorial-the-nue-platform/api-keys/" target="_blank" rel="noopener">here</a> to retrieve your Nue API Key.&nbsp; We recommend creating a dedicated API Key for the NetSuite Connector.&nbsp;&nbsp;</li>
<li class="p3">Set up &ldquo;Token-Based&rdquo; authentications for NetSuite. This requires configuring both REST and SOAP connectors separately.&nbsp; Please follow the steps in the section below to retrieve NetSuite Credentials.&nbsp;&nbsp;</li>
</ul>
</li>
<li class="p2">Complete the remaining settings and click Finish to finalize the configuration.</li>
</ul>
<h3><a id="retrieve-netsuite-credentials"></a>Retrieve NetSuite Credentials</h3>
Nue integrates with NetSuite using Token-Based Authentication. You will need the following credentials to complete the setup:
&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Account ID</li>
<li style="font-weight: 400;" aria-level="1">Consumer key and Consumer Secret</li>
<li style="font-weight: 400;" aria-level="1">Token ID and Token Secret</li>
</ul>
<h4><a id="account-id"></a>Account ID</h4>
<ul>
<li>Login to NetSuite</li>
<li>Navigate to Setup &rarr;&nbsp; Company &rarr; Company Information</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Company_Information_e53399250a.jpg" alt="Company Information Menu.jpg" />
<ul>
<li class="p1">Copy your Account ID at the bottom of the right-hand column.</li>
</ul>
<h4><img src="https://nervous-kaput-low.media.strapiapp.com/Company_Information_2e614a82a4.jpg" alt="Company Information.jpg" /> Consumer Key and Consumer Secret</h4>
<ul>
<li>Login to NetSuite</li>
<li>Navigate to Setup &rarr;&nbsp; Integration &rarr; Manage Integrations &rarr; New</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Integration_Menu_898b8b53e4.jpg" alt="Integration Menu.jpg" />
<ul>
<li class="p1">Fill in the required details.</li>
<li class="p1">Enable Token-Based Authentication and save the record.</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Integration_Tokens_4d7854bb04.jpg" alt="Integration Tokens.jpg" />
<ul>
<li class="p1">Copy the Consumer Key and Consumer Secret from the confirmation page.</li>
</ul>
<table style="border-collapse: collapse; width: 100%; background-color: #f8cac6;">
<tbody>
<tr>
<td style="width: 99.4602%;">
CAUTION
&nbsp;
Note that this information will only be displayed once, so please ensure it is saved elsewhere in a secure place for future setup/requirements.
</td>
</tr>
</tbody>
</table>
<h4><a id="token-id-secret"></a>Token ID and Token secret </h4>
<ul>
<li>Login to NetSuite</li>
<li>Navigate to Setup &rarr;&nbsp; Users/Roles &rarr; Access Tokens &rarr; New</li>
</ul>
<h4><img src="https://nervous-kaput-low.media.strapiapp.com/Access_Token_Menu_0aaba3e384.jpg" alt="Access Token Menu.jpg" /></h4>
<ul>
<li class="p1">
On the Access Tokens page, click New Access Token and select the Application Name associated with the integration record you created earlier
</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Access_Tokens_8dd6c27824.jpg" alt="Access Tokens.jpg" />
&nbsp;
<ul>
<li class="p1">
The Token Name is pre-filled by default as a combination of the Application Name, User, and Role. After completing the setup, the Token ID and Token Secret will be displayed.
</li>
</ul>
<table style="border-collapse: collapse; width: 100%; background-color: #f8cac6;">
<tbody>
<tr>
<td style="width: 99.4602%;">
CAUTION
&nbsp;
Note that this information will only be displayed once, so please ensure it is saved elsewhere in a secure place for future setup/requirements.
</td>
</tr>
</tbody>
</table>
&nbsp;

large_NetSuite Integration.png

medium_NetSuite Integration.png

small_NetSuite Integration.png

thumbnail_NetSuite Integration.png

NetSuite Integration.png

NetSuite Integration Setup

NetSuite Integration - ARM Connector

NetSuite Connector - Fields Mapping

<h1>Understanding Line Types</h1>
Line items within Nue refer to the individual items listed in a quote as quote line items or in an order as order products. Nue categorizes line items into four distinct types, which are as follows:
<ul>
<li>Product Line (LineItem): Represents a regular product line item.</li>
<li>Ramp Line (RampItem): Represents a subscription ramp line item.&nbsp;&nbsp;</li>
<li>Summary Line&nbsp;(SummaryItem): Represents a summary line item.</li>
<li>Split Line (SplitItem): Represents a split line item.</li>
</ul>
<h2><a id="product-line"></a>Product Line</h2>
A regular line item in a quote or order is represented by a product line. Whenever a product is added to a quote or order, a product line is generated. Sales users have the ability to edit various fields of this line, such as Quantity, Subscription Term, Start Date, End Date, Discount, System Discount, and other fields, including custom fields. Nue's embedded Pricing Engine automatically performs calculations and adjustments for relevant pricing fields, such as Total Price, Total Amount, as well as metrics fields like ARR, CMRR, TCV, ACV, ensuring accurate values in real-time.
&nbsp;
In the case of a bundle product being added to a quote or order, a bundle product line is created to represent the bundle itself. Additionally, an individual line item is generated for each add-on or bundled product option that the user configures within the bundle. These add-on or bundled product lines establish a parent-children relationship with the bundle product line.
<h2><a id="ramp-line"></a>Ramp Line</h2>
A ramp line represents a partial line with a consistent monthly Contracted Monthly Recurring Revenue (CMRR) within a specified Start Date and End Date. This type of line is commonly used when applying subscription ramp pricing. For instance, if a recurring product offers a 1-month free trial, when a sales user adds this product to a quote or order with a 12-month subscription term, two ramp lines are created. The first ramp line represents the initial month with a $0 CMRR, while the second ramp line represents the remaining 11 months with a non-zero CMRR. Additionally, a summary line is generated to represent the cumulative amounts for the entire 12-month subscription term.
&nbsp;
When a ramp-type price tag is assigned to a Product Line in Nue, the system automatically divides the product line into multiple ramp lines based on the Starting Unit and Ending Unit specified in the price tag. This division ensures that each ramp line maintains a consistent Contracted Monthly Recurring Revenue (CMRR) within the specified Start Date and End Date of the line.
&nbsp;
Suppose we have a subscription-based product with a 24-month contract term. The pricing for this product follows a ramp structure, where the first 12 months have a discounted rate of $50 per month, and the subsequent 12 months have a regular rate of $100 per month.
&nbsp;
In this case, when adding this product to a quote or order, Nue's pricing engine automatically splits the product line into two ramp lines based on the specified price tag. The first ramp line represents the initial 12 months with a CMRR of $50, and the second ramp line represents the following 12 months with a CMRR of $100.
&nbsp;
The start and end dates for each ramp line align with the corresponding time periods. For instance, the start date for the first ramp line would be the subscription start date, and the end date would be exactly 12 months later. Similarly, the start date for the second ramp line would be 12 months after the subscription start date, and the end date would be the subscription end date.
&nbsp;
This split into ramp lines ensures that the CMRR remains consistent within each period, reflecting the applied pricing structure throughout the subscription duration.
<table style="border-collapse: collapse; width: 100%; background-color: #f4ebff;" border="0">
<tbody>
<tr>
<td style="width: 99.598%;">
NOTE
&nbsp;
Nue ensures that both Product Lines and Ramp Lines have a consistent Delta Contracted Monthly Recurring Revenue (CMRR) throughout all months between their respective Start Date and End Date.
&nbsp;
The specific data structure is designed to simplify the calculation of aggregated Annual Recurring Revenue (ARR) and Contracted Monthly Recurring Revenue (CMRR). To compute the aggregated ARR or CMRR for any given point in time, for any product, customer, or other dimensions, we can retrieve all Product Lines and Ramp Lines with the given date in between their Start Date and End Date. These lines can be grouped based on specific products or customers, and their Delta ARR and Delta CMRR fields can be summarized accordingly.
</td>
</tr>
</tbody>
</table>
<h2><a id="summary-line"></a>Summary Line</h2>
A summary line serves the following 2 purposes:&nbsp;
&nbsp;
Group Ramp Lines: In this use case, the summary line groups ramp lines associated with subscription ramp pricing. For example, consider a scenario where a user opts for a 2-year subscription with a ramp pricing structure that increases the price by 5% in the second year. In this case, there would be a summary line that consolidates and groups the information from the two ramp lines, representing each year of the subscription.
&nbsp;
Group Assets and Changes: In this particular scenario, the summary line combines an asset (which can refer to an asset, subscription, or entitlement) and its corresponding change line, providing a representation of the asset's information after the change has been implemented. For instance, suppose a user has a 12-month subscription with a Start Date of 01/01/2023 and an End Date of 12/31/2023. If the user renews the subscription for an additional 12 months, the change line would reflect a subscription term of 12, with a new Start Date of 01/01/2024 and an End Date of 12/31/2024. Meanwhile, the summary line would indicate a subscription term of 24, with a Start Date of 01/01/2023 and an End Date of 12/31/2024.
<h2><a id="split-line"></a>Split Line</h2>
In the scenario of <a href="../tutorial/tutorial-quote-builder/quote-split/">Quote and Order Split</a>, a quote or order can be divided into multiple line buckets, with each bucket containing two or more regular lines or split lines. The split lines are generated when a single line is split into two separate lines, and each line is assigned to a specific line bucket. These split lines are not visible in the Line Editor but can be viewed on the Split Lines page within the quote or order flow. When a user selects a particular line bucket, the corresponding split lines associated with that bucket are displayed.

large_LifecycleManagerOverview.jpg

medium_LifecycleManagerOverview.jpg

small_LifecycleManagerOverview.jpg

thumbnail_LifecycleManagerOverview.jpg

LifecycleManagerOverview.jpg

Understanding Line Types

<h1><a id="Overview"></a>Overview</h1>
Renewal Opportunities play a major role in the executive dashboards and reporting. Suppose the customer already has an automated flow that creates a Renewal Opportunity as soon as an Opportunity is Closed/Won.
&nbsp;
<ul>
<li>Nue will use this Renewal Opportunity to add a link to associate the Subscription(s) that are created. This association will allow Nue to know which Renewal Opportunity to update each time the Subscription version is updated.</li>
<li>Each time the Subscription version is updated, the Renewal Opportunity will be updated with the following fields:
<ul>
<li>Total TCV (add a field to Opportunity)</li>
<li>Total ACV (add a field to Opportunity)</li>
</ul>
</li>
<li>Also, there are ARR-related formula fields on the Opportunity that will be automatically updated. 
<ul>
<li>ARR (add a field to Opportunity)</li>
<li>Renewal Lost ARR (add a field to Opportunity)</li>
<li>Renewal Target ARR (add a field to Opportunity)</li>
<li>Renewal Won ARR (add a field to Opportunity)</li>
</ul>
</li>
</ul>
<h1><a id="How-It-Works"></a>How It Works</h1>
<h2><a id="Enable-flows"></a>Enable flows</h2>
There are two sample flows within Nue on Salesforce package, you need to clone each of them and make changes according to your business requirements 
Flow 1 : Generate Opportunity Subscriptions
 This flow is used to generate the opportunity subscription(junction table) records between renewal opportunities and subscriptions, and populate the Total ACV and Total TCV to the generated opportunity subscription records:
<ol>
<li>Login to Salesforce org</li>
<li>Navigate to the Flow list page </li>
<li>Open the sample flow &lsquo;Generate Opportunity Subscriptions Sample&rsquo; </li>
<li>Make the changes on the criteria of how to get the renewal opportunity based on the customer&rsquo;s business requirements <img src="https://nervous-kaput-low.media.strapiapp.com/Generate_Opportunity_Subscription_Flow_ce9cbe53a6.jpg" alt="Generate Opportunity Subscription Flow.jpg" /></li>
<li>Save the flow as a new one if necessary </li>
<li>Active the flow, now the flow will generate opportunity subscriptions for the renewal opportunities when subscriptions are updated </li>
<li>NOTE: By default, there is no picklist option &lsquo;Renewal&rsquo; on opportunity Type field, if you are using the default criteria to get renewal opportunity, make sure to add the option to the Type field on Opportunity object first:<img src="https://nervous-kaput-low.media.strapiapp.com/Add_Renewal_Picklist_Value_3a6b75b8e7.jpg" alt="Add Renewal Picklist Value.jpg" /></li>
</ol>
Flow 2: Update Opportunity Subscription ARR
 This flow is used to calculate the ARRs for each subscription and populate the ARRs to opportunity subscription records:
<ol>
<li>Login to Salesforce org </li>
<li>Navigate to the Flow list page </li>
<li>Open the sample flow &lsquo;Update Opportunity Subscription ARR Sample&rsquo; </li>
<li>Make the changes on the criteria of how to get the renewal opportunity based on the customer&rsquo;s business requirements <img src="https://nervous-kaput-low.media.strapiapp.com/Update_Opportunity_Subscription_ARR_Flow_38cd4957bb.jpg" alt="Update Opportunity Subscription ARR Flow.jpg" /></li>
<li>Save the flow as a new one if necessary </li>
<li>Active the flow, now the flow will calculate the ARRs and store them to opportunity subscriptions when asset order products are updated </li>
</ol>
<h2><a id="Add-metrics-fields-to-the-Opportunity-object"></a>Add metrics fields to the Opportunity object</h2>
Please create the following &nbsp;fields on Opportunity Object manually, these fields are not packaged because of the Special Case documented below:&nbsp;
<table style="border-collapse: collapse; width: 100%; height: 240px;" border="1">
<tbody>
<tr style="height: 16px;">
<td style="width: 14.7335%; height: 16px;">
Field Name
</td>
<td style="width: 10.1358%; height: 16px;">
Field Type
</td>
<td style="width: 75.1306%; height: 16px;">
Details
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 14.7335%; height: 32px;">
Total TCV (Nue)
</td>
<td style="width: 10.1358%; height: 32px;">
Roll-Up Summary
</td>
<td style="width: 75.1306%; height: 32px;">
Sum of OpportunitySubscription.TCV where ParentSubscriptionId equals empty
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 14.7335%; height: 32px;">
Total ACV (Nue)
</td>
<td style="width: 10.1358%; height: 32px;">
Roll-Up Summary
</td>
<td style="width: 75.1306%; height: 32px;">
Sum of OpportunitySubscription.ACV where ParentSubscriptionId equals empty
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 14.7335%; height: 32px;">
ARR(Nue)
</td>
<td style="width: 10.1358%; height: 32px;">
Roll-Up Summary
</td>
<td style="width: 75.1306%; height: 32px;">
Sum of OpportunitySubscription.ARR
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 14.7335%; height: 32px;">
Renewal Target ARR (Nue)
</td>
<td style="width: 10.1358%; height: 32px;">
Roll-Up Summary
</td>
<td style="width: 75.1306%; height: 32px;">
Sum of OpportunitySubscription.TargetARR
</td>
</tr>
<tr style="height: 64px;">
<td style="width: 14.7335%; height: 64px;">
Renewal Lost ARR (Nue)
</td>
<td style="width: 10.1358%; height: 64px;">
Formula
</td>
<td style="width: 75.1306%; height: 64px;">
IF(AND(ISPICKVAL(Type,"Renewal"),ISPICKVAL(StageName,"Closed Lost")), RenewalTargetARR_Nue__c ,
IF(AND(ISPICKVAL(Type,"Renewal"),ISPICKVAL(StageName,"Closed Won")), RenewalTargetARR_Nue__c - RenewalWonARR_Nue__c ,
0))
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 14.7335%; height: 32px;">
Renewal Won ARR (Nue)
</td>
<td style="width: 10.1358%; height: 32px;">
Formula
</td>
<td style="width: 75.1306%; height: 32px;">
IF(AND( ISPICKVAL(Type,"Renewal"), ISPICKVAL( StageName ,"Closed Won")), ARR_Nue__c ,0)
</td>
</tr>
</tbody>
</table>
&nbsp;
&nbsp;
<h2><a id="Migrate-for-existing-renewal-opportunities"></a>Migrate for existing renewal opportunities</h2>
Enable the &lsquo;Calculate metrics on a daily basis' setting on Nue to calculate the subscription Today&rsquo;s ARR and Today&rsquo;s CMRR, this will update all subscriptions nightly. The update action will trigger the 'Generate Opportunity Subscriptions' flow to generate opportunity subscription records for existing subscriptions. If you need to see the results immediately, please run the following batchable job from the developer console:
<pre class="language-java"><code>Ruby.SubscriptionMetricsCalculatorBatchable subscriptionMetricsCalculatorBatchable = new Ruby.SubscriptionMetricsCalculatorBatchable();
Database.executeBatch(subscriptionMetricsCalculatorBatchable, 200);</code></pre>
 For &lsquo;Update Opportunity Subscription ARR', it is triggered when asset order product object gets updated. We don&rsquo;t have a daily job to update this object, so for any existing renewal opportunities, if you want to see the latest ARR values, please run the following batchable job from the developer console:
<pre class="language-apex"><code>Ruby.OpportunitySubscriptionARRBatchable opportunitySubscriptionARRBatchable = new Ruby.OpportunitySubscriptionARRBatchable();
Database.executeBatch(opportunitySubscriptionARRBatchable, 200);</code></pre>
&nbsp;
Note : Please make sure to run this code after the &lsquo;Calculate metrics on a daily basis' job gets executed at least once (this will generate the Opportunity Subscription records for renewal opportunities)
&nbsp;
<h1><a id="Additional-Notes"></a>Additional Notes</h1>
When 'Advanced Currency Management' is turned on, you cannot create a rollup summary field on Opportunity object to aggregate the currency type field from the custom child object. So we have to use a workaround in this case, please refer to this doc: <a href="https://help.salesforce.com/s/articleView?id=000386732&amp;type=1">https://help.salesforce.com/s/articleView?id=000386732&amp;type=1</a>
&nbsp;
In the Opportunity Subscription object, we have already introduced some number type fields, and these fields are all populated with the same values as the corresponding currency type fields. If your org has enabled the 'Advanced Currency Management' feature, please create the rollup-summary fields (ARR, Target ARR, Total ACV, Total TCV) on Opportunity object against these number type fields. And then create other formula fields to convert the rollup summary number fields to currency type. This is a workaround for this special case. 
&nbsp;
<h1><a id="Put-It-All-Together"></a>Put It All Together</h1>
The out-of-the-box flows in Nue are a powerful tool that can help organizations optimize their renewal processes, and provide more accurate forecast ARR metrics for the executive team.

large_Renewal Opportunity Process Cover.jpg

medium_Renewal Opportunity Process Cover.jpg

small_Renewal Opportunity Process Cover.jpg

thumbnail_Renewal Opportunity Process Cover.jpg

Renewal Opportunity Process Cover.jpg

Configure Renewal Opportunity Process

<h1>Billing Account Hierarchy</h1>
When dealing with larger companies that have multiple departments, divisions or subsidiaries, having multiple billing accounts can be extremely beneficial in various scenarios. For instance, an organization may wish to track the budgets and expenses of certain departments through separate billing accounts, or multiple subsidiaries may need to use the same billing information. Additionally, some companies may require the billing process to be split based on different regions, products or currencies.
&nbsp;
Nue accommodates two primary scenarios to fulfill the mentioned requirements:
1. A single sales account associated with multiple billing accounts; 2. Multiple sales accounts use a shared billing account.
&nbsp;
<h2><a id="Sales_Account_with_Multiple_Billing_Accounts"></a>A single sales account with multiple billing accounts</h2>
In Salesforce, Nue utilizes a single Account object for both sales and billing purposes. Typically, this account is referred to as a 'Sales Account' and is managed by sales representatives to oversee the sales process. If you create another account and link it to the sales account through the Related Account (Ruby__RelatedAccount__c) junction object, the newly created account will be recognized as a 'Billing Account' for the associated 'Sales Account'.
&nbsp;
Suppose you have a sales account called 'Nue'. In this case, it will automatically be used for billing purposes. However, if you want to bill some of its orders using a different account, you can create a new billing account called 'Nue - Billing Account' and link it to the 'Nue' sales account. This will allow you to select a different billing account when creating an order, and thus process billing through different billing accounts
<img src="https://nervous-kaput-low.media.strapiapp.com/Billing_Process_through_Multiple_Billing_Accounts_9de0a5b196.jpg" alt="Billing Process through Multiple Billing Accounts.jpg" />
&nbsp;
<table style="border-collapse: collapse; width: 100%; background-color: #f1eafe;" border="0">
<tbody>
<tr>
<td style="width: 99.5708%;">
&nbsp;NOTE&nbsp;
&nbsp;
A Sales Account is also treated as a Billing Account. This means that when placing an order for a sales account, it will be used as the order's billing account by default.
&nbsp;
</td>
</tr>
</tbody>
</table>
&nbsp;
You can add the billing account 'Nue - Billing Account' to the sales account 'Nue' on its detail page.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Add_Billing_Account_e01af9cbfa.jpg" alt="Add Billing Account.jpg" />
&nbsp;
Now on the customer's lifecycle manager of sales account 'Nue', you should be able to see the associated billing account 'Nue - Billing Account' as well.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Billing_Accounts_c62ecf7db2.jpg" alt="Billing Accounts.jpg" />
&nbsp;
<h3><a id="Select_Different_Billing_Accounts"></a>Use different billing accounts when creating a quote or an order</h3>
By default, the billing account for a quote or order will match the sales account. However, if the customer has multiple billing accounts, you have the option to select a different one during the quote or order creation process. Once the quote is finalized and converted into an order, the selected billing account will be carried over to the newly generated order as well.
&nbsp;
When you select a billing account, you will see the billing accounts that are already associated with the current sales account listed under the 'RELATED BILLING ACCOUNTS' section. You can also choose any account that is not a billing account of the current sales account from the 'OTHER ACCOUNTS' section. After the quote is finalized into an active order, the selected account will automatically become a billing account of the sales account.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Select_Billing_Account_on_Quote_68aafa935d.jpg" alt="Select Billing Account on Quote.jpg" />
&nbsp;
<h3><a id="Bill_Subscriptions_With_Billing_Accounts"></a>Bill subscriptions with different billing accounts</h3>
Upon order activation, the resulting subscriptions will carry the billing account details from the orders. During each billing cycle, when billing jobs are executed, invoices will be generated based on the billing account linked to each subscription. For example, if a customer named 'Nue' has two subscriptions&mdash;one using 'Nue' as the billing account directly and the other associated with a separate billing account called 'Nue - Billing Account'&mdash;the two subscriptions will be billed separately. Consequently, there will be a distinct invoice generated for each billing account.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Invoices_for_Billing_Accounts_3c675d9edc.jpg" alt="Invoices for Billing Accounts.jpg" />
<h2><a id="Sales_Accounts_Share_Same_Billing_Account"></a>Multiple sales account use a shared billing account</h2>
It is also common for different departments, divisions, or subsidiaries to share the same billing account. This can help streamline the payment process and simplify accounting procedures for the organization as a whole. For instance, individual departments may buy products or services from a vendor independently, but the organization will receive a combined invoice for all the items purchased by its various departments.
&nbsp;
<h3><a id="Sales_Account_Hierarchy"></a>Sales account hierarchy</h3>
Salesforce supports the account hierarchy, you can build your sales account hierarchy via the Parent Account field. For example, the customer 'Nue' has two subsidiaries 'Nue - San Francisco' and 'Nue - Los Angeles', you can create two child accounts and link them to 'Nue' as a parent account.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/New_Child_Account_447fb7478a.jpg" alt="New Child Account.jpg" />
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Sales_Account_Hierarchy_97f05a1da4.jpg" alt="Sales Account Hierarchy.jpg" />
&nbsp;
Now when you navigate to the customer lifecycle for 'Nue', you can see all its related child accounts and billing accounts:
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Child_Sales_Accounts_ebc2862943.jpg" alt="Child Sales Accounts.jpg" />
&nbsp;
<h3><a id="Bill_With_Same_Billing_Account"></a>Bill multiple sales accounts with the same billing account</h3>
When generating quotes and orders, users can choose to use the billing accounts of the customer's parent account if it exists. This allows multiple child accounts to share the same billing account associated with their parent.
<img src="https://nervous-kaput-low.media.strapiapp.com/Billing_Process_Share_Same_Billing_Account_88a8f75eb8.jpg" alt="Billing Process Share Same Billing Account.jpg" />
&nbsp;
Let's consider an example of creating orders for two customers - 'Nue - San Francisco' and 'Nue - Los Angeles'. By default, the billing accounts for these orders are the customers themselves. However, if 'Nue' wishes to streamline the payment and accounting process, when creating the orders, users can choose to set the billing account to the parent account's billing account - 'Nue - Billing Account'.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Select_Parent_Billing_Account_on_Quote_78b00d1326.jpg" alt="Select Parent Billing Account on Quote.jpg" />
&nbsp;
Then the orders and the generated subscriptions for each child account will have the same billing account information.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Orders_with_Same_Billing_Account_e307ce35b8.jpg" alt="Orders with Same Billing Account.jpg" />
&nbsp;
In the next billing cycle, the orders will be billed together through the billing account 'Nue - Billing Account'
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Bill_Subscriptions_Together_b7aaae308f.jpg" alt="Bill_Subscriptions_Together.jpg" />
&nbsp;
<h2><a id="Summary_In_Lifecycle_Manager"></a>Set up billing schedules using billing accounts</h2>
When configuring a billing schedule, you can filter for specific accounts to generate invoices exclusively for them.
&nbsp;
If a sales account is linked to multiple billing accounts, all subscriptions associated with those billing accounts will be billed together. Additionally, you have the option to include subsidiaries in the billing process. For instance, if you run a billing schedule for 'Nue' and select the 'Include Subsidiaries' option, subscriptions for 'Nue - San Francisco' and 'Nue - Los Angeles' will also be billed.
<img src="https://nervous-kaput-low.media.strapiapp.com/Billing_Schedule_Customer_Filter_1_004e79580e.jpg" alt="Billing Schedule Customer Filter 1.jpg" />
&nbsp;
<h2><a id="Billing_Account_Owner_Transfer"></a>Change billing account</h2>
When a company undergoes organizational restructuring or acquires other companies, it may be necessary to transfer existing subscriptions from one billing account to another. In this case, users can change the billing account of a subscription when checking out any changes to a change order. After the change order is activated, the subscription will be billed through the new billing account.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Owner_Transfer_dd564b9a8b.jpg" alt="Owner Transfer.jpg" />
<h2><a id="Additional_Notes"></a>Additional Notes</h2>
<ul>
<li>If account B is linked to account A through the Related Account (Ruby__RelatedAccount__c) junction object, account B will be considered a billing account for account A. Nue does not have any limitations on billing accounts, so you can still use it for managing sales processes, creating orders and subscriptions, and so on. However, we suggest separating the use of sales and billing accounts if you need multiple billing accounts for a customer.</li>
<li>When processing billing for customers, the generated invoices will be based on the associated billing accounts instead of the customers themselves. For example, customer A has linked billing accounts B and C, if you run a billing job for customer A, the generated invoices will be grouped by billing accounts B and C.</li>
<li>If multiple sales accounts share the same billing account, by default, the generated invoices will be grouped by the billing account. But users can choose to generate invoices for each sales account separately by enabling the 'Sales Account' billing group attribute from Nue System Settings -&gt; Billing -&gt; Billing Groups. For more details, please refer to <a title="Billing Groups" href="https://docs.nue.io/docs/tutorial/tutorial-billing-accelerator/billing-groups/" target="_blank" rel="noopener">Billing Groups</a>.</li>
<li>When you create a quote or order, you are able to choose any billing accounts connected to the current sales account and its ancestor accounts by default. If you need to customize the available options, you can add a lookup filter plugin to the Billing Account field on the Quote or Order object. To learn more about how to add a lookup filter plugin, please refer to <a href="https://docs.nue.io/docs/how-to-guide/how-to-guide-nue-platform/lookup-filter-plugin/" target="_blank" rel="noopener">this article</a>.</li>
</ul>
<h2><a id="summary-view"></a>Summary view in the lifecycle manager</h2>
Within the customer's Lifecycle Manager, the 'General' table offers an aggregated perspective of an account, available in Grid View, List View, and Summary View formats, provided the current account has associated children sales accounts or billing accounts.
&nbsp;
The fields visible in any of these views are governed by a field set named "Customer Fields" within the Account object in Salesforce. To tailor the layout of these views, you can configure the fields included in this field set, and their sort order.&nbsp;&nbsp;
&nbsp;
<h3><a id="grid-view"></a>Grid View</h3>
The Grid View in the General tab allows you to view your current sales account and its child accounts, as well as the associated billing accounts.
&nbsp;
<ul>
<li>The first card displayed will always be your current sales account.</li>
<li>Additionally, the child accounts and billing accounts have distinct appearances, making it easy for users to distinguish between them.</li>
<li>If you click the name of the child account, you will be navigated to the lifecycle of the child account.</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Life_Cycle_Manager_Introduction_da910bcb6a.jpg" alt="Life Cycle Manager - Introduction.jpg" />
&nbsp;
Users can also see the orders and subscriptions associated with the current account and its billing accounts.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Life_Cycle_Manager_Orders_227904962c.jpg" alt="Life Cycle Manager - Orders.jpg" />
<h3><a id="list-view"></a>List View</h3>
The list view presents a structured table containing all relevant account details, including the information of the current account, its children sales account, and their associated billing accounts.&nbsp;&nbsp;
<h3><a id="summary-view"></a>Summary View</h3>
The summary view presents a comprehensive view of the current account, its children accounts, and related billing accounts.&nbsp; The view includes the follow components:&nbsp;
<h4>Account Card</h4>
The account card that shows the account image, as well as a list of configurable account fields.&nbsp; The following 3 fields are displayed dynamically if the current account has children sales accounts:&nbsp;
<ul>
<li>Today's Rollup ARR
<ul>
<li>Indicates Today's ARR rollup from all children sales accounts in the sales account hierarchy.</li>
</ul>
</li>
<li>Today's Rollup CMRR
<ul>
<li>Indicates Today's CMRR rollup from all children sales accounts in the sales account hierarchy.&nbsp;&nbsp;</li>
</ul>
</li>
<li>Rollup TCV
<ul>
<li>Indicates the total TCV rollup from all children sales accounts in the sales account hierarhcy.</li>
</ul>
</li>
</ul>
<h4>Account Revenue Stream</h4>
The focal point is a "Revenue Stream" chart presenting account-level revenue streams sourced from subscriptions aggregated across all child sales accounts.
&nbsp;
By default, this chart illustrates the combined revenue stream generated by all subscriptions across child accounts. Upon toggling the "Show Subscription" switch, it conveniently disaggregates revenue streams for individual subscriptions, consolidated at the product level. For instance, if multiple child accounts hold subscriptions for "Conversational Intelligence," the chart displays the total revenue streams for this product.
&nbsp;
To enhance visualization, only the top 3 active product subscriptions are listed, with additional products grouped under the "Other" category.
&nbsp;
Furthermore, users can utilize the "Sales Accounts" dropdown to switch between various sales accounts. By toggling between "Sales Accounts" and "Subscriptions," users can dynamically analyze the revenue stream by both sales accounts and products.
<img src="https://nervous-kaput-low.media.strapiapp.com/Customer_Management_b5a9b10d13.png" />
<h4>Related Accounts</h4>
Within the Related Accounts component, there are 2 tabs: Children Accounts and Billing Accounts.
&nbsp;
The Children Accounts tab showcases all child accounts of the current account in a hierarchical structure, expanded by default.
&nbsp;
The Billing Accounts tab shows all billing accounts linked to the current account. For instance, "Walt Disney Corporation" serves as a billing account referencing Disney as its sales account. Disney, in turn, holds a descendant account named "Disneyland Paris." Another billing account, "Theme Park Partner," refers to "Disneyland Paris" as its sales account. In this scenario, both "Walt Disney Corporation" and "Disneyland Paris" will be visible on the Billing Accounts tab.
&nbsp;
On both tabs, users can click on the "Eye" icon in each row to navigate to the General view of the Lifecycle Manager corresponding to the respective account.
<h3><a id="view-transactions"></a>Explore transactions and associated objects of related accounts</h3>
Users have the option to inspect orders, subscriptions, assets, entitlements, invoices, credit memos, and more pertaining to related sales accounts within their respective tabs in the Lifecycle Manager.
&nbsp;
If the current account functions as a sales account, users gain visibility into orders, subscriptions, assets, entitlements, invoices, credit memos, and related data not only for the current account but also for all its associated child sales accounts.
&nbsp;
In cases where the current account operates as a billing account, users can access orders, subscriptions, assets, entitlements, invoices, credit memos, and pertinent information not only for the current account itself but also for the sales accounts that designate it as the billing account for transaction invoicing.
<a id="Billing_Schedule_Multiple_Billing_Accounts" style="font-size: 18px;"></a>
&nbsp;
&nbsp;
&nbsp;

large_Multiple Billing Accounts.png

medium_Multiple Billing Accounts.png

small_Multiple Billing Accounts.png

thumbnail_Multiple Billing Accounts.png

Multiple Billing Accounts.png

Billing Account Hierarchy

<h1>Quantity Tier Attributes</h1>
The Quantity Tier Attribute feature allows users to create custom quantity tier attributes for price tags. This feature is particularly useful when the actual price tiers are not directly determined by the quantity of the line item but by other factors such as the number of active users, integrations purchased, or total rooms in a sales account hierarchy.
&nbsp;
When&nbsp;a user creates a price or discount tag, the user can associate the quantity (or term) dimension with the quantity dimension of a UOM.&nbsp;&nbsp;At quoting or order time, the actual unit volume or tier prices is determined by the quantity of the line item.&nbsp;
&nbsp;
Oftentimes, the actual price tiers are not determined by the quantity of the line item directly.&nbsp; The following are some examples.&nbsp;&nbsp;
&nbsp;
Example #1
A Subscription Plan Based on Active Users:
<ul>
<li> Product: A cloud storage service.</li>
<li> Pricing Determinant: Number of active users.</li>
</ul>
The pricing tier for the cloud storage service is based on the number of active users in an account instead of the actual of the storage units. For example, 1-10 users might fall under the basic tier, 11-50 users under the standard tier, and 51-100 users under the premium tier. Each tier offers a different amount of storage space and features.
&nbsp;
Example #2
The tiered discounting of integration products is based on the number of integrations purchased in the quote.&nbsp;&nbsp;
&nbsp;
<table style="border-collapse: collapse; width: 63.4503%; height: 176px;" border="1">
<tbody>
<tr style="height: 29.6875px;">
<td style="height: 29.6875px; width: 100%;" colspan="3">
INTEGEATION DISCOUNTING
</td>
</tr>
<tr style="height: 57.2188px;">
<td style="width: 22.4018%; height: 57.2188px;">
Min
</td>
<td style="width: 29.342%; height: 57.2188px;">
Max
</td>
<td style="width: 48.2562%; height: 57.2188px;">
% Discount
</td>
</tr>
<tr style="height: 29.6875px;">
<td style="width: 22.4018%; height: 29.6875px;">
1
</td>
<td style="width: 29.342%; height: 29.6875px;">
2
</td>
<td style="width: 48.2562%; height: 29.6875px;">
0%
</td>
</tr>
<tr style="height: 29.6875px;">
<td style="width: 22.4018%; height: 29.6875px;">
3
</td>
<td style="width: 29.342%; height: 29.6875px;">
5
</td>
<td style="width: 48.2562%; height: 29.6875px;">
5%
</td>
</tr>
<tr style="height: 29.7188px;">
<td style="width: 22.4018%; height: 29.7188px;">
6
</td>
<td style="width: 29.342%; height: 29.7188px;">
10
</td>
<td style="width: 48.2562%; height: 29.7188px;">
15%
</td>
</tr>
</tbody>
</table>
&nbsp;
Example #3
The discount tiers of a particular product are determined by the Total # of seats in the entire sales account hierarchy.&nbsp;&nbsp;
&nbsp;
In the above examples, the quantity dimension of the price tag is not the quantity dimension of the product UOM itself, but is derived from a field of the related object, which can be quote, account, or even opportunity.&nbsp;&nbsp;
&nbsp;
This is also applicable in a change order.&nbsp; In the example #1, when the number of users of an account is changed, in a change order, e.g., when a quantity is updated, or during the renewal, the sales price will be recalculated according to the tiered pricing determined by the latest number of users.&nbsp;&nbsp;
&nbsp;
In this article, we&rsquo;ll guide you on creating quantity tier attributes and using them as custom quantity dimensions in price tags to implement a real-world business scenario.
&nbsp;
Let's get started!
&nbsp;
<hr />
<h1><a id="use-cases"></a>Use Cases</h1>
We'll be using the following example use case throughout this document.&nbsp;&nbsp;
&nbsp;
<table style="border-collapse: collapse; width: 100%; background-color: #f4ebff;" border="0">
<tbody>
<tr>
<td style="width: 99.4021%;">
EXAMPLE
&nbsp;
Company TeamFlow sells product TeamFlow Pro - an all-in-one project management platform designed for mid-side and large organizations.&nbsp;&nbsp;
&nbsp;
Pricing Model:
TeamFlow Solutions offers a tiered pricing model based on the number of employees in an organization. This structure ensures that businesses of various sizes pay an amount that scales with their workforce.
&nbsp;
Example of Tiered Pricing:
&nbsp;
Tier 1 (1-50 employees):
Cost: $10 per user per month
Includes basic project management features, team chat, and file sharing.
&nbsp;
Tier 2 (51-200 employees):
Cost: $8 per user per month
Includes all Tier 1 features plus advanced reporting, task automation, and priority customer support.
&nbsp;
Tier 3 (201-500 employees):
Cost: $6 per user per month
Includes all Tier 2 features plus custom integrations, enhanced data analytics, and dedicated onboarding support.
&nbsp;
Tier 4 (501+ employees):
Cost: $5 per user per month
Includes all Tier 3 features plus enterprise-level security, unlimited storage, and a dedicated account manager.
&nbsp;
When a sales rep creates a quote for TeamFlow Pro, they will input the estimated number of employees associated with the account, using this field to determine the appropriate user license pricing tier.
&nbsp;
Upon renewing a customer, the sales rep wants to adjust the pricing to match the actual tier based on the current number of employees.
</td>
</tr>
</tbody>
</table>
&nbsp;
To achieve this, the RevOps manager can follow these steps:&nbsp;
<ol>
<li class="p1">Create a quantity tier attribute called &ldquo;Number of Employees,&rdquo; referencing the Number of Employees field on the Account object.</li>
<li class="p1">Develop a tier-based price tag using the Number of Employees as the quantity tier attribute.</li>
<li class="p1">Apply the price tag during the quoting process.</li>
<li class="p1">At renewal, adjust the price to align with the actual tiered price based on the current number of employees of the customer.</li>
</ol>
<h1><a id="create-quantity-tier-attribute"></a>Create and Edit Quantity Tier Attribute</h1>
Similar to a pricing attribute, a Quantity Tier Attribute is a specific field on an object related to Quote Line Item or Order Product, such as Quote, Order, Opportunity, Account or related custom objects, that is used to determine the volume-based pricing tier of a product or service. This attribute represents a particular numeric value or metric that influences the pricing structure, independent of the quantity of the line item itself.
&nbsp;
In the context of the TeamFlow Pro, the quantity tier attribute could be the &ldquo;Number of Employees.&rdquo; This attribute dictates the pricing tier based on the estimated number of employees of account associated with the quote or order.
&nbsp;
Admin users can create Quantity Tier Attributes in Settings &rarr; Price Builders &rarr; Quantity Tier Attributes tile.&nbsp;&nbsp;
&nbsp;
When defining the mapping, admin users can choose any Number-type fields (including formulas) on Quote Line Item, Quote, Opportunity, Account or any custom objects. 
&nbsp;
<table style="border-collapse: collapse; width: 100%; height: 388px;" border="1">
<tbody>
<tr style="height: 16px;">
<td style="width: 17.3664%; height: 16px;">
FIELD NAME&nbsp;
</td>
<td style="width: 82.786%; height: 16px;">
DESCRIPTION
</td>
</tr>
<tr style="height: 16px;">
<td style="width: 17.3664%; height: 16px;">
API Name
</td>
<td style="width: 82.786%; height: 16px;">
The API name of the attribute, which must be unique.
</td>
</tr>
<tr style="height: 16px;">
<td style="width: 17.3664%; height: 16px;">
Name
</td>
<td style="width: 82.786%; height: 16px;">
The name of the attribute , e.g., Number of Employees
</td>
</tr>
<tr style="height: 16px;">
<td style="width: 17.3664%; height: 16px;">
Description
</td>
<td style="width: 82.786%; height: 16px;">
The description of the attribute
</td>
</tr>
<tr style="height: 308px;">
<td style="width: 17.3664%; height: 308px;">
Mapping
</td>
<td style="width: 82.786%; height: 308px;">
The attribute mapping specifies how the field value will be sourced.&nbsp;&nbsp;
 
Only Number-type fields (including formula fields) can be selected.&nbsp;&nbsp;
 
For example,&nbsp;
1. From another number-type values on the same quote line item:
QuoteLineItem&rarr;NumberOfUsers__c
 
2, From the parent line item:&nbsp;
QuoteLineItem&rarr;Parent ID&rarr;NumberofUsers__c
 
3. From the bundle line item:&nbsp;
QuoteLineItem&rarr;Root ID&rarr;NumberOfUsers__c
 
4. From the account:&nbsp;
Quote Line Item&rarr;Quote.Account ID.NumberOfEmployees
 
Please note that the same mapping applies to the Order Product object as well, even though we only need to store the mapping for the Quote Line Item.&nbsp; If the mapping is on a custom field, the admin users are required to create the same custom field on the Order Product object as well.&nbsp;&nbsp;
</td>
</tr>
<tr style="height: 16px;">
<td style="width: 17.3664%; height: 16px;">
Active
</td>
<td style="width: 82.786%; height: 16px;">
The active status of the quantity tier attributes.&nbsp; Available values are True and False.
</td>
</tr>
</tbody>
</table>
&nbsp;
Please follow the steps below to create a new quantity tier attribute called Number of Employees.&nbsp;&nbsp;
<iframe src="https://scribehow.com/embed/Create_New_Quantity_Tier_Attribute__NiasO-nISQSYQA2sBRJKBQ?as=video" width="100%" height="640" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
<h1><a id="create-price-tag-using-quantity-tier-attribute"></a>Create Price Tag using Quantity Tier Attribute</h1>
When a user creates a new price tag or discount tag, and selects Quantity as the Unit of Measure (UOM) dimension and Volume as the price model, a new field called Quantity Tier Attribute will appear. In this field, the user can choose from the available active quantity tier attributes to set tier-based pricing.
&nbsp;
<table style="border-collapse: collapse; width: 100%; background-color: #f4ebff;" border="0">
<tbody>
<tr>
<td style="width: 99.3912%;">
NOTE
&nbsp;
When a sales rep creates a quote or order, the line item&rsquo;s Quantity will continue to be used to calculate the total price. Meanwhile, the Quantity Tier Attribute is used to determine the appropriate price tier for the item. This allows for tier-based pricing based on specific attributes such as the number of employees or units. However, the Quantity Tier Attribute becomes irrelevant when the price model is set to Tiered, as the tiered model already handles pricing based on quantity ranges directly.&nbsp;
</td>
</tr>
</tbody>
</table>
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Price_Tagswith_Quantity_Tier_Attributes_f2418370b5.png" />
<h1>Create a Quote or Order with the Price Tag</h1>
Now, we can create a product called TeamFlow Pro and link its standard price book entry to the price tag we just created.
&nbsp;
Next, we can proceed to create a quote for an account with an estimated number of employees set to 80.
&nbsp;
<ul>
<li class="p1">Log in to Salesforce and navigate to Nue on Salesforce.</li>
<li class="p1">Go to Accounts, and create a new account. In our example, we created an account named &ldquo;Smart Revenue.&rdquo; Edit the account to set the Number of Employees to 80.</li>
<li class="p1">Create a new opportunity for this account and set up a primary quote for it.</li>
<li class="p1">Within the quote, search for the product TeamFlow Pro and add it to the quote, setting the quantity as 1.</li>
<li class="p1">Click on the Price Tag icon to view the pricing details. You will see that the price tier &ldquo;50 - 200&rdquo; is applied, which sets the unit price to $8, though the quantity is 1.&nbsp;</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/quantity_tier_attribute_quotes_1ccd8e7605.png" />
&nbsp;
<ul>
<li class="p1">In the Line Editor, set the quantity to 100. The total amount will update to $9,600, reflecting 12 months for 100 users at a unit price of $8 each.</li>
<li class="p1">Save the quote, and finalize it into an order.&nbsp;</li>
</ul>
<h1><a id="renew"></a>Renew with price adjusted to true-up amount</h1>
The customer Smart Revenue has grown rapidly in size.&nbsp; At renewal time, Smart Revenue now has 250 employees.&nbsp; The Sales Rep would like to renew the customer with the price adjusted to the true-up amount based on the current number of employees.&nbsp;&nbsp;
&nbsp;
The sales rep first updates the "Number of Employees" field of Smart Revenue to 250.&nbsp; Then she can follow the steps below to renew while adjusting the price to the true-up amount:&nbsp;
<ul>
<li>Navigate to Accounts, select the account ("Smart Revenue" in our example), and click "Manage Customer Lifecycle".</li>
<li>Click "Renew" for 12 months, and click "Add to Cart"</li>
<li>Click "Adjust Price", and select the option "True up price to current quantity tier", and click "Add to Cart".&nbsp;</li>
</ul>
The video below provides step-by-step guides to walk you through this scenario.
<iframe src="https://scribehow.com/embed/True-up_price_per_quantity_tier_attribute_upon_renewal__1bV_TruYTjy9eDqAGMbhyw?as=video" width="100%" height="640" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
&nbsp;
<h1><a id="putting-it-altogether"></a>Putting it Altogether</h1>
This feature allow users to create custom quantity tier attributes for price tags, enabling more flexible and accurate pricing models based on various determinants other than the product's unit of measure (UOM). This is particularly useful for scenarios where pricing is influenced by factors such as the number of active users, integrations, or other metrics.
&nbsp;
&nbsp;

large_1.png

medium_1.png

small_1.png

thumbnail_1.png

1.png

Quantity Tier Attributes for Price Tags

Lifecycle Manager Overview

<h1>Late Fees - A Debit Memo Use Case</h1>
A debit memo is a document that records an adjustment to an account to reflect a deduction or charge. &nbsp;For example, when a customer fails to pay an invoice on time, a late fee can be issued as a debit memo, and sent it to the customer as part of the invoice.
&nbsp;
<table style="border-collapse: collapse; width: 100%; height: 106px; background-color: #F4EBFF;">
<tbody>
<tr style="height: 106px;">
<td style="width: 99.5169%; height: 106px;">
PREVIEW
This feature is in preview.&nbsp;&nbsp;
</td>
</tr>
</tbody>
</table>
<h1><a id="how-billing-works"></a></h1>
&nbsp;
&nbsp;
<table style="border-collapse: collapse; width: 100%; background-color: #d3d4de; height: 106px;">
<tbody>
<tr style="height: 106px;">
<td style="width: 99.5169%; height: 106px;">
PERMISSIONS REQUIRED
&nbsp;
Please enable the following permissions in the user role:&nbsp;
&nbsp;
Debit Memo Management
<ul>
<li>View Debit Memos</li>
<li>Create Debit Memos</li>
<li>Activate Debit Memos</li>
<li>Cancel Debit Memos</li>
<li>Delete Debit Memos</li>
</ul>
</td>
</tr>
</tbody>
</table>
<h1><a id="how-billing-works"></a></h1>
&nbsp;
<h1><a id="identify-invoices"></a>Identify Overdue Invoices and Create a Debit Memo</h1>
To create a debit memo for an overdue invoice, you can follow the steps below:&nbsp;
<ol>
<li style="font-weight: 400;" aria-level="1">Log in to your <a href="https://app.nue.io">Nue App</a> and navigate to Revenue Manager &rarr; Invoices</li>
<li style="font-weight: 400;" aria-level="1">If an invoice is overdue, you can see a Late Fee icon next to it.&nbsp; </li>
<li style="font-weight: 400;" aria-level="1">Click on the Late Fee icon to create a debit memo.</li>
</ol>
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_05_30_at_5_01_55_PM_833bc6a8bc.png" />
&nbsp;
In the Create Debit Memo popup, fill up the following information: 
<ul>
<li style="font-weight: 400;" aria-level="1">Amount: Enter the total amount for the debit memo.</li>
<li style="font-weight: 400;" aria-level="1">Tax: Specify the tax amount associated with the debit memo, if applicable.</li>
<li style="font-weight: 400;" aria-level="1">Description: Enter a detailed description of the debit memo, including the reason for issuing it (e.g., &ldquo;Late fee for Invoice #INV-000011&rdquo;).</li>
<li style="font-weight: 400;" aria-level="1">Other optional fields may be available depending on your system configuration.</li>
<li style="font-weight: 400;" aria-level="1">Click Save and Close</li>
</ul>
<h1><a id="transfer-to-pay"></a>Transfer Debit Memos to Payment Systems</h1>
After a debit memo is created, it will be automatically transferred as an invoice item to your connected payment system (e.g. <a title="Stripe Integration" href="../../../../tutorial/tutorial-integrations/stripe-integration/" target="_blank" rel="noopener">Stripe</a>) in real-time. This ensures that the debit memo is accurately reflected in the invoice and can be processed for payment.
&nbsp;
The original overdue invoice will be voided in the connected payment system.&nbsp; A new invoice will be created containing the original invoice items, as well as a new "Late Fee" invoice item.&nbsp; The description of the debit memo will be used to identify the additional invoice item in the new invoice.
&nbsp;
The folloiwng image shows the new invoice in Stripe.&nbsp; 
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_05_30_at_5_13_37_PM_ed0b536b2b.png" />
<h1><a id="pay-invoices"></a>Pay Invoices with Debit Memo (Late Fees)</h1>
When an invoice with a debit memo item is paid in Stripe, the payment information will be transferred back to Nue. Two Payment Application records will be generated&mdash;one for the invoice amount and another for the debit memo amount. This allows for accurate tracking and reconciliation of payments associated with both the invoice and the debit memo.
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_05_30_at_5_16_54_PM_9b9ae13d66.png" />
<h1><a id="refund-invoices-with-debit-memos"></a>Refund Invoices with Debit Memos (Late Fees)</h1>
In the event of a partial refund for an invoice that contains a debit memo item, the refund process handles the refund amounts for the invoice and the debit memo separately.&nbsp;
&nbsp;
If the total refund amount is equal to or greater than the original invoice amount, the invoice is considered fully refunded in Nue. For example, the invoice amount is $99, debit memo is $10 and the total refund amount is $100, the invoice will be marked as fully Refunded in Nue.The debit memo will be considered as Partially Refunded.&nbsp; Nue will first process the original invoice first before processing debit memos.
&nbsp;
When refunds happen, 2 credit memo records will be created containing the refunded amounts, one for the original invoice, and one for its associated debit memo.&nbsp; If <a title="Credit Memo" href="../../../../tutorial/tutorial-billing-accelerator/invoices-and-credit-memos/" target="_blank" rel="noopener">Credit Memo</a> feature is not enabled in Nue, a negative invoice will be created instead.
&nbsp;
&nbsp;
&nbsp;
 
&nbsp;

large_DebitMemo Cover.jpg

medium_DebitMemo Cover.jpg

small_DebitMemo Cover.jpg

thumbnail_DebitMemo Cover.jpg

DebitMemo Cover.jpg

Late Fees - a Debit Memo Use Case

<h1><a id="Nue_Platform_Settings"></a>Nue Platform Settings</h1>
&nbsp;
<h2><a id="Security"></a>Security</h2>
<h3><a id="Section_Settings"></a>Session Settings</h3>
Session timeout is a critical security feature that exists in web applications and systems to protect user privacy and prevent unauthorized access. A "session" refers to the period during which a user interacts with a system, starting from the login moment. The session timeout is a pre-set duration for which a user's session remains active. After this specified period of inactivity, the system automatically logs out the user to prevent unauthorized access and secure sensitive information.
In Nue, users can customize session timeout to match their security policies and preferences. You can choose from timeout durations of the following options:
<ul>
<li>15 Minutes</li>
<li>30 Minutes</li>
<li>1 Hour</li>
<li>90 Minutes</li>
<li>2 Hours</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Security_Setting_c2c8cb91b7.jpg" alt="Security Setting.jpg" />
&nbsp;
Please follow the instructions below to set the session timeout duration:
<ol>
<li>Go to Nue System Setting &rarr; Security</li>
<li>Under Session Settings, you will see the session timeout duration set in your organization. By default, user sessions expire in 15 minutes.</li>
<li>Choose the duration of the session timeout and the changes will be saved automatically.</li>
<li>Logging out and logging back in is required for changes to take effect.</li>
</ol>

<table style="border-collapse: collapse; width: 100%; background-color: #f1eafe;">
<tbody>
<tr>
<td style="width: 99.514%;">
NOTE
&nbsp;
Please note that this is a company-wide setting, and any changes will affect all users.
&nbsp;
</td>
</tr>
</tbody>
</table>
&nbsp;
&nbsp;

large_SettingPlatform.jpg

medium_SettingPlatform.jpg

small_SettingPlatform.jpg

thumbnail_SettingPlatform.jpg

SettingPlatform.jpg

Platform Settings

large_Renew Covwer.jpg

medium_Renew Covwer.jpg

small_Renew Covwer.jpg

thumbnail_Renew Covwer.jpg

Renew Covwer.jpg

Renew Subscriptions

<h1><a id="Create"></a>Create Products</h1>
&nbsp;
In Nue, the Product Catalog contains all the products and product bundles. (Refer to the Bundler Builder Tutorial for more information on product bundles).
&nbsp;
The Product Catalog spans across all the Price Books, so you have a single view to manage all the products.&nbsp;
&nbsp;
There are three steps to create a new product:
&nbsp;
Step 1: General Information
Step 2: Product Options
Step 3: Price Plans
&nbsp;
Navigate to Price Builder &gt; Product Catalog.&nbsp;
&nbsp;
<h2><a id="Step1"></a>Step 1: General Information</h2>
&nbsp;
In this first step, you will define the Product's UOM, Product Category, Revenue Model (one-time, recurring, usage), Standard Price, and whether it can be sold independently.
&nbsp;
You can also include a Product Image by importing your own image.
&nbsp;
The Standard Price should be the price paid for a single UOM. For example, if your UOM is a license/month, and you charge $299/month, your Standard Price is $299. This is also the List Price.
&nbsp;
A product has the following fields:
&nbsp;
<table style="border-collapse: collapse; width: 100%; height: 436px;" border="1">
<tbody>
<tr style="height: 14px;">
<td style="width: 50.0304%; height: 14px;">Product Field</td>
<td style="width: 50.0304%; height: 14px;">Description</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%; height: 14px;">Product Name</td>
<td style="width: 50.0304%; height: 14px;">The product&rsquo;s name.</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%; height: 14px;">SKU</td>
<td style="width: 50.0304%; height: 14px;">The product&rsquo;s SKU must be unique</td>
</tr>
<tr style="height: 156px;">
<td style="width: 50.0304%; height: 156px;">
Product Category
&nbsp;
</td>
<td style="width: 50.0304%; height: 156px;">
Describes the type of product.&nbsp;
 
The Product Category maps to the Product Family if you are using Salesforce. The Product Family must be an active field in Salesforce in order to activate the order.
 
Note that choosing the Product Category is significant as the category will define how the product is created in Nue. Product Category can be Subscriptions (recurring products), Assets (one-time physical good), or Entitlement (one-time professional services or support).
</td>
</tr>
<tr style="height: 16px;">
<td style="width: 50.0304%; height: 16px;">Default UOM</td>
<td style="width: 50.0304%; height: 16px;">
Select the UOM that defines how the product will be priced.
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 50.0304%; height: 32px;">Status</td>
<td style="width: 50.0304%; height: 32px;">
An active status will allow the product to be added to a Quote and Order. A draft or inactive status cannot be added to a Quote or Order.
</td>
</tr>
<tr style="height: 32px;">
<td style="width: 50.0304%; height: 32px;">
Start Date
</td>
<td style="width: 50.0304%; height: 32px;">
Defines the date when the product can be added to a Quote and Order.
</td>
</tr>
<tr style="height: 46px;">
<td style="width: 50.0304%; height: 46px;">
End Date
</td>
<td style="width: 50.0304%; height: 46px;">
This date indicates the last day the Product can be sold.&nbsp;
 
A quote created &lsquo;after&rsquo; the End Date will not see this product.&nbsp;
</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%;">
Revenue Model
</td>
<td style="width: 50.0304%;">
Defines whether the product is One Time, Recurring, or Usage based. There are three options for usage based products: Credit Burn-down, Credit, Overage Usage
</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%;">
Standard Price
</td>
<td style="width: 50.0304%;">
This is the List Price of the product within the price book. If you have multi-currency enabled, the last step &lsquo;Prices&rsquo; will allow you to create List Prices for the different currencies.
</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%;">
Can be sold independently
</td>
<td style="width: 50.0304%;">
This checkbox allows the product to be sold independently, outside of a Product Bundle.
</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%;">
Default Subscription Term
</td>
<td style="width: 50.0304%;">
This field defines the default length of the subscription term. For example, a 12 Month subscription term would indicate that the subscription end date is 12 months after the start date.
</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%;">
Default Renewal Term
</td>
<td style="width: 50.0304%;">
This field defines the default renewal length. For example, a value of 12 months would mean that the renewal period would be another 12 months.
</td>
</tr>
<tr style="height: 14px;">
<td style="width: 50.0304%;">
Auto Renew
</td>
<td style="width: 50.0304%;">
Checking this box would allow this product to be auto renewed.
</td>
</tr>
</tbody>
</table>
&nbsp;
<h2><a id="Step2"></a>Step 2: Product Features (Optional)</h2>
&nbsp;
This is an optional step. This allows you to list out the features within the product, along with a description.
&nbsp;
If you want to skip this step, click on &ldquo;skip&rdquo; at the bottom right of the page.
&nbsp;
<h2><a id="Step3"></a>Step 3: Prices</h2>
&nbsp;
This is one of the most critical steps.
&nbsp;
In this step, you will define the List Price of the Product, along with a Price Tag or Discount Tag if appropriate.
&nbsp;
You can define more than one List Price for a product, but it must have a different UOM or Currency.
&nbsp;
List Price is defined as the &ldquo;per unit price&rdquo;. The List Price cannot be negative. It must be greater or equal to zero.
&nbsp;
If your UOM is &ldquo;per user per month&rdquo;, define your list price as the price you charge for a single user each month.

large_Product.png

medium_Product.png

small_Product.png

thumbnail_Product.png

Product.png

Products

<h1>Invoice and Credit Memo Lifecycle</h1>
Invoices and Credit Memos in Nue have the following statuses in their lifecycle:&nbsp;
&nbsp;
<h2><a id="draft"></a>Draft</h2>
When an invoice is in the "Draft" status, it means that it has been created but not yet finalized or sent to the customer. It serves as a preliminary version that can be edited and reviewed before it is officially processed. Draft invoices are typically used for internal purposes to ensure accuracy and completeness before they are considered active.
&nbsp;
The invoices in DRAFT status are enforced with the business rules below:&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Draft invoices can be activated or canceled</li>
<li style="font-weight: 400;" aria-level="1">If a draft invoice exists for a customer&rsquo;s billing period, new invoice items will be added to the draft invoice</li>
<li style="font-weight: 400;" aria-level="1">Only draft invoices can be updated with more invoices items.</li>
<li style="font-weight: 400;" aria-level="1">There can be only one draft invoice for a billing account.</li>
</ul>
<h2><a id="active"></a>Active</h2>
An invoice in the "Active" status indicates that it has been finalized and sent to the customer for payment. This status signifies that the invoice is currently in the billing cycle and awaiting payment. The customer is expected to review the invoice, make the necessary payment, and fulfill any outstanding obligations mentioned within the invoice. The active status reflects the ongoing transactional phase of the invoice.
&nbsp;
The invoices in ACTIVE status are enforced with the business rules below:&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Invoice items in active invoices are considered billing transactions</li>
<li style="font-weight: 400;" aria-level="1">Active invoices are immutable:&nbsp; they cannot be updated without being canceled first.&nbsp; Only the latest invoice can be canceled.&nbsp;</li>
<li style="font-weight: 400;" aria-level="1">Only unpaid (Payment Status is not equal to Paid), active invoices may be canceled.</li>
</ul>
<h2><a id="canceled"></a>Canceled</h2>
When an invoice is marked as "Canceled," it means that it has been voided or invalidated. This status is typically assigned when there is a need to nullify the invoice due to various reasons such as errors, changes in agreements, or customer requests. A canceled invoice no longer holds any financial obligations, and it is removed from the active billing cycle. It serves as a record to indicate that the invoice was initially created but has been officially nullified.
&nbsp;
The invoices in CANCELED status are enforced with the business rules below:&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Once an invoice is canceled, the assets, subscriptions, entitlements and usage billed in this invoice will be re-billed in the next billing run</li>
<li style="font-weight: 400;" aria-level="1">Canceled invoices cannot be reactivated</li>
<li style="font-weight: 400;" aria-level="1">Canceled invoices may be deleted.</li>
</ul>
Users can manage the lifecycle of invoices and credit memos in both Nue App and Nue on Salesforce.&nbsp; Nue manages the synchronization of the invoices and credit memos across both platforms.
&nbsp;
The following diagram illustrates the lifecycle:&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Screenshot_2023_05_18_at_4_29_02_PM_956b895923.png" />
<h2><a id="PENDING_ACTIVATION"></a>Pending Activation (Optional)</h2>
Before activating an invoice, its status can be marked as "Pending Activation" as an optional step. This status is typically used when there are additional processes required to activate an invoice. For instance, customers may need to calculate the tax of an invoice using their tax engine instead of Nue tax engine integration. In some cases, there may be additional information to be added to an invoice before it is activated. To enable this 'Pending Activation' status for invoices and credit memos, administrators can do so from the Nue System settings.
&nbsp;
<img src="https://nervous-kaput-low.media.strapiapp.com/Enable_Pending_Activation_5a33d3b147.jpg" alt="Enable Pending Activation.jpg" />
&nbsp;
<ul>
<li>If the status 'Pending Activation' is enabled, when a draft invoice is activated through Nue UI or Nue API, the invoice status changes to 'Pending Activation' before being processed.</li>
<li>Users can update specific fields of the invoice in 'Pending Activation' status through Nue API before activation, such as Tax Amount, Amount, and Balance.</li>
<li>When an invoice in 'Pending Activation' status is activated through Nue UI or Nue API, it will be activated.</li>
<li>Users can also cancel an invoice in 'Pending Activation' status. In this case, the invoice's status will change to 'Canceled'.</li>
</ul>
<img src="https://nervous-kaput-low.media.strapiapp.com/Invoice_in_Pending_Status_738b49f76b.jpg" alt="Invoice in Pending Status.jpg" />
<h2>&nbsp;</h2>
<h2><a id="preview"></a>Preview</h2>
Oftentimes, sales reps and customer success managers have a need to preview invoices for quotes, orders, or accounts.&nbsp; For more information about previewing invoices, please refer to <a title="this article" href="https://docs.nue.io/docs/tutorial/tutorial-lifecycle-manager/preview-invoices/" target="_blank" rel="noopener">this article</a>.&nbsp;
&nbsp;
"Preview" status is not part of the lifecycle of an invoice or a credit memo.&nbsp; When a new Preview request is issued, and new preview invoices are saved, the previously saved preview invoices for the same quote, order, or account will be deleted automatically.
<h2><a id="invoice-and-credit-memo-actions"></a>Invoice and Credit Memo Actions</h2>
Please be aware of the following business rules governing the display and execution of actions related to invoices and credit memos on the Invoice or Credit Memo list page:&nbsp;
&nbsp;
<table style="border-collapse: collapse; width: 99.9485%; height: 13.6364px;" border="1">
<tbody>
<tr style="height: 13.6364px;">
<td style="width: 13.7572%; height: 13.6364px; text-align: center;">Action</td>
<td style="width: 49.502%; height: 13.6364px; text-align: center;">Allowed when invoices or credit memos are in these statuses</td>
<td style="width: 36.7287%; height: 13.6364px; text-align: center;">Allowed when users have the following custom permissions</td>
</tr>
<tr>
<td class="pm-table-cell-content-wrap" style="width: 13.7572%;" data-colwidth="110">
ACTIVATE
</td>
<td class="pm-table-cell-content-wrap" style="width: 49.502%;" data-colwidth="214">
<ul>
<li>Draft</li>
<li>Pending Activation</li>
</ul>
</td>
<td class="pm-table-cell-content-wrap" style="width: 36.7287%;" data-colwidth="162">
Activate Invoice
</td>
</tr>
<tr>
<td class="pm-table-cell-content-wrap" style="width: 13.7572%;" data-colwidth="110">
CANCEL
</td>
<td class="pm-table-cell-content-wrap" style="width: 49.502%;" data-colwidth="214">
<ul>
<li>Draft</li>
<li>Pending Activation</li>
<li>Active</li>
</ul>
</td>
<td class="pm-table-cell-content-wrap" style="width: 36.7287%;" data-colwidth="162">
Cancel invoice
</td>
</tr>
<tr>
<td class="pm-table-cell-content-wrap" style="width: 13.7572%;" data-colwidth="110">
DELETE
</td>
<td class="pm-table-cell-content-wrap" style="width: 49.502%;" data-colwidth="214">
<ul>
<li>Canceled</li>
<li>Preview</li>
</ul>
</td>
<td class="pm-table-cell-content-wrap" style="width: 36.7287%;" data-colwidth="162">
Delete Invoice
</td>
</tr>
<tr>
<td class="pm-table-cell-content-wrap" style="width: 13.7572%;" data-colwidth="110">
VIEW
</td>
<td class="pm-table-cell-content-wrap" style="width: 49.502%;" data-colwidth="214">
<ul>
<li>Draft</li>
<li>Active</li>
<li>Canceled</li>
</ul>
</td>
<td class="pm-table-cell-content-wrap" style="width: 36.7287%;" data-colwidth="162">
N/A&nbsp;
</td>
</tr>
</tbody>
</table>
&nbsp;
&nbsp;

large_Invoice Statuses.jpg

medium_Invoice Statuses.jpg

small_Invoice Statuses.jpg

thumbnail_Invoice Statuses.jpg

Invoice Statuses.jpg

Invoice Status Explained

<h1><a id="usecase"></a>Use Case Description</h1>
When a user creates a change quote or order from the Change Cart, she can create a new opportunity for the new change quote or order, or associate an existing opportunity with the change quote or order.&nbsp;&nbsp;
&nbsp;
When creating a new opportunity, if there are more than one record type for opportunities, a user can choose a record type first - for example, New Business, Upsell, Renewal, etc. Then she will be navigated to the Create Opportunity screen.&nbsp; The page layout of the Create Opportunity screen, by default, is based on the Opportunity Layout assigned to the selected record type as well as the current user role.&nbsp;&nbsp;
&nbsp;
However, by default, Salesforce will show *all fields* configured on the Opportunity Layout, instead of only the first section, or only the required fields.&nbsp;&nbsp;
&nbsp;
So in order to streamline the opportunity creation process, you can configure a set of Field Set, each associated with a specific record type.&nbsp; Once the field set is configured, Nue will display only the list of fields configured on the field set in the opportunity creation popup.&nbsp;&nbsp;
&nbsp;
<h1><a id="create-recordtypes"></a>Create Opportunity Record Types</h1>
If you already have opportunity record types and sales processes, please skip this section.&nbsp;&nbsp;
&nbsp;
To create a sales process associated with opportunity record type in Salesforce, follow these steps:
&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">Go to Setup in your Salesforce org.</li>
<li style="font-weight: 400;" aria-level="1">In the Quick Find box, search for "Opportunity Record Types" and click on it.</li>
<li style="font-weight: 400;" aria-level="1">Click on the "New" button to create a new record type.</li>
<li style="font-weight: 400;" aria-level="1">Give your new record type a name and select the appropriate settings.</li>
<li style="font-weight: 400;" aria-level="1">Under the "Sales Processes" section, click on "New" to create a new sales process.</li>
<li style="font-weight: 400;" aria-level="1">Give your new sales process a name and select the appropriate settings.</li>
<li style="font-weight: 400;" aria-level="1">Define the stages of your sales process by clicking on "Add Stage".</li>
<li style="font-weight: 400;" aria-level="1">Customize the picklist values for the Stage field by clicking on "Edit Picklist Values".</li>
<li style="font-weight: 400;" aria-level="1">Configure the stage-related picklists, such as Probability, Forecast Category, and Sales Stage.</li>
<li style="font-weight: 400;" aria-level="1">Define the sales path for the opportunity record type by clicking on "Add Path".</li>
<li style="font-weight: 400;" aria-level="1">Customize the sales path by adding guidance for each stage.</li>
<li style="font-weight: 400;" aria-level="1">Set up any automation, such as workflow rules, to trigger actions based on stage changes or other criteria.</li>
<li style="font-weight: 400;" aria-level="1">Once you have completed these steps, your new opportunity record type with its associated sales process should be ready to use.</li>
</ul>
&nbsp;
<h1><a id="create-fieldset"></a>Create Field Set</h1>
To create a field set associated with a record type, please follow the steps below.
&nbsp;
Assuming you&rsquo;re going to create a field set with record type API name Cross_Sell:&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">In the Quick Find box, search for "Object Manager" and click on it.</li>
<li style="font-weight: 400;" aria-level="1">Click on "Opportunity" to open the Opportunity object.</li>
<li style="font-weight: 400;" aria-level="1">In the left-hand menu, click on "Field Sets".</li>
<li style="font-weight: 400;" aria-level="1">Click on the "New" button to create a new field set.</li>
<li style="font-weight: 400;" aria-level="1">Give your new field set a name and description.</li>
<ul>
<li style="font-weight: 400;" aria-level="2">Name: 
<pre>NueLookupForm_{recordTypeName}</pre>
, e.g., 
<pre>NueLookupForm_Cross_Sell</pre>
</li>
</ul>
<li style="font-weight: 400;" aria-level="1">Select the fields that you want to include in your field set by clicking on the "Add fields" button.</li>
<li style="font-weight: 400;" aria-level="1">Drag and drop the fields to arrange them in the desired order.</li>
<ul>
<li style="font-weight: 400;" aria-level="2">Please make sure to include all required fields for this field set to make sure the end user is able to create an opportunity successfully.</li>
</ul>
<li style="font-weight: 400;" aria-level="1">Optionally, add any related list fields that you want to include in the field set.</li>
<li style="font-weight: 400;" aria-level="1">Save your field set.</li>
</ul>
Now you can test your opportunity creation popup layout in the Change Quote/Order Flow.&nbsp;&nbsp;
<h1><a id="notes"></a>Additional Notes</h1>
Please note the following:&nbsp;
<ul>
<li style="font-weight: 400;" aria-level="1">In the Create Opportunity popup, only active record types will be displayed</li>
<li style="font-weight: 400;" aria-level="1">If you do not have a field set associated with a selected record type, Nue will display the full opportunity layout assigned to the record type as well as the current user profile.</li>
</ul>

medium_Screenshot 2023-04-26 at 4.09.13 PM.png

small_Screenshot 2023-04-26 at 4.09.13 PM.png

thumbnail_Screenshot 2023-04-26 at 4.09.13 PM.png

Multi Currency Setup

Configure Create Opportunity Popup

large_Billing Schedule.jpg

medium_Billing Schedule.jpg

small_Billing Schedule.jpg

thumbnail_Billing Schedule.jpg

Billing Schedule.jpg

Billing Accelerator Overview

Nue Knowledge Center

Lifecycle Intelligence