Skip to main content
The Inbox is where emails sent by energy retailers land. Each account has its own email address; messages addressed to it are captured, matched to the account, classified, and fed into the UtiliRead OCR pipeline so their PDF attachments become invoices. Open it from Inbox in the General section of the sidebar.
UMS Inbox showing incoming email-sourced items

From email to invoice

1

An email arrives

A retailer sends an email to an account’s inbox address. UMS captures it and matches it to the account by the recipient. If no account matches, it is marked Unmatched — No Account.
2

It is classified

The message is tagged with an email_type such as Invoice, Statement, Overdue Notice, or Data File. Non-invoice categories are marked Skipped — Non-Invoice Category.
3

UtiliRead reads the attachments

For invoice emails, UtiliRead runs OCR over the PDF attachments to extract line items, totals, and meter data.
4

An invoice is created

A matched, extracted attachment becomes an Invoice record, ready for Validation.

The inbox list

The Inbox is a split-pane review surface: a filterable list on the left, the selected message on the right. Status filter tabs group items for triage — Needs Review, Skipped, Duplicates, In Progress, Processed, Archived, and All — each with a live count. Above the list, filter by Account, Type, or a Search across subject and sender. Each row shows the subject (bold when unread), sender, the received date, an attachment icon, and chips for the message’s type, status, and pipeline outcome (for example, 2 invoices, OCR failed, or OCR review). Tick the checkboxes to Exclude or Archive items in bulk. The list auto-refreshes every 30 seconds, and Load more pages through older messages. Keyboard shortcuts speed up triage: j/k move through the list, a archives, x excludes, r reprocesses, and Enter marks an item read.

Message statuses

A message’s status reflects where it sits in the pipeline:
StatusMeaning
ReceivedCaptured and awaiting processing
ProcessingUtiliRead OCR is running
Processed SuccessfullyAn invoice was created from the email
Processed with ErrorsProcessed, but with issues to review
No Data MatchCouldn’t match the content to a connection or retail account
Unmatched — No AccountNo account matched the recipient address
Skipped — Non-Invoice CategoryClassifier tagged it as a non-invoice type
DuplicateMatches an invoice already in UMS
FailedProcessing failed
Archived / ExcludedTriaged out of the active queue

Message detail

The Inbox split view — message list on the left, selected message detail on the right
Selecting a message opens it as a single card: the From, To, Cc, Date, and a linked Account header, the rendered email body, and an attachments strip. Three chips below the header are editable in place — click to change the classification (email_type) or status, or toggle Read/Unread. The context rail shows an AI Summary of the message and the OCR result, including any duplicates detected and invoices created. Header actions let you Download all attachments, Forward the email to yourself, or Reprocess with OCR to re-run the pipeline. The three-dots menu holds Archive and Delete.
The same inbox appears as an Inbox tab on an account’s detail page (scoped to that account), and as the Inbox review tab in Validation for triaging email-sourced invoices across your portfolio.