7 Common SASAMS Errors and How to Fix Them (2025)

Every term, thousands of South African school administrators face the same frustration: SASAMS errors that block mark submissions, delay reporting, and create unnecessary stress. This guide covers the 7 most common SASAMS errors and their solutions.

Tired of SASAMS errors? MyEncore prevents most of them automatically.

See How It Works

Error 1: "Learner Not Found" When Importing Marks

The Problem: You're trying to import marks but SASAMS says certain learners don't exist in the system, even though they're enrolled at your school.

The Solution:

Check if the learner's ID number matches exactly between systems
Verify the learner is registered in SASAMS (not just your school system)
For new learners, ensure they've been captured in SASAMS first
Check for extra spaces or formatting issues in ID numbers

Prevention tip: Always import your learner list FROM SASAMS at the start of the year, rather than creating learners separately in each system.

Error 2: Subject Code Mismatch

The Problem: SASAMS rejects your marks because the subject codes don't match. Your system says "Mathematics" but SASAMS expects "MATH GR7" or a specific subject code.

The Solution:

Download the official SASAMS subject list for your phase
Map each subject in your school system to the exact SASAMS subject code
Pay attention to grade-specific variations (e.g., "MATH GR7" vs "MATH GR8")
Check for language variations (English vs Afrikaans subject names)

Error 3: "Invalid Mark Range" Errors

The Problem: SASAMS rejects marks as "out of range" even though they look correct to you.

The Solution:

Check if you're entering percentages vs raw marks (SASAMS expects percentages)
Ensure no marks exceed 100 or go below 0
Look for accidental decimals (e.g., "75.5" instead of "76")
Verify the assessment type allows the mark range you're entering

Error 4: "Assessment Not Found" or Missing Assessment Tasks

The Problem: The assessments in your school system don't appear in SASAMS, or SASAMS has different assessment structures than what you've captured.

The Solution:

Check that your assessment structure matches the CAPS requirements in SASAMS
Ensure you're mapping to Formal vs Informal assessments correctly
Verify the term structure matches (Term 1, 2, 3, 4)
Contact your district if assessment structures seem incorrect in SASAMS

Related: For a complete overview of how SASAMS integration should work, see our Complete SASAMS Integration Guide.

Error 5: Import File Format Errors

The Problem: SASAMS won't accept your CSV or Excel file. You get errors about file format, encoding, or structure.

The Solution:

Save as CSV (Comma Delimited), not CSV UTF-8
Remove any special characters (accents, symbols) from names
Ensure column headers match SASAMS requirements exactly
Check for hidden characters by opening in Notepad
Don't include empty rows at the bottom of your file

Error 6: Duplicate Learner Records

The Problem: SASAMS shows duplicate learner entries, or marks aren't saving to the correct learner profile.

The Solution:

Search SASAMS for the learner using their ID number (not name)
Check if the learner was transferred and has multiple records
Contact your district SASAMS coordinator to merge duplicate records
Verify you're using the correct EMIS number for transfers

Error 7: "Session Timeout" During Large Imports

The Problem: SASAMS times out or crashes when importing large datasets, losing your progress.

The Solution:

Break large imports into smaller batches (one class at a time)
Import during off-peak hours (early morning or late afternoon)
Use a stable internet connection (avoid mobile data)
Keep the SASAMS tab active while importing (don't switch tabs)

How MyEncore Prevents These Errors

Auto-validation: Catches invalid marks before they reach SASAMS
Smart subject mapping: Maps your subjects to SASAMS codes
Learner sync: Keeps learner data synchronized between systems
Direct integration: No CSV files, no format errors
Batch processing: Handles large datasets without timeouts

Book a Demo

When to Contact Your District

Some SASAMS issues require district-level support:

Merging duplicate learner records
Correcting EMIS numbers
Assessment structure changes
Permission or access issues
Data that was incorrectly submitted and needs correction

Keep your district SASAMS coordinator's contact details handy. They can resolve system-level issues that school-level access can't fix.

Preventing Future SASAMS Errors

The best way to avoid SASAMS errors is to use school management software with proper SASAMS integration. When your systems are properly connected:

Learner data stays synchronized automatically
Subject codes are mapped once and work every time
Mark validation happens before submission
No manual CSV exports or imports required
Errors are caught and explained clearly

Stop Fighting SASAMS Errors

MyEncore's automated SASAMS integration eliminates the manual processes that cause most errors. See the difference proper integration makes.

Book Your Free Demo

← Back to News