Skip to main content
When UtiliRead reads an uploaded document but isn’t fully confident about one or more extracted fields, it flags the record for manual review instead of creating an invoice straight away. This guide walks through reviewing those records, resolving the flagged fields, and turning an approved extraction into a UMS invoice. Extraction records appear under Invoices › Uploads (see Invoices). Records that arrive by email are triaged first in the Inbox; once an extraction becomes an invoice, it flows into Invoice Validation.

Where review fits

A UtiliRead record moves from Queued to In progress to Success, or to Failed if processing breaks. When extraction succeeds but confidence is low on key fields, the record lands in Needs review and waits for a person.
Only records in Needs review (or with a past review) show a Review tab. A Success record needs no field resolution, so you can migrate it directly.

Open the review queue

Go to Invoices › Uploads. The Upload queue strip counts records in Needs review and Failed, and the grid lists every upload.
1

Filter to records needing attention

Click the Needs Review filter. It shows uploads that failed, are in review or look like duplicates. Open one with the status Needs review.
2

Open the record

Click the row. The detail page title reads Upload #id, with the file name underneath.
3

Compare extracted data to the source

The Overview tab shows the source document beside the extracted metadata. Use the zoom and rotate controls to read the original. Cross-check the values in the Invoices, Connections, Line Items and Raw Output tabs against the document.

Resolve the flagged fields

Open the Review tab. A warning banner shows the Review Reason, and each flagged field is listed with a confidence chip: green at 80% or more, amber from 50%, red below.
1

Pick the correct value

Each field offers the candidate values UtiliRead produced — AI Primary, AI Secondary, Tiebreaker, and the Source value read from the document. Click the one that matches the original, or choose Manual Entry and type the correct value yourself.
2

Add notes (optional)

Record why you chose a value in the notes box — useful when the document is ambiguous.
3

Submit each field

Click Submit Resolution. The field moves to Resolved and the unresolved count drops.
Resolve every flagged field before approving. When you resolve the last outstanding field, UtiliRead approves the record for you automatically — you’ll see “All fields resolved. Record approved automatically.”

Approve or reject

The Review Decision bar at the top of the tab carries the final call.
1

Approve

Once all fields are resolved, click Approve. The button stays disabled while any field is unresolved.
2

Reject

If the extraction is unusable — wrong document, unreadable scan — click Reject. Rejection is available at any time, even with fields outstanding.
For records that arrived by email, reprocessing must go through the Inbox, not the OCR record in isolation. The detail header shows Reprocess from inbox for these — it re-runs the whole email pipeline so the inbox, import records, and invoices stay consistent. Direct uploads instead offer Retry processing from scratch, Force process, Re-run AI extraction (keeps OCR data) and Re-run OCR from scratch (discards extracted data).

Turn the approved extraction into an invoice

Approval confirms the data; it does not yet create the invoice. To do that, migrate the result into UMS.
1

Start the migration

Click Migrate extracted invoices to UMS (the primary action in the detail header). It appears once extraction has produced data.
2

Choose overwrite behaviour

The Migrate UtiliRead Result to UMS dialog warns that this creates new invoices, and possibly new connections, retail accounts and suppliers. Toggle Overwrite only if you need to replace records already imported from this result.
3

Confirm

Click Migrate. On success you return to Invoices › Uploads, where the new invoice continues through validation.
Need the extracted data outside UMS? Use Export to CSV in the detail header to download the result as utiliread-<id>.csv.

Accuracy and processing stats

The Upload queue strip on the Uploads tab shows Success (24h), Auto-pilot, In queue, Needs review and Failed. For longer windows, the Upload performance section of Invoices › Overview shows Extraction success over 30 days, with 24-hour and 7-day rates underneath. To re-queue several failed or in-review uploads at once, select them on the Uploads tab and click Retry selected. This is handy after fixing an upstream issue, such as a misconfigured supplier or account match.