Skip to main content

Troubleshooting​

Installation and setup issues​

ProblemSolution
Extension won't installVerify ExFlow is installed, BC version is 26.2+, and valid permissions are in place
Enabled cannot be set for a companyRun Related --> Run data upgrade on the setup page first
View predictions is unavailable in the import journalThe data upgrade has not run in the company. Run Related --> Run data upgrade
"Job queue category must have a value" when scheduling the job handlerSelect a Job queue category for the current company in the Companies section
"Insufficient permissions to schedule job queue entries."The user needs read access to Job Queue Entries in all companies

Onboarding and authentication issues​

ProblemSolution
The sign-in window does not open, or "A popup window was blocked"Allow pop-ups for the Business Central site, refresh the page and try again
"Authorization did not complete"Check that the service user has the Truvio.SubscriptionService app role and that admin consent has been granted, then try again
"Authentication Email must have a value" during registrationFill in Authentication Email on the Business Central user, then run the onboarding again
TruvioSense features have stopped workingOpen Onboarding status. If Core Service Login is No, select Login to core services

Export issues​

Check the Error message column on the TruvioSense Documents page.

ProblemSolution
"No PDF attachment found for incoming document entry no. ..."The document has no PDF. Only documents with a PDF attachment are exported
"Remote server connection failed"The service could not be reached. The export is retried on the next run
A message that the response time from the TruvioSense image export service is slowSelecting Yes stops sending document images from the import journal for the rest of the session. Continuous export enabled then shows No. Start a new session to resume
All documents need to be exported againSelect Related --> Reset data on the setup page. This cannot be undone

Prediction issues​

"There are no TruvioSense predictions available for this document." — Check in order:

  1. Company and vendor enabled for TruvioSense?
  2. Document image sent? (Document image sent = Yes on TruvioSense Documents)
  3. Vendor has 20+ exported documents?
  4. 48+ hours since first export?

"Document image sent must be equal to 'Yes'" — The PDF of the journal document has not been sent yet. Check that the vendor is enabled, update the document in the import journal, and try again. Check Error message on TruvioSense Documents if the problem remains.

"Prediction mapping is not defined in company ..." — Open Prediction mapping and select Reset to default.

Predictions are inaccurate — Usually means insufficient data (need 50+ documents) or inconsistent historical coding. Continue coding correctly and allow 30–60 days.

Job queue issues​

StatusAction
ErrorReview error message, fix issue, set to Ready
On HoldSet to Ready
MissingSelect Schedule job handler on the setup page