Skip to Content
TroubleshootingUtility processing help

Utility processing help

This page helps Utility Manager users recover when a utility document does not upload, stays in processing, fails parsing, lacks facility assignment, or cannot be reviewed. Use it before re-uploading the same document.

Before you start

  • Confirm you are in the correct organization.
  • Open Utility Bills and find the source document.
  • Note the file name, activity type, facility, and parsing status.

Check accepted format

Utility document upload expects PDFs for automated parsing. Use manual entry or bulk import for supported activities that are not automatically parsed.

Read the status

Use Parsing Status to decide whether to wait, review, or reprocess. Processing and queued states may need more time.

Assign or confirm facility

If the facility is missing, use the facility assignment control when available. Service-address matching can suggest a facility, but a reviewer should confirm it.

Reprocess only when needed

Use Reprocess when a document failed or needs another extraction attempt. Avoid repeated reprocess clicks while a document is already queued.

What happens next

A successful reprocess should move the document back through queueing and extraction, then make review available. Facility assignment updates the table and helps reports group the resulting data.

If you do not see this option

Reprocess, facility assignment, and upload controls may require write access. Review may be hidden until parsed bill data exists.

Troubleshooting

  • Failed to upload files: retry a valid PDF and reduce batch size.
  • Processing for a long time: refresh, check status, then contact support if it remains stuck.
  • Unable to assign facility: confirm the facility exists and the selected bill has a valid count.
  • Review unavailable: the document may not have parsed bill data yet.