Common System Errors

Common System Errors & Solutions

A quick reference guide for the most frequently encountered errors in the OLY system and how to fix them.

Permission Errors

"Insufficient Permission for [DocType]"

Cause: Your role doesn't have access to this document type. Fix:

1. Check if you're logged into the correct account
2. Contact your Department Head to request access
3. IT Admin will update your Role Profile if approved

"Cannot Edit Submitted Document"

Cause: The document has been submitted (finalized) and is locked. Fix:

1. Click Menu > Amend to create a corrected version
2. Or ask a user with Submit permission to amend it
3. Note: Not all doctypes support amendment

Data Errors

"Value Missing for Required Field"

Cause: A mandatory field was left blank. Fix: Fill in all fields marked with a red asterisk (*) before saving.

"Duplicate Entry"

Cause: A record with the same unique identifier already exists. Fix:

1. Search for the existing record first
2. Update it instead of creating a new one
3. If it's a legitimate new entry, check the naming series

"TimestampMismatchError"

Cause: The document was modified by another user while you were editing. Fix:

1. Refresh the page (Ctrl+R / Cmd+R)
2. Re-apply your changes on the latest version
3. Save again

Connection Errors

"NetworkError" or "Failed to Fetch"

Cause: Internet connection issue or server temporarily unavailable. Fix:

1. Check your internet connection
2. Try refreshing the page
3. Wait 30 seconds and try again
4. If persistent, contact IT Admin

"Session Expired"

Cause: You've been inactive for too long, or logged in from another device. Fix:

1. Refresh the page — you'll be redirected to login
2. Log in again with your credentials
3. If using 2FA, have your authenticator app ready

Print/PDF Errors

"PDF Generation Failed"

Cause: The print format has an error, or the PDF engine is overloaded. Fix:

1. Try a different print format (standard)
2. Wait 1 minute and try again
3. Check if special characters in the document might cause issues
4. Report to IT if it persists

Email Errors

"Email Not Sent"

Cause: Email queue is full, or the email account has an issue. Fix:

1. Check Email Queue (search bar → Email Queue)
2. If your email shows "Error", check the error message
3. Common causes: attachment too large, invalid recipient address
4. Contact IT Admin for email server issues

General Troubleshooting Steps

1. Refresh the page (Ctrl+R) — solves 50% of issues
2. Clear browser cache (Ctrl+Shift+Delete)
3. Try a different browser (Chrome recommended)
4. Try incognito/private mode — rules out extension issues
5. Check the URL — make sure you're on https://oly.et
6. Report the issue — screenshot the error and submit to Help Center

When to Contact IT Admin

• Error persists after trying all steps above
• You see "Internal Server Error" (500 error)
• Data appears corrupted or missing
• You suspect a security breach
• System is extremely slow for extended periods