Skip to content

Managing Subscription Items

Subscriptions include items. They represent the products to be charged and will figure as invoice line items on the created invoices.

Depending on the nature of the product, you can define a specific price model or billing type for an item.

  • Recurring: The item is billed with the given amount in each invoice run.
  • One-Time: The item is billed only once. After the item has been billed for the first time, JustOn sets its status to Inactive so it will not be included in subsequent invoices.
  • Transactional: There is no quantity defined for the item. Instead, the information (quantity or quantity + price) is provided by usage data that match the subscription item.

With respect to the billing type, the items must provide different sets of required information.

One-Time Recurring
Recurring Prorated
Transactional
Title Title Title
Billing Type
One-Time
Billing Type
Recurring
Recurring Prorated
Billing Type
Transactional
Order No. Order No. Order No.
Billing Period Transaction Aggregation Fields
Billing Unit
Next Service Period Start

Info

For details about item price settings, see Managing Item Pricing.
For details about all available item fields, refer to the Item object reference.

Managing subscription items includes the following main tasks:

Adding Items

There are several ways to add an item to a subscription:

To create a subscription item manually from scratch:

  1. Open the subscription to which you want to add an item.
  2. In the Items section, click New.
  3. Specify the details as required.
    Mandatory parameters include
    • Title
    • Billing Type: Recurring, One-Time or Transactional, see General Billing Settings
    • Order No.: Key to match source data to a transactional subscription item, defaults to ITEM for non-transactional items
  4. Click Save.
    ▶ This generates the new item.

For details about the fields that control the item's pricing and billing behavior, see General Billing Settings.

Creating Items From Products

You can create a subscription item from a product that already exists in Salesforce as a pricebook entry.

Note

To be able to use this feature, you need a valid Salesforce CRM license.

To create an item from a pricebook entry:

  1. Open the subscription to which you want to add an item.
  2. In the Items list, click New Item From Product.
  3. Select the intended pricebook and pricebook entry.
  4. Modify the details as required.
  5. Click Save.
    ▶ This creates the new subscription item and returns you to the subscription detail page.

JustOn copies the following fields when generating a subscription item from a product:

Source Target
Product2 Product Code Item Order No.
Product2 Name Item Title
Product2 Description Item Description
Product2 Family Item Product Group
Price Book Entry Price Item Price

In addition, any defined ON fields are copied to the subscription item.

Info

If set up accordingly (see Enabling Product Lookup), subscription items based on pricebook entries are linked to the original product.

Cloning Subscription Items

Certain business use cases require a subscription item to be cloned. Cloning an item creates a duplicate of the current item, including all available information, and adds it to the current subscription.

  1. Open the subscription you want to modify.
  2. Open the Items list.
  3. Click the order no. of the item to be modified to open its detail view.
  4. Click Clone.
    This displays a confirmation message.
  5. Click Clone.
    ▶ This creates a duplicate of the current item, including all available information, and adds it to the current subscription.

Defining Item-Specific Billing Periods

For recurring subscription items (with the billing type set to Recurring), the following settings control the billing recurrence:

Field API Name Description
Billing Period BillingPeriod__c Defines the time interval in months after which the item is considered in the invoice run, for example, every 12 months
Billing Unit BillingUnit__c Defines the time unit for the billing period to be displayed on the invoice (Day or Month) and which is used for the price calculation of the billing period
Next Service Period Start NextInvoice__c Specifies the date of the next billing date for that item. If no value is defined, it will be substituted by the maximum of the invoice run start date, subscription start date or item start date. When the invoice is set Open, it is incremented to the current invoice line item's
service period end date + 1 day

For the resulting invoice line items, there are:

Field API Name Description
Billing Factor BillingFactor__c Factor resulting from the billing period and the billing unit that is applied to the invoice line item calculation. The billing unit Month combined with the billing period 3, for example, results in a billing factor of 3, that is, the item is invoiced every three months with the price multiplied by three.
JustOn recommends to include the billing factor in the invoice template through adding the field Billing Factor to the invoice line item table. For details, see Adjusting Invoice Line Item Table.
Billing Unit BillingUnit__c Defines the time unit for the billing period to be displayed on the invoice (Day or Month) and which is used for the price calculation of the billing period
How does JustOn determine the billing behavior for recurring items?

There are two settings that control the billing behavior for recurring subscription items: The billing period specifies the interval after which an item is considered in the invoice run, and the billing unit is the time unit applied for this period. Based on this data, JustOn determines the billing factor, which is then applied to the resulting invoice line item - as a multiplier for the specified price.

■ The billing unit Month combined with the billing period 3 results in a billing factor of 3, that is, the item is invoiced every three months with the price multiplied by three.

■ The billing unit Month combined with the billing period 3 results in a billing factor of 3, and with an item quantity of 2, the item is invoiced every three months with the price multiplied by six.

■ The billing unit Day combined with the billing period 1 results in a billing factor that equals the number of days in the current month, that is, the item is invoiced every month with the price multiplied by the number of days of this month.

For the subscription item to be considered in the invoice run, the item's next invoice date and the subscription's start date must be within the invoice run period.

How to control the service period of invoices with recurring items?

JustOn automatically determines the service period of an invoice based on various conditions:

Generally, the earliest service period start date of all included invoice line items defines the service period start of the invoice. Consequently, the latest service period end date of all included invoice line items defines the service period end of the invoice.

