Skip to main content

Overview

Upload your royalty statements to the Files section for automated processing. The system validates, extracts, and categorizes statement data, then matches revenue lines to your catalog and contracts.

File Requirements

RequirementValue
FormatsExcel (.xlsx, .xls), CSV (.csv), Tab-delimited (.tab, .tsv, .txt), PDF (.pdf)
Minimum file size250 bytes
Maximum file size2 GB

How to Upload

  1. Go to StatementsFiles in the sidebar
  2. Click the Upload button in the toolbar, or drag and drop files into the main area
  3. Select one or more files from your computer
    • Hold Cmd (Mac) or Ctrl (Windows) to select multiple files
  4. All selected files are uploaded and queued for processing
The system uses parallel processing and can handle multiple statements at once. You can continue working while uploads and processing run in the background.

Processing Pipeline

After upload, each statement goes through three main phases.

Phase 1: Pre-Processing

During pre-processing, the system validates and analyzes your file before extraction begins.
CheckWhat It Does
File size validationEnsures file is within size limits
File type validationConfirms the file is a supported format
Format detectionIdentifies structure (sheets, columns, tables)
Sheet analysisDetermines which sheets or pages contain revenue, summary, or cost data
If validation fails, the statement is marked as failed with a message explaining why.

Phase 2: Extraction

Once pre-processing passes, AI extraction begins. The system:
  • Identifies statement format and data locations
  • Extracts line-by-line data (assets, revenue, sources)
  • Detects and normalizes currencies (transaction and royalty)
  • Categorises revenue by type (streaming, download, sync, etc.) — see Data Categorisation for categories
  • Extracts summary totals, balances, parties, and notes when present
Processing time depends on file size and complexity. Large spreadsheets or multi-page PDFs may take several minutes. You can monitor progress in the Files list.

Phase 3: Asset Matching

After extraction, the system matches statement lines to your catalog:
  • Recording statements: match by ISRC, UPC, asset title, and product
  • Publishing statements: match by ISWC, work title, and writer
Match results appear in the Assets section and on each statement’s Assets tab.

Processing Statuses

StatusDescription
UploadingFile transfer in progress
QueuedWaiting in the processing queue
ProcessingPre-processing or extraction in progress
MatchingAsset matching in progress
ReviewReady for user review
CompleteFully processed
ErrorProcessing encountered an issue
Once complete, a confidence score appears in the Status column. Click it to see a breakdown by section (Revenues, Summary, Summary Lines, Costs). Use Retry from the statement detail page to reprocess after fixing metadata or adding instructions.

Managing Failed and Dismissed Statements

After uploading, statements that cannot be processed appear as Failed in the staging panel. You can dismiss individual failed statements or dismiss them all at once. Dismissed statements move to the Dismissed tab where you can review or permanently delete them.

Dismiss All Failed

When the Failed filter is active in the staging panel, a Dismiss All button appears at the bottom of the list. This moves every failed statement to the Dismissed tab in one step.
1

Open the staging panel

Go to StatementsFiles and open the staging panel that shows uploaded statements and their statuses.
2

Select the Failed filter

Click the Failed filter to show only failed statements.
3

Click Dismiss All

Click the Dismiss All (n) button at the bottom of the list.
4

Confirm

Review the confirmation dialog and click Dismiss All to move all failed statements to the Dismissed tab.

Delete All Dismissed

When the Dismissed filter is active in the staging panel, a Delete All button appears at the bottom of the list. This permanently removes all dismissed statements.
1

Open the staging panel

Go to StatementsFiles and open the staging panel.
2

Select the Dismissed filter

Click the Dismissed filter to show only dismissed statements.
3

Click Delete All

Click the Delete All (n) button at the bottom of the list.
4

Confirm

Review the confirmation dialog and click Delete All to permanently remove all dismissed statements.
Deleting dismissed statements is permanent and cannot be undone.

Bulk Uploads

You can upload many statements in one go:
  • Select multiple files in the file picker, or drag and drop several files at once
  • Each file is queued independently and processed in parallel where capacity allows
  • Track progress via status in the Files list
  • Use filters to narrow by status (e.g. Processing, Error) and bulk actions to edit or delete multiple statements
When all statements in a batch finish processing, you receive an email summary with the total count, successful, failed, and processing time — if project notifications are enabled in Settings → Notifications.

Files Overview

List view, status, and confidence scores.

Statement Details

View extracted data and reprocess.

Reprocessing

Retry processing and use AI instructions.