Skip to content

Distributing Items to Multiple Invoices

Generally, the invoice run creates one invoice per subscription. Certain use cases, however, require usage data or items to be invoiced separately. To support this, JustOn makes use of invoice criteria, which are a means for controlling the distribution of invoice line items to multiple invoices. Only invoice line items with the same criterion are included in one invoice, others are invoiced separately.

To enable the invoice criterion, add the field ON_InvoiceCriterion to the relevant object.

  • If you manually create subscriptions and items, add ON_InvoiceCriterion to the Item object.
  • When automatically building subscriptions, add ON_InvoiceCriterion to the custom object that makes up the source for the item.
  • In case of usage data billing, that is, when processing transactional items, add ON_InvoiceCriterion to the custom usage data object.

Once set up, you can explicitly disable the invoice criterion feature for a subscription by selecting the checkbox Ignore Invoice Criterion.

Adding Invoice Criterion

To add the invoice criterion field:

  1. Navigate to the fields list of the relevant object.
  2. Create the following new field.

    Field Label API Name Data Type
    Invoice Criterion ON_InvoiceCriterion Text (255)
    Formula (Text)

    For help about creating fields, see Managing Object Fields.

Using this field allows for grouping invoice line items. The scope of the criterion is limited to draft invoices, the current invoice run, and the service period of the current invoice run.

Info

If empty or not set, the invoice criterion is considered an empty criterion, which, consequently, does not distribute the invoice line items to multiple invoices.

Invoice Criterion Usage Examples

Recurring items

The following subscription configuration

Item Billing Type Quantity Price Invoice Criterion
Fee 1 Recurring 2 5,00 A
Fee 2 Recurring 3 7,00 B

produces two invoices with the following line items:

(1) invoice for criterion A

Invoice Line Item Quantity Price
Fee 1 2 5,00

(2) invoice for criterion B

Invoice Line Item Quantity Price
Fee 2 3 7,00
Transactional items

The following subscription configuration

Item Order No. Billing Type Quantity Price
Fee 3 PROD3 Transactional 10,00

with these custom object records to be matched with the transactional item

Invoice Criterion Order No. Quantity
A PROD3 3
A PROD3 5
B PROD3 7

produces two invoices with the following invoice line items:

(1) invoice for criterion A

Invoice Line Item Quantity Price
Fee 3 8 10,00

(2) invoice for criterion B

Invoice Line Item Quantity Price
Fee 3 7 10,00

Note

Be aware that the invoice criterion does not merge subscriptions or combine items of multiple subscriptions on one invoice.

Make sure, in addition, not to confuse the invoice criterion ON_InvoiceCriterion and the item criterion ON_Criterion. They cover different use cases in different contexts. If necessary, the use cases can be combined, though.