If set, the subscription end date forces the service period end of the invoice.

With respect to the invoice line items, the start date and end date set as the invoice run period usually represent the service period for recurring items. If, however, JustOn determines a billing factor (as given by a billing period and a billing unit), the service period start of the invoice line item is set using the subscription item's Next Service Period Start field. The service period end is then calculated as follows: Next Service Period Start + Billing Period - 1 day.

If Next Service Period Start is not set, JustOn uses the invoice run start date instead.

Other settings that force an item's service period end include:

  • the subscription item's activation end date, and
  • the end date of the last price tier defined for the subscription item.

Using the custom placeholders ServicePeriodStart and ServicePeriodEnd, you can display the items' service period in the invoice PDF. For details, see Adjusting Invoice Line Item Table.

To set up item-specific billing periods:

  1. Open the subscription you want to modify.
  2. Open the Items list.
  3. Click Edit in the row of the item to be edited.
  4. Specify the billing period, billing unit and next service period start as necessary.
  5. Click Save.

Info

JustOn supports the partial calculation of months defined as the billing unit. To this end, use the billing type Recurring Prorated (see Enabling Partial Billing Units) in combination with the synchronization setting Start of next month (see Synchronizing Recurring Items).

Maintaining Contract-Specific Values

The subscription item includes a number of fields for displaying and calculating contract-specific values. This information is modified when creating invoices from this subscription.

The following fields are available:

Field Data Source Description
Contract Value manual input or
calculated value
Shows the overall value of the item for the whole subscription period. In case of a professional service item, for example, the contract value is the initially negotiated value of the opportunity product. This value can be determined in a subscription building process
Contract Value Correction manual input Shows a corrective value to be deducted from the contract value because it has already been invoiced
Contract Value Invoiced updated upon invoice modification Shows the actually invoiced contract value, which is updated each time an invoice or an invoice line item is changed or deleted. Note that JustOn only considers invoices of the statuses Open, Paid or Settled.
Contract Value Remaining calculated value Shows the remaining contract value, which is calculated based on the other three values (Remaining Contract Value = Contract Value - Contract Value Correction - Invoiced Contract Value). Can never be less than 0.

Info

The contract-specific value information is primarily used in reports for forecasting purposes.

To display contract-specific values:

  1. Open the subscription you want to modify.
  2. Open the Items list.
  3. Click Edit in the row of the item to be edited.
  4. Specify the contract value, contract value correction and contract value invoiced as necessary.
  5. Click Save.
    ▶ This displays the contract-specific item values, including the remaining contract value, on the item detail page.

Sorting Invoice Line Items

When billing usage data, you can sort and aggregate the usage data with certain criteria. In this case, an invoice run can produce multiple invoice line items from a single subscription item of the billing type Transactional. The sorting order of the produced invoice line items is random.

To display the produced invoice line items in an intended order, you can configure a custom criterion. To do so:

  1. Open the subscription you want to modify.
  2. Open the Items list.
  3. Click Edit in the row of the item to be edited.
  4. Edit the ordering details as necessary.
    • Order By: Specifies the API name of the invoice line item field by which the line items will be sorted, for example, ServicePeriodEnd__c (if empty, no sorting is done)
    • Reverse: Checkbox to force the reverse sorting order (if unchecked, the invoice line items are sorted in an ascending order)
  5. Click Save.

Synchronizing Recurring Items

You can set up JustOn to synchronize the defined billing period to start with

  • the start of the next year (for a billing period of 12 months),
  • the start of the next fiscal year (for a billing period of 12 months), or
  • the start of the next month (for a billing period of one month and with the billing unit Day).

Info

The invoice date synchronization for the next month must be enabled, see Enabling Monthly Invoice Date Synchronization.

Using the billing period/invoice date synchronization adjusts the invoicing cycle to the defined period. The remainder of the billing period, that is, the rest of days or months until the defined sync period starts, is calculated partially.

Assume the following example configuration:

Record Field Value
Item Billing Type Recurring
Next Service Period Start empty
Billing Period 12
Billing Unit Month
Sync With Start of next year
Invoice Run Period Start 2016-09-01
Period End 2016-09-30

This will result in the following invoice line item data:

Field Value
Service Period Start 2016-09-01
Service Period End 2016-12-31
Billing Factor 4
Billing Unit Month

When setting the corresponding invoice to Open, the Next Service Period Start field of the item is set to 2017-01-01, synchronizing the item billing period with the calendar year.

To set the billing period synchronization:

  1. Open the subscription you want to modify.
  2. Open the Items list.
  3. Click Edit in the row of the item to be edited.
  4. Specify the values for the fields Billing Type, Billing Period, Billing Unit and Sync With as necessary.
  5. Click Save.

Defining Item Discount

JustOn allows to define discounts for individual invoice line items. You can already set the discount rate to be used on the subscription item.

  1. Open the subscription you want to modify.
  2. Open the Items list.
  3. Click Edit in the row of the item to be edited.
  4. In the Discount field, specify the percentage discount rate to be applied.
  5. Click Save.
    ▶ When generating the invoice from the subscription, the specified discount rate is copied to the invoice line item.

Next steps:

Managing Item Pricing
Managing Invoice Runs
Manually Creating Invoices