UC-01 · Your first royalty

This walkthrough follows the whole lifecycle once, with concrete numbers. A contract pays ACME Corp 5% of net sales on its widget brand, with one vendor payee and one $10,000 sale. It ends with a $500 royalty entry that you can read on the ledger.

Prerequisites: RoyaltyCentral installed and enabled in a sandbox. The steps below work with plain CRONUS data; names and codes are examples.

1 · Reference data

As in Phase 1 of the workflow:

Create Values
Origin Region US-EAST Use Locations to assign the location you ship from, for example EAST. If your sales carry no location, add a line. Leave the Location Code empty on that line.
Sell Region NORTH-AM Assign countries US and CA. Make sure your test customer’s address carries one of them.
Licensor ACME “ACME Corp” — the rights-holder.
Brand ACME-WIDGETS Create it under the licensor. Use Items to assign one or two items that you sell, for example ITEM-100.
Payee ACME-PAY Source Type = Vendor, Source No. = the vendor you pay royalties to, for example V-1000.

2 · The contract

As in Phase 2 — RoyaltyCentral → Contracts → New:

  1. Header: Set Licensor No. to ACME. Set Start / End dates that include today, for example the calendar year.
  2. Contract Details — one line: Origin Region US-EAST, Sell Region NORTH-AM, Sales Type All Customers, Item Type Brand, Item Code ACME-WIDGETS, Calculation Basis Net Sale. Enter Rate Percent 5 as a whole number. This is 5%.
  3. Contract Payees — one line: ACME-PAY at 100%.
  4. Release the contract.

3 · Post a sale

Create a normal Sales Invoice for any customer in the sell region. Add item ITEM-100 at a quantity and price totaling $10,000 net, for example 100 units at $100. Post it. Nothing royalty-specific happens on the document. The invoice posts as usual.

4 · Read the royalty entry

Open Royalty Entries, or drill in from the contract card’s FactBox. When Calculate Royalty on Posting is on, the entry shows at once. Otherwise, run Calculate Royalties for today’s date first (Step 1).

Expect one entry:

Field Value
Entry Type Sale
Contract No. your contract
Payee No. ACME-PAY
Sales Amount (Actual) 10,000.00
Amt. Due (Actual) 500.00 — 5% of net sales

The entry is now royalty history. It feeds guarantee tracking, statements, and the payment cycle when you are ready to settle.

5 · Where to next


See also: The royalty workflow · Contracts · Royalty calculation · Royalty entries