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_InvoiceCriterionto the Item object. - When automatically building subscriptions, add
ON_InvoiceCriterionto 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_InvoiceCriterionto 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:
- Navigate to the fields list of the relevant object.
-
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.