Troubleshooting
Installation and setup issues
| Problem | Solution |
|---|---|
| Extension won't install | Verify ExFlow is installed, BC version is 26.2+, and valid permissions are in place |
| Enabled cannot be set for a company | Run Related --> Run data upgrade on the setup page first |
| View predictions is unavailable in the import journal | The data upgrade has not run in the company. Run Related --> Run data upgrade |
| "Job queue category must have a value" when scheduling the job handler | Select 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
| Problem | Solution |
|---|---|
| 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 registration | Fill in Authentication Email on the Business Central user, then run the onboarding again |
| TruvioSense features have stopped working | Open 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.
| Problem | Solution |
|---|---|
| "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 slow | Selecting 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 again | Select 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:
- Company and vendor enabled for TruvioSense?
- Document image sent? (Document image sent = Yes on TruvioSense Documents)
- Vendor has 20+ exported documents?
- 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
| Status | Action |
|---|---|
| Error | Review error message, fix issue, set to Ready |
| On Hold | Set to Ready |
| Missing | Select Schedule job handler on the setup page |