Understand prioritization rules
If a customer has multiple active credits or commits that can apply against the same usage, Metronome uses a series of rules to determine which credit or commit to consume first. This page outlines these rules.
Rollover commits
- If there are multiple rollover commits, burn down is based on commit type. Post-paid rollover commits burn down before prepaid commits.
- If there are multiple rollover commits with the same commit type, burn down is based on priority.
- If there are multiple rollover commits with the same commit type and priority, burn down is based on product applicability. Commits with the fewest applicable products first, most applicable products last.
- If there are multiple rollover commits with the same commit type, priority and product applicability, burn down is based on
ending_before
. The earlierending_before
gets burned down first.
Prepaid commits and credits
- If there are multiple prepaid commits and credits, burn down is based on priority.
- If there are multiple other prepaid commits or credits with the same priority, burn down is based on commit cost basis. $0 cost basis burns down first, then paid.
- If there are multiple other prepaid commits or credits with the same priority and cost basis, burn down is based on product applicability . The fewest applicable products first, most applicable products last.
- If there are multiple other prepaid commits or credits with the same priority, cost basis and product applicability, burn down is based on
ending_before
. The earlierending_before
burns down first. - If there are multiple prepaid commits or credits with the same priority, cost basis, product applicability, and
ending_before
, burn down is based onstarting_on
. The earlierstarting_on
burns down first. - If there are multiple prepaid commits or credits with the same priority, cost basis, product applicability,
ending_before
, andstarting_on
, burn down is based on number of contracts a commit is applicable to. The commit with the least number of applicable contracts burns down first.
Post-paid commits
Follows the same order logic as prepaid commits: priority, cost basis, product applicability, ending_before
, starting_on
, then number of applicable contracts.
Line-item burn down
If there are multiple line items on the invoice eligible for commit or credit application, Metronome uses rules to determine which line item to apply commit or credit to first:
- Commits or credits are applied against usage products first, then subscription products, then composite products.
- If there are multiple products of the same type, Metronome uses the start date of the line item, applied against earlier start dates first.
- If there are multiple products of the same type with the same start date, Metronome uses the unit price of the line item, applied against line items with higher unit prices first.
- If there are multiple products of the same type with the same type, start date and unit price, Metronome uses the line item name, applied alphabbetically from A to Z.
For example, imagine a usage invoice with two usage products: Data Storage with a unit price of $1, and Data Reads with a unit price of $2.6 dollars. The line items have the same effective dates spanning the entire billing period. Any commit or credit first gets applied against Data Reads, as it has the higher unit price.