What is a Royalty Statement Income?

A Royalty Statement Income is a file based Income used to report royalties or rights revenues received by the Organization from a third party such as a Distributor, Aggregator, Digital Platform, Publisher, or Collective Management Organization.

Unlike other Income types, a Royalty Statement Income is not a simple monetary entry. It represents a structured operational object through which royalty data is ingested, standardized, matched with the catalog, and converted into royalty calculations.

Royalty Statement Incomes are the core operational entry point of royalty processing in Reprtoir.

What Royalty Statement Incomes are used for

A Royalty Statement Income allows the Organization to:

• ingest one or more royalty statement files
• normalize heterogeneous provider formats into a unified internal structure
• match statement lines with catalog assets, works, or products
• apply contractual royalty rules
• generate detailed royalty calculations and reporting

Every royalty calculation performed in Reprtoir starts from a Royalty Statement Income.

Royalty Statement Income versus other Income types

Royalty Statement Incomes are designed for line level, usage based revenues reported in external files.

They differ fundamentally from Other Incomes, which typically represent:

• flat or negotiated amounts
• sync or license fees
• direct payments
• non file based revenues

Because of their complexity and volume, Royalty Statement Incomes rely on a dedicated processing pipeline, documented separately from other Income types.

Where to find Royalty Statement Incomes

Royalty Statement Incomes are displayed in the Incomes list.

To access them, open the navigation menu on the left, click the “Royalty Accounting” icon, locate the “Transactions” section, and click the “Incomes” list.

Royalty Statement Incomes coexist with other Income types in the same list, but they follow a specific processing lifecycle.

Key concepts involved

Processing a Royalty Statement Income relies on several core concepts that work together:

• Statement Providers, which define who delivers the statement
• Statement Templates, which define how the file is structured and processed
• Royalty Matching Identifiers, which enable automated matching with the catalog
• Royalty Statement Processing, which transforms raw data into calculated royalties
• Rules, which store reusable correction and standardization decisions across Royalty Statement Incomes

Each of these concepts is documented in a dedicated subpage and should be understood before importing statements at scale.

Recommended Processing Order

When processing multiple Royalty Statement Incomes from the same Statement Provider, it is strongly recommended to process them one by one, in chronological order.

Reprtoir progressively learns from corrections and standardization decisions made during statement processing. However, these corrections are only reused once a Royalty Statement Income has completed the entire processing workflow, including calculation.

Processing statements sequentially ensures that:

• corrections made on an earlier statement are automatically reused on subsequent ones
• standardization rules are applied consistently across periods
• only new or genuinely different errors appear on later statements
• the same issues are not corrected multiple times unnecessarily

If several statements are processed in parallel or out of order, identical errors may need to be corrected repeatedly.

For detailed behavior and best practices related to error correction and reuse, refer to the “Handling Data Errors” documentation.

What this section covers

The Royalty Statement Incomes section documents everything related to statement based royalty processing, including:

• how statement data is interpreted and matched
• how templates and identifiers work
• how statement files are ingested and validated
• how errors, quarantines, and reprocessing are handled
• how royalties are calculated from statement data

This section does not cover non statement based revenues, which are documented separately under Other Incomes.