What is a Statement Template?

A Statement Template defines how a royalty statement file is interpreted, mapped, matched, and processed in Reprtoir.

While a Statement Provider identifies who delivers the statement, the Statement Template defines how the data inside the file must be read and processed.

In practice, the Statement Template is the most critical element of the royalty ingestion process. Selecting an incorrect template will lead to unmatched lines, incorrect processing, or unusable data, even if the Statement Provider itself is correct.

Why Statement Templates Matter More Than Providers

A single Statement Provider may deliver royalty statements covering different rights, asset types, or reporting models.

Each of these variations requires a distinct Statement Template because:

column structures differ
identifier usage may change
asset scope may vary
processing and calculation rules are not identical

Reprtoir does not process statements based on the provider name alone. The system relies entirely on the selected Template Name to apply the correct interpretation and processing logic.

One Provider, Multiple Templates

It is common for the same Statement Provider to offer multiple templates, for example:

digital versus physical sales
audio versus video usage
master rights versus publishing rights
regional or historical format variations

Each of these cases is handled as a separate Statement Template in Reprtoir.

This explains why the same provider may appear multiple times in the Supported Statement Providers documentation, each time associated with a different Template Name and different identifier expectations.

Template Scope and Asset Coverage

Every Statement Template defines a statement scope, meaning the type of assets and rights reported by the statement.

A template may cover one or more of the following asset types:

audio recordings
video recordings
musical works
physical or commercial products

The scope of the template determines which catalog items are involved and how statement lines are matched.

For clarity, templates are grouped in the documentation by scope, such as audio and video, audio video and works, works only, or product based statements. These groupings describe the behavior of the template, not the Statement Provider itself.

Template and Identifier Expectations

Each Statement Template specifies exactly which identifiers are supported to match statement lines with your catalog.

Depending on the template, matching may rely on:

album identifiers
track identifiers
video identifiers
work identifiers
product identifiers

When multiple identifiers are listed for a template, this means that any of those identifiers may be present in the statement file and are supported for matching.

If the required identifiers are missing from your catalog, the corresponding statement lines cannot be matched automatically and will generate processing errors.

Identifier expectations are documented in the Supported Statement Providers tables and detailed further in the dedicated identifier reference pages.

Template Selection During Import

When creating a Royalty Statement Income, the Template Name must be selected explicitly.

This selection tells Reprtoir:

how to read the file structure
which identifiers to expect
how to interpret usage and revenue data
which processing rules to apply

Once a statement has been processed, the selected template cannot be changed. If the wrong template was selected, the Income must be deleted and re ingested using the correct template.

Careful template selection at import time is essential to avoid reprocessing and data inconsistencies.

Common Mistakes When Choosing a Template

The most frequent issues encountered during statement ingestion include:

selecting a provider level template instead of a specific variant
confusing audio templates with works or publishing templates
assuming all templates from the same provider behave identically
overlooking identifier differences between similar templates
using a generic template when a dedicated one exists

When in doubt, always refer to the Supported Statement Providers documentation and any linked provider specific instruction pages before importing a statement.

Relationship with Other Royalty Accounting Concepts

Statement Templates sit at the intersection of several core Royalty Accounting concepts:

Royalty Statement Incomes define the accounting container
Statement Providers define the source of the data
Statement Templates define the structure and processing logic
Royalty Matching Identifiers enable automated matching

Understanding Statement Templates is therefore essential to operating Royalty Accounting reliably in Reprtoir and ensuring consistent, scalable royalty processing.