UC-03 · A brand rate with an item-specific override

The agreement pays 5% on the whole brand, except one premium item that pays 3%. A $10,000 sale of a standard item earns $500; the same sale of the premium item earns $300. This walkthrough shows how the more specific line wins.

Prerequisites: RoyaltyCentral installed and enabled in a sandbox. Complete UC-01 first — this scenario adds a second rate line to the same contract.

1 · Two items on the brand

Open RoyaltyCentral → Licensors → ACME → Brands → ACME-WIDGETS → Items. Assign both items:

Item Role
ITEM-100 Standard — takes the brand rate.
ITEM-200 Premium — takes its own rate.

2 · A brand line and an item line

Reopen the contract. Open Contract Details. Keep the brand line. Add an item line:

Origin Region Sell Region Sales Type Item Type Item Code Rate Percent
US-EAST NORTH-AM All Customers Brand ACME-WIDGETS 5
US-EAST NORTH-AM All Customers Item ITEM-200 3

Release the contract.

An Item line beats a Brand line. RoyaltyCentral looks for item lines first — through the customer scopes — before it looks at any brand line. An “All Customers + Item” line therefore wins over a “Customer + Brand” line for that item. Scope an item override to one customer only when you also want the other customers to keep the brand rate.

3 · Post one sale of each item

Post two sales invoices of $10,000 net each, to the same customer, from location EAST:

  1. 100 units of ITEM-100 at $100.
  2. 100 units of ITEM-200 at $100.

4 · Read the royalty entries

Open Royalty Entries. Expect two Sale entries on the same contract:

Item Line that matched Contract rate Amt. Due (Actual)
ITEM-100 Brand ACME-WIDGETS 5% 500.00
ITEM-200 Item ITEM-200 3% 300.00

The Rate field on the Royalty Entries page shows the payee’s share of the contract, not the contract rate. With one payee at 100%, it shows 100%.

5 · The other tie-breakers

Several lines can still qualify after the item-over-brand rule. RoyaltyCentral then ranks them:

  1. Sub-brand — for brand lines, RoyaltyCentral tries the item’s own brand first, then each parent brand in turn. It checks the customer scopes below inside each brand. An All Customers line on the sub-brand therefore beats a Customer line on the parent brand.
  2. Customer specificity — inside each brand, or for item lines, a Customer line beats a Customer Price Group line, which beats an All Customers line.
  3. Variant — for item lines, an exact Item Variant Code line beats a blank-variant line.
  4. Most recent — of the lines that remain, the one with the latest Starting Date on or before the posting date wins.

Use the last rule to change a rate mid-contract. Add a line with the new rate and a Starting Date on the changeover day. Sales before that day keep the old rate.

Where to next

  • Change the rate by destination instead of by item: UC-02.
  • Set a rate of zero to exclude one customer: UC-11.

See also: Contracts — how a sale picks a line · Regions, licensors & brands · Royalty calculation