Common situations and how to resolve them, in order.
The assistant cannot connect
Confirm the AI Gateway is enabled in Settings.
Confirm you copied the correct Connection URL from the General tab.
Confirm your AI client can reach your iVendNext web address.
Confirm the connection settings on the OAuth tab are on (they are by default).
Try the connection again and complete the iVendNext login when prompted.
"Access denied" or "Permission denied"
Confirm the user has the Assistant User role.
Confirm the Enable Assistant Access checkbox is ticked on the user record.
Confirm the user has permission for the document type in question. If they cannot open it directly in iVendNext, the assistant cannot either.
For a privileged action, confirm the user holds a role allowed to use that tool.
"Tool not found" or a capability is missing
Confirm the capability pack that contains the tool is switched on.
Confirm the specific tool is enabled in tool management.
Use the Refresh Capability System action on the Settings screen, then reconnect.
A report comes back empty
The filters are almost certainly the cause. Ask the assistant to check the report's requirements and run it again with explicit filters.
Provide a clear date range and the exact company name.
Confirm there is data in the period you asked about.
Slow responses on large requests
Narrow the request: a shorter date range, fewer records, a more specific filter.
For heavy reports, allow time for the background run to finish, then ask again to retrieve the ready result.
For analysis, reduce the number of records being studied.
Document recognition returns poor results
Use a clearer, higher-quality scan or image.
Set the correct language for the document.
For complex layouts, ask your administrator to select the enhanced recognition engine on the Document Recognition tab.
When to escalate
If a problem persists after these steps, gather the relevant audit log entries (they capture the action, user, status, and any error) and raise it with your iVendNext support contact.