Processing error notice
The Processing Error notice means the agent could not finish processing the document. The most common causes are an unreadable scan, a corrupted file, or an extraction failure during the run.
This notice is a system signal rather than a validation rule. It is generated when extraction fails outright, not when the extracted data fails a check.
Where the notice appears
The notice appears as a row inside the Document notices panel on the left side of the invoice detail page, between the page breadcrumb and the document viewer. The panel header reads N Exceptions (where N is the number of active notices). Click the panel header to expand it; the Processing Error row appears with the failure phase and a short message.
The Document notices panel is the small bordered box on the left side. Click its header to see the individual error rows; each row can be expanded for details.
What triggers it
Common causes:
- Unreadable document. The file is too low resolution, too blurry, or too distorted for OCR to recover text.
- Corrupted file. The file did not download cleanly or is partially malformed.
- Unsupported format. The agent could not parse this file type.
- Extraction failure. A transient error during the run (rare).
The notice carries the error phase (where in the pipeline the failure happened) and recommended recovery steps.
Resolve the notice
The recovery path depends on the cause.
If the document is unreadable
Re-acquire the document at a higher resolution.
- Get a clearer copy of the document. If you have a paper original, scan it at 300 DPI or higher.
- Cancel the failed invoice. From the invoice detail page, click the red Cancel Invoice button in the action bar at the top-right of the page (the action bar shows Reject / Submit / Hold / Cancel Invoice — Cancel Invoice is the rightmost). A confirmation dialog appears; click Confirm to remove the failed invoice from your active list.
- Go back to the Invoices list (click Invoices in the left sidebar). In the top-right, click + New Invoice → Upload file and pick the clearer file.
The new invoice goes through extraction normally.
If the file is corrupted
Re-download the original from the source (vendor email, vendor portal, ERP) and upload again.
- Cancel the failed invoice.
- Get a fresh copy of the file.
- Upload as a new invoice.
If the format is unsupported
Convert to a supported format (PDF, PNG, JPEG, TIFF, or DOCX). For example, an HEIC image from a phone camera needs to be converted to JPEG before upload.
If the failure was transient
If the document itself is fine and you believe the error was a one-off - for example, an extraction timeout or a temporary upstream failure - re-upload the same file as a new invoice. Most transient failures resolve on the second attempt. Cancel the failed invoice once the new one is created so it does not clutter your queue.
When to contact support
If the same document fails repeatedly even after re-uploading a clean version, email support@usemod.ai with the invoice ID. The support team can look at the extraction logs and identify whether the failure is on the document side or platform side.