Billing and Usage Settings
This article contains detailed information about system configuration options for functionalities in Nue Billing and Usage Accelerator. These settings are in the Settings → Revenue Manager category.
Billing
Billing Period
Also known as Billing Cycle or Billing Frequency, which determines how often the customers will be billed, for example, monthly, quarterly, annual, etc.
When selecting ‘Quarterly', ‘Semi-Annual’ or ‘Annual’, there appears a number field, which indicates the nth of the month the period will start, for example, 'Quarterly → 2’ means the period will start from the second month of the quarter.
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 option is selected, the billing period of the account will automatically be set to match the first subscription or order of the customer.
Billing Cycle Day
Determines on which day the billing cycle starts.
When selecting 'Specific Day of Month', the number selection will appear, the available values are 1 to 31. If 31 is selected it is default to the last day of the month.
Billing Timing
Determines whether customers are billed for the products or services before or after they are provided or consumed.
Products in each Revenue Model have a default Billing Time, which can be configured at the system level. The default Billing Timing is shown in the screenshot below.
Admin users can change the default billing timing for each revenue model in the system settings. Users can also override the default billing time at the product or price book entry level.
Enable Billing Proration for Partial Periods
Determines if the first partial period needs to be invoiced. By default it is true; otherwise the first partial period will be billed together with the first full billing period.
Invoices
Payment Term
Determines the time frame within which the payment should be received by the seller or service provider.
The default values include:
- Net 15: The customer is expected to pay the invoice within 15 days of the invoice date.
- Net 30: The customer is expected to pay the invoice within 30 days of the invoice date.
- Net 45: The customer is expected to pay the invoice within 45 days of the invoice date.
- Net 60: The customer is expected to pay the invoice within 60 days of the invoice date.
- Due Upon Receipt: The payment is expected immediately upon receipt of the invoice.
The default value is Net 30.
Additionally, admin users can set the payment term to align with the customer's first order by checking the 'Automatically align the payment term of an account with its initial order'. When this option is enabled, the payment term for the account will automatically be set to that of the customer's first order.
Payment Method
Determines the default payment method that customers will use to pay for the products or services they purchase
The default values include:
- Electronic
- Non-electronic
- ACH
- Bank Transfer
- Cash
- Check
- Credit Card
- Debit Card
- Paypal
- Wire Transfer
- Other
The default value is empty.
Additionally, admin users can set the payment method to align with the customer's first order by checking the 'Automatically align the payment method of an account with its initial order'. When this option is enabled, the payment method for the account will automatically be set to that of the customer's first order.
Hide invoice items with $0 total amount
If enabled, zero-amount invoice items will be created but they will be hidden from the invoices and will not be synchronized to Salesforce, Stripe, Quickbooks, etc.
Automatically generate the first invoice when an order is activated
Determines whether the first invoice will be generated upon activating orders. If this option is turned on, the system will generate the first invoice using either the current date (Today) or the earliest Next Billing Date among all the products in the order, whichever comes later, as the target date for the invoice.
Additionally, users can choose to only generate the first invoice for Customers, Products, or Orders that match specific criteria by setting filter conditions.
Automatically activate the first invoice when an order is activated
Determines whether the generated invoices are activated automatically upon order activation. If enabled, when an order is activated, the first invoice will be generated and activated.
Generate invoices for each sales account
Determines whether to create invoices for every sales account associated with the same billing account. When this setting is enabled, if multiple customers are sharing the same billing account, they will be billed separately. Otherwise, only one invoice gets generated for the shared billing account.
|
NOTE
If this setting is enabled and each customer has their unique billing settings, Nue will generate individual invoices based on each customer's specific billing settings instead of using the billing settings configured on the shared billing account. For example:
When generating their first invoice, Customer A will receive an invoice for their entire subscription term (01/01/2024 - 12/31/2024), whereas Customer B will only be charged for the first month of their subscription (03/15/2024 - 04/14/2024). |
Preview invoices for quotes and orders
If enabled, users can preview invoices for a quote or an order.
Enable 'Pending Activation' status for invoices
Determines if an invoice remains in 'Pending Activation' status until the activation process is completed. For more details, please reference to https://docs.nue.io/docs/tutorial/tutorial-billing-accelerator/invoice-statuses/
Enable Credit Memo
If enabled, credit memos can be created instead of negative invoices. We provide 2 different options.
- Create a credit memo instead of a negative invoice when the total billed amount in a billing cycle is negative
- If enabled, a credit memo will be created instead of a negative invoice, when the total billed amount in a billing cycle for a customer is negative.
- Create a credit memo for all items with negative amounts instead of negative invoice items
- If enabled, negative items in a billing period for the same customer will be created as credit memo items, instead of negative invoice items.
Usage
Usage Rating User
The Nue user whose connected Salesforce user is used for usage rating in Salesforce. This user must be specified if products and pricing are stored in Nue on Salesforce.
Usage Rating Window Size
Determines how raw usage is grouped into usage records based on the timestamps before they are rated. Available values are:
- HOUR
- DAY
Align usage with the subscription’s Bill Cycle Day
Determines the term start date of the rated usage. By default it is false, and the usage term is aligned with the subscription’s term. When this setting is enabled, the usage term will be aligned with the subscription’s bill cycle day instead.
Synchronize Usage to Salesforce
Determines whether the usage records are synchronized to Salesforce to the corresponding Usage object. By default, it is not enabled.
Once enabled, the ingested Raw Usage will be aggregated by Usage Window and synchronized in small batches to Salesforce.
You can use the usage records in Salesforce to:
- Trigger notifications or flows when the usage amounts for particular customers exceeds a certain threshold
- Reports on daily or monthly usage using Salesforce's default reporting capability
Please be aware that Salesforce does have storage limits. So if you have a large volume of usage, you may consider not enabling this option.
Credits
Credit Burndown is one of the 3 usage revenue models we support. There are the following configuration settings.
Credit Type
Determines the credit types enabled in your organization. Nue provides two types of credit: Credit and Cash. You can enable either or both of them and configure the name of the credit type based on your business needs.
For example, customers can purchase points upfront for API consumption. Each point can be purchased at $10. You can configure the label as Points, and set the List Price to $10.
Default Credit Pool
Determines where the credits are deposited by default.
Rollover unused credits
Determines if the unused credits may be rolled over beyond the current term.
If enabled, a Rollover Period must also be specified, e.g. 1 Month.
Enable credit proration for partial periods
Determines if the credits can be prorated in a partial period. By default it is false, the credits can only be issued to full periods, otherwise, they can be prorated and issued to a partial period.
Align credits with the subscription's Bill Cycle Day
Determines if the credits are aligned with the subscription's Bill Cycle Day. By default it is false, and the credits are aligned with the subscription's start date.