---
title: "Common System Errors"
space: "Help Center"
url: "https://oly.et/help-center/common-errors"
updated: "2026-03-01"
---

## 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
