Skip to main content

Edit Statement Dialog

Open Edit from the statement detail page to update metadata and add instructions for the AI. The dialog has three sections.

Accounting Period

Set or correct the period covered by the statement:
FieldDescription
YearAccounting year (e.g. 2024)
TypeMonthly (M), Quarterly (Q), Half-yearly (H), or Annual (Y)
NumberFor M: 1–12 (January–December). For Q: 1–4. For H: 1–2. Not used for Annual.
The period is used for reporting and for currency conversion (sales period date).

Currency

FieldDescription
Transaction CurrencyCurrency of the underlying sales transactions
Royalty CurrencyCurrency you are paid in
If the system did not detect currencies during processing, set them here and then use Retry so amounts are interpreted and converted correctly.

Instructions

The Custom instructions field is a free-text area that is passed to the extraction/automap process when you run Retry. Use it to guide the LLM when the statement has an unusual layout or naming. Examples:
  • “The first column in the PDF is always the track title, not the ISRC.”
  • “Ignore the first two header rows on every page.”
  • “Map the column labeled ‘Net Amount’ to Licensor Revenue.”
  • “This statement has two revenue tables; the second one starts on page 4.”
Instructions are stored with the statement and used on every subsequent retry until you change or clear them.

Best Practices for Instructions

PDFs and spreadsheets with non-standard structure (e.g. merged cells, multiple tables, inconsistent headers) benefit from short, concrete instructions.
Refer to exact column names, row positions, or page numbers when possible (e.g. “Column D is royalty amount” rather than “one of the columns has the amount”).
Split complex guidance into separate sentences so the model can apply each rule clearly.
After saving Edit (period, currency, or instructions), use Retry so the statement is reprocessed with the new settings. Instructions are only used during processing.

Retry Processing

Retry (in the statement header actions) reruns the automap/extraction process for this statement. Use it when:
  • You have updated accounting period, currency, or instructions in Edit and want to re-extract with the new metadata
  • A previous run failed or produced low confidence and you want to try again
  • You fixed the source file and re-uploaded (or you want to re-run without re-uploading)
The retry uses the statement’s current settings, including any text in Instructions. Processing status will move to Queued then Processing; when it finishes, the Contents and other tabs will reflect the new extraction.

View Mappings

View Mappings opens a view of how columns in the uploaded file were mapped to statement fields (e.g. which column became “Licensor Revenue”, “Track Title”, etc.). Use it to:
  • Understand why a value ended up in a given field
  • Debug extraction when totals or line items look wrong
  • Decide what to put in Instructions for the next Retry
View Mappings is read-only; to change mappings, add Instructions and run Retry.

Statement Details

Tabs and all header actions.

Upload

Processing pipeline and statuses.