Royalty Setup card

The Royalty Setup card holds RoyaltyCentral’s company-wide parameters. Open it from the assisted setup, or search for Royalty Setup with 🔍 Tell me. There is one setup record for each company.

General

Field Purpose
Enabled Master switch. Turns RoyaltyCentral processing on or off for the current company. When off, the posting hooks do not create royalty entries (the app stays installed). The extension installs tenant-wide, so you can run royalties in some companies and leave it off in others. Before you turn it on, set Royalty Account No. and your License Key. The app checks both when you turn the switch on.
License Key Your activation key. The field shows only for a user who can modify the Royalty Setup record (see Licensing).

Payment

Field Purpose
Royalty Account No. The default royalty G/L account for the settlement document. A payee or a contract payee can override it (see the G/L account priority). Required before you turn Enabled on.
Royalty Invoice Type The format settlement uses: Document (a full invoice) or Journal (a journal line). It does not set the direction; see below.
Auto Post Royalty Invoice When on, the app posts each royalty invoice as it creates it. Journal lines post as part of their own run, with or without this switch.
Royalty Payment Threshold The minimum amount that a payee’s royalty total for a contract must reach before Create Royalty Invoices creates a settlement invoice or journal line. If the total is less than the threshold, the run skips that contract payee. The entries stay open and accumulate until a later run meets the threshold. Enter 0 (the default) to create a settlement for any amount. The threshold is in your local currency (LCY).

Settlement direction follows the payee. The payee’s Source Type sets the direction. A Vendor payee produces a purchase invoice or journal (you pay the royalty). A Customer payee produces a sales invoice or journal (you collect it). Royalty Invoice Type only chooses Document or Journal. The direction comes from the payee.

Note. Settlement uses one number series for each direction: Purchase Nos. for Vendor payees and Sales Nos. for Customer payees (see Numbering). If Sales Nos. is blank, customer settlements use the invoice numbers from Sales & Receivables Setup. Posted Purch. Invoice Nos. and Posted Sales Invoice Nos. set the posted invoice numbers, so the posted documents keep a recognizable royalty number.

Sales

Field Purpose
Calculate Royalty on Posting When on, the app calculates royalties as sales invoices post. When off, run Calculate Royalties for a date range and contract filter. The setting applies company-wide; a contract does not override it.
Calculate Royalty on Sales Cr. Memo When on, the app includes sales credit memos (reversals) in the royalty calculation. Set it to match your company policy.
Calc. Royalty Payment on Paid Invoice Cash-basis gating. The app still calculates the royalty, and the royalty is still owed. The setting holds it back from the payment run until the customer has paid the related sales invoice. A later run then includes it. A contract can override this default.
Rate Percent Rounding Precision The rounding precision for percentage rate calculations. Must be greater than zero.

Consumption

Field Purpose
Calculate Royalty on Consumption When on, the app tracks royalties for licensed items that assembly or production orders consume.
Royalty Consumption Type When the app recognizes the consumption royalty. Consumption: when a production or assembly order consumes the item. Sale: when you sell the finished item that contains it.

When to enable this. Turn Consumption on only when a component carries the royalty, not the finished item. Examples: manufactured, assembled, or kitted goods; components from different licensors; or a rate based on the component’s cost or price. Leave it off when only the finished item carries a royalty on sale. The setting adds processing to each sale to trace components back to what was produced.

Contract

Field Purpose
Allow Zero Royalty Detail Lines Controls whether you can release a contract that has a zero-rate detail line. You can enter zero lines while the contract is Open. With this off, the app blocks the release of a contract that still has a zero-rate line. Use a zero line to exclude a specific customer. The app matches a specific-customer line before broader lines, so a zero rate gives that customer’s sales no royalty.

Numbering

The Numbering FastTab links the number series that RoyaltyCentral uses. Create a series for each field. Follow your organization’s numbering rules.

Field Used for
Licensor Nos. New licensor records
Payee Nos. New payee records
Contract Nos. New royalty contracts
Purchase Nos. The purchase invoices or journals created when settling Vendor payees
Sales Nos. The sales invoices or journals created when settling Customer payees. Leave blank to use the invoice numbers from Sales & Receivables Setup
Posted Purch. Invoice Nos. The posted number of royalty purchase invoices. Leave blank to use the Posted Invoice Nos. series from Purchases & Payables Setup
Posted Sales Invoice Nos. The posted number of royalty sales invoices. Leave blank to use the Posted Invoice Nos. series from Sales & Receivables Setup

Tip. Give the royalty series distinct numbers, for example with a prefix. Royalty documents are then easy to find in the ledgers. This helps when the same party is both an ordinary customer and a royalty payee, because the settlement carries a recognizable number.

G/L account priority

When a royalty invoice posts, the app finds the expense G/L account in this order:

  1. Contract Payee Royalty Account No. (highest priority)
  2. Payee Royalty Account No.
  3. Royalty Setup Royalty Account No. (fallback default)