BeyondERP.Newsletter
Menu

Setup page · Accounts payable

Royalty agreements

The page where royalty contracts are registered; a royalty contract records an agreement with an asset or intellectual property owner.

Used by
Sales clerk, Sales manager
Business process
Establish royalty commissions in Dynamics 365 Supply Chain Management
Menu item
MCRRoyaltyTable
Main table
MCRRoyaltyContract
Data entity
MCRRoyaltyAgreementHeaderEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isThe page where royalty contracts are registered; a royalty contract records an agreement with an asset or intellectual property owner.
What you do hereUse this page to set up the qualifying products, the period for cumulating sales, whether claim approval is required, the accrual and expense accounts, and the royalty rates or tiers, and then validate the agreement.
ExampleWhen a sales order line for a product covered by a valid royalty contract is invoiced, a royalty claim is created.
Royalty agreements page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Royalty agreements1 screen

Registers agreements with licensors that define which products, accumulation periods, approval needs and tiered rates generate royalty fees to be accrued and paid.

  1. Screen 1

    Create the royalty agreement and its line

    Go to Accounts payable > Broker and royalties > Royalty agreements, Overview tab

    1. Select New and fill in the agreement row
    2. On the Lines tab, select Add line
    3. Fill in the royalty line
    1Royalty contractBEAT-ROYALTY
    2Line codeBEAT-ROY
    Vendor accountBEAT-000001
    DescriptionUnvalidated draft
    Unitea
    Unit typeInventory unit
    Unit of measure royaltyConvert
    Calculation date typeCreated
    Start date10/7/2026
    End date12/31/2026
    CurrencyUSD
    Amount typeAmount per unit
    Create the royalty agreement and its line (zoomed on the outlined fields)
    Show the full screenCreate the royalty agreement and its line
    page title tab to open what to set or check

How to use it

  1. Go to Accounts payable > Broker and royalties > Royalty agreements.
  2. Select New to add an agreement, then fill in the Royalty contract, Vendor account, Description and Unit.
  3. Enter the Calculation date type, Start date and End date.
  4. In the Lines tab, select Add line and fill in the Royalty code, Vendor account, Currency, Unit and Amount type.
  5. Use the Cumulate, Price, Royalty program accounts, Currency, Approval, Line breaks and Validation sections to complete the agreement.
  6. Select Validation on the Action Pane, then Save.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it meansExampleTable column
Cumulate sales byThe period the royalty is calculated over, or Invoice to calculate on each invoiced line.Microsoft Learn CumulateSalesBy
Approval requiredWhen Yes, claims must be approved before they become a payable invoice.Microsoft Learn ApprovalRequired
Accrual accountReceives accrued royalty amounts between approval and processing, with the Expense account.Microsoft Learn LedgerDimension
Royalty amountsThe royalty rates, which can be set in tiers using From value and To value.Microsoft Learn
SelectionThe products that qualify for a royalty fee.Microsoft Learn
ValidatedSet to Yes by the Validation action; the agreement is only valid after that.Microsoft Learn Validated
Royalty contractThe code that identifies the royalty contract.Microsoft Learn STANDARDRoyaltyContract
Vendor accountThe vendor account of the licensor who is paid the royalty.Microsoft Learn BEAT-000001
DescriptionA short description of the royalty contract.Checked in Dynamics 365Unvalidated draftDescription
Unitea
Unit typeInventory unitUnitType
Unit of measure royaltyConvert
Calculation date typeCreatedCalcDates
Start date10/7/2026EffectiveFromDate
End date12/31/2026
Line codeSALES
CurrencyUSDCurrency
Amount typeAmount per unitRoyaltyAmtType

Test checklist

  1. Create a royalty agreement for a test product with a tiered rate, accrual and expense accounts, and run Validation.
  2. Turn on Enable price details in Accounts receivable parameters, create a sales order line and check the Royalty FastTab on Price details.
  3. Invoice the order and check that a royalty claim appears on Royalty claims.
  4. Run Cumulate and check the accrual voucher, then Process and check the vendor invoice is posted.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Royalty agreementsCumulate sales by the period the licence agreement uses (or Invoice to calculate per invoiced line), Approval required per company policy, then select ValidationCumulate sales by sets the period the royalty is calculated for, and an agreement is valid only after Validation sets Validated to Yes.Not running Validation: the agreement isn't valid, so sales of qualifying products don't generate royalty claims.
Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneHard to reverse: The agreement can be edited, but claims already generated and accrual journals already posted by Cumulate stay as they are. Microsoft Learn
Technical architect

6Technical

Menu itemMCRRoyaltyTable Checked in Dynamics 365
FormMCRRoyaltyTable Checked in Dynamics 365
TableMCRRoyaltyContractShown as “Royalty contract” in Record infoChecked in Dynamics 365
Data entitiesMCRRoyaltyAgreementHeaderEntityRoyalty agreement headers Microsoft data model
Who can open itPrivilegesMaintain royalty definitions MCRRoyaltyTableMaintainView royalty definitions MCRRoyaltyTableViewDutiesView royalty definitions MCRRoyaltyTableInquireMaintain royalty definitions MCRRoyaltyTableMaintain
3 security roles MCRTestUserRoleSales clerk TradeSalesClerkSales manager TradeSalesManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSales clerk TradeSalesClerkTo use itSales manager TradeSalesManagerGive people one of these roles. On this system, 2 roles can open this page.Checked in Dynamics 365
Actions on the pageButtons: ValidationChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=MCRRoyaltyTable
Integrate withMCRRoyaltyAgreementHeaderEntity data entity Microsoft data model
Data migrationMCRRoyaltyAgreementHeaderEntity (Royalty agreement headers): loaded for each company.Microsoft Learn
Table definitionMCRRoyaltyContract columns and relations Microsoft data model
Everyone

8Sources