Step 1 — Calculate royalties

The first processing step turns posted transactions into royalty entries. Each qualifying sale (or consumption) on a released contract produces a typed entry in the Royalty Entries ledger. The entry carries the calculated amount due, split per payee. These entries are the input to Step 2 — Calculate payments.

How it runs

Two modes, governed by Calculate Royalty on Posting on the Royalty Setup card:

Mode Processing
On posting Automatic. RoyaltyCentral evaluates sales invoices as they post. There is nothing to run.
Manual batch Run Calculate Royalties (RoyaltyCentral → Calculate) for a date range and an optional contract filter. It scans posted sales in the range and creates the eligible entries.

For each posted sale, RoyaltyCentral:

  • resolves the Origin Region from the document’s location;
  • resolves the Sell Region from the Sell-to Country/Region Code on the royalty entry, copied from the item ledger entry of the posted sale;
  • finds released contracts whose detail lines match the item/brand, dates, and regions;
  • applies the line’s rate (fixed + percentage of the calculation basis);
  • writes one Sale entry per contract payee with that payee’s share.

Keep these points in mind:

  • RoyaltyCentral does not block sales. Calculation runs after posting. A sale that matches nothing produces no entry and no error. Licensed and unlicensed items can share an order.
  • Only invoiced sales count. Ship-only and undo-shipment postings create no entries.
  • Credit memos post Return entries when enabled in setup.
  • Consumption royalties post Consumption entries for licensed components consumed in assembly or production. The setup decides whether RoyaltyCentral recognizes them at consumption time or when the finished item sells. See consumption royalties.

Catching up a period

Run the Calculate Royalties batch over a past date range when you need to. It skips sales already processed for a contract, so a second run does not duplicate entries. This is the tool for the common pattern: sell first, add the item or rate to the contract later, then recalculate the period. It is worth a periodic run even with on-posting enabled.

Corrections

  • Manual entries — use the Royalty Journal to record a Sale, Return, or Adjustment that the calculation cannot see. An example is royalties owed on an off-system transaction. Lines validate against the released contract and post to the same ledger. See the Royalty Journal.
  • Backing out a posted entry — use Reverse Entry on the Royalty Entries page (it needs the admin permission set). It posts a linked, offsetting Reversal and flags the original. Do not post negative journal lines to cancel entries. See Royalty entries.

Confirm the result

Open Royalty Entries, or drill in from the contract card’s FactBox totals. Confirm that the period’s entries are there with the amounts you expect. Check the entry type, contract, payee split, and Amt. Due (Actual). The Royalty Due report gives the same picture summarized by contract. What Step 2 pays is what this step produced.


Next: Step 2 — Calculate payments

See also: Royalty calculation · Royalty entries · Contracts