Advanced Editor

Advanced Editor uses a workflow based on nodes to design contracts. It is best suited for creating contracts with multiple products and dynamic pricing models.

Editor workflow example

Let’s look at a simplified workflow which deals with two products and a unit per pricing model to better understand how to use the contract workflow.

Get usage aggregate

First, we select usage aggregate as it defines the total consumption of key metric usage, such as the number of API calls. This information is derived from metering, where the raw metric data is imported and defined. To learn more, see metering.

Per unit pricing

The unit per pricing model charges customers based on their usage of a specific metric, such as the number of API calls, they make. (You can choose a different pricing model node based on your requirements)

For instance, with Twilio APIs, customers are charged for each API call they make, with the price per call set by Twilio. This pricing model is particularly useful for SaaS products with variable usage, as customers only pay for the amount they use.

The billing prices of both products are added together, and the resulting total is included on the invoice. While the contract is still in draft, you can edit the values on the left, but once the invoice is approved, it is considered final and cannot be edited. For more information, see Invoices.

Contract workflow nodes explained

🚧

If the pricing node you require is not supported, you can request a pricing model. Please contact our support team to request the addition of nodes.

• Free Units: Products/services that are offered free of charge for a specified period or quantity.
• Pre unit pricing: A pricing model where the cost per unit decreases as the number of units purchased increases.
• Minimum amount overages: A pricing model where there is a certain limit below which you won't be charged any extra fees.
• Volume pricing: A pricing model where the price per unit decreases as the volume of units purchased increases.
• Pricing Placeholder: A placeholder for a pricing model that can be defined later.
• Tiered pricing: A pricing model where the price per unit decreases as more units are purchased.
• Percent pricing: A pricing model where the price is calculated as a percentage of a specific metric, such as revenue or usage.
• Subscription: A pricing model where customers pay a fixed fee at regular intervals, such as monthly or annually.

Usage metric

Get usage aggregate - It defines the total consumption of a key metric usage, such as the number of API calls, derived from metering.

Operations

• Sum: Adds up two or more values to produce a total value.
• Subtract: Subtracts one value from another to produce a difference.
• Percent: Calculates a percentage of a given value.
• Min: Calculates the minimum value of a set of values.
• Max: Calculates the maximum value of a set of values.
• Discount: Reduces the price of a product or service by a specified percentage or amount.
• Simple tax: Calculates a simple tax on a given value.

Entitlements

• Add entitlement: Add information of customer entitlements to the contract.
• Get entitlement: Retrieve the usage aggregate of entitlements.
• Deduct entitlement: Deduct entitlement usage from the total entitlement.

Payment terms

• Pay before day after invoice: Payment for the invoice must be made before the day after the invoice date.
• Discount before days after invoice: Any applicable discounts must be claimed before a specified number of days after the invoice date.
• Payment due: The date by which payment must be made for the invoice.

Miscellaneous

• Billing period: The length of time between billing cycles for a contract.
• Subscription with proration: A pricing model where the subscription fee is adjusted based on the time remaining in the billing period.
• Prorated fixed charge: A charge that is prorated based on the time remaining in the billing period.
• Destination account: The account where payment for the invoice should be sent.
• Option selector: A node that allows you to select a particular option from a list of options.