Why is my SASAMS upload failing?

SASAMS uploads commonly fail due to data validation errors, incorrect file formats, or server connectivity issues. Check your data for invalid ID numbers, missing required fields, duplicate entries, or format mismatches. Also ensure you're using the correct file format (.csv or .xml as required) and that the SASAMS server is available.

How do I fix SASAMS ID number validation errors?

South African ID numbers must be exactly 13 digits and pass the Luhn check digit validation. Common causes of ID errors include: typos in the ID number, using passport numbers in the ID field, incorrect date of birth digits, or invalid check digit. Verify the ID against the learner's official documentation.

What does 'duplicate record found' mean in SASAMS?

A duplicate record error means SASAMS has found another entry with the same identifying information (usually ID number or learner number). This can happen when a learner was previously enrolled at another school and not properly transferred, or when the same learner was accidentally entered twice. Contact your district office to resolve cross-school duplicates.

Why are my SASAMS marks not saving?

Marks may fail to save if: the assessment period is closed, the marks are outside the valid range (usually 0-100), required subjects are missing, or the learner is not properly enrolled for that subject. Ensure all learner subject registrations are complete before entering marks.

How can I prevent SASAMS errors?

Use school management software like MyEncore that validates data before export to SASAMS. MyEncore checks ID numbers, required fields, data formats, and business rules, catching errors before they reach SASAMS. This saves hours of troubleshooting and prevents submission failures.

SASAMS Errors and How to Fix Them

If you've worked with SASAMS, you've experienced the frustration: you've spent hours preparing your data, hit submit, and... error. Rejected. Sometimes the error messages are cryptic, and finding the problem feels like searching for a needle in a haystack.

This guide covers the most common SASAMS errors, explains what causes them, and shows you exactly how to fix them.

Understanding SASAMS Error Types

SASAMS errors generally fall into four categories:

🔍

Validation Errors

Data that doesn't match expected formats—invalid IDs, wrong date formats, missing required fields.

👥

Duplicate Errors

Records that conflict with existing entries—same ID number, learner already registered elsewhere.

📁

File Errors

Problems with the upload file itself—wrong format, corrupted file, encoding issues.

🔌

System Errors

Server-side issues—timeouts, maintenance windows, connectivity problems.

ID Number Validation Errors

The most common SASAMS error involves South African ID numbers. These errors occur because SASAMS strictly validates ID numbers using the Luhn algorithm.

Error: "Invalid ID Number" or "ID Check Digit Failed"

The 13-digit ID number doesn't pass validation. Either a digit is wrong, or the check digit (last digit) is incorrect.

Solution

Verify the ID number against the learner's official ID document or birth certificate. The ID structure is:

Digits 1-6: Date of birth (YYMMDD)
Digit 7: Gender (0-4 = female, 5-9 = male)
Digits 8-10: Sequence number
Digit 11: Citizenship (0 = SA citizen, 1 = permanent resident)
Digit 12: Usually 8 (deprecated)
Digit 13: Check digit (calculated)

            Common ID Errors
            Transposed digits (typing error)
Using passport number instead of ID number
Date of birth doesn't match ID number digits
Foreign learners entered with invalid SA ID format

        

Duplicate Record Errors

Error: "Duplicate Record Found" or "Learner Already Exists"

SASAMS found another record with the same identifying information. This usually means the learner is registered at another school or was previously enrolled and not properly exited.

Solution

Check if the learner transferred from another school—request a transfer in SASAMS
Verify you don't have duplicate entries in your own data
Contact your district office if the learner appears at multiple schools
For genuinely new learners with duplicate IDs, verify the ID document—the number may be wrong

Missing Required Fields

Error: "Required Field Missing" or "Null Value Not Allowed"

A mandatory field is empty. SASAMS requires specific data for every learner.

Solution

Ensure all required fields are populated:

Learner name and surname
ID number OR date of birth (one is required)
Gender
Home language
Grade
Admission date
At least one parent/guardian contact

Date Format Errors

Error: "Invalid Date Format" or "Date Out of Range"

Dates must be in the format SASAMS expects, and must be logically valid.

Solution

SASAMS typically expects dates in YYYY-MM-DD or DD/MM/YYYY format. Common issues:

American date format (MM/DD/YYYY) instead of South African format
Future dates where past dates are expected
Birth dates that don't match ID number
Admission dates before birth dates

Marks and Assessment Errors

Error: "Mark Out of Range" or "Subject Not Registered"

Marks couldn't be saved because they're outside valid ranges or the learner isn't enrolled for that subject.

Solution

Verify marks are within 0-100 (or the scale defined for that subject)
Ensure all learners are registered for their subjects before entering marks
Check that the assessment period is open for data entry
Confirm the subject codes match what's expected in SASAMS

File Upload Errors

Error: "Invalid File Format" or "File Processing Failed"

The uploaded file couldn't be processed—wrong format, encoding issues, or file corruption.

Solution

Use the exact file format required (usually .csv or .xml)
Save CSV files with UTF-8 encoding
Don't use special characters in file names
Keep file sizes under the upload limit
Check that column headers match expected values exactly

System and Connectivity Errors

Error: "Connection Timeout" or "Server Unavailable"

SASAMS server couldn't be reached or took too long to respond.

Solution

Wait and retry—SASAMS often experiences high load during submission periods
Try during off-peak hours (early morning or late evening)
Check your internet connection stability
Contact your district office if issues persist—there may be scheduled maintenance

Preventing SASAMS Errors

The best way to handle SASAMS errors is to prevent them before submission. Here's how:

1. Validate Data Continuously

Don't wait until submission time to check your data. Maintain clean records year-round by validating new entries immediately.

2. Use ID Validation Tools

Implement ID number validation when capturing learner data. This catches typos before they become SASAMS errors.

3. Run Pre-Submission Checks

Before any SASAMS submission, run a full validation pass on your data. Check for:

Invalid or missing ID numbers
Required fields that are empty
Date format issues
Duplicate entries
Data type mismatches

4. Use SASAMS-Compatible Software

School management software that understands SASAMS requirements can validate data automatically and export in the correct format.

MyEncore's Built-In Validation

MyEncore validates learner data against SASAMS requirements. When you export for SASAMS, the system checks ID numbers, required fields, date formats, and business rules—catching errors before they reach SASAMS. Schools using MyEncore report near-zero SASAMS rejection rates.

Error Resolution Workflow

When you encounter a SASAMS error, follow this systematic approach:

Read the error message carefully—it usually identifies the problematic record or field
Locate the affected record in your source data
Cross-reference with official documents—ID cards, birth certificates, transfer letters
Make the correction in your source system
Regenerate the export file with the corrected data
Retry the submission

Getting Help with SASAMS Errors

If you can't resolve an error:

District office: Your first point of contact for SASAMS support
Provincial help desk: For escalated technical issues
SASAMS user forums: Other administrators may have encountered the same issue
MyEncore support: If you're a MyEncore user, our team can help troubleshoot data issues

Eliminate SASAMS Errors with MyEncore

MyEncore validates your data before export, catching errors before they cause SASAMS rejections. school software with true SASAMS integration.

Google Play App Store AppGallery

Web app: app.myencore.co.za

Tired of SASAMS Errors?

Book a demo to see how MyEncore's built-in validation prevents submission failures.

Book a Demo

SASAMS Errors and How to Fix Them

Understanding SASAMS Error Types

Validation Errors

Duplicate Errors

File Errors

System Errors

ID Number Validation Errors

Error: "Invalid ID Number" or "ID Check Digit Failed"

Solution

Common ID Errors

Duplicate Record Errors

Error: "Duplicate Record Found" or "Learner Already Exists"

Solution

Missing Required Fields

Error: "Required Field Missing" or "Null Value Not Allowed"

Solution

Date Format Errors

Error: "Invalid Date Format" or "Date Out of Range"

Solution

Marks and Assessment Errors

Error: "Mark Out of Range" or "Subject Not Registered"

Solution

File Upload Errors

Error: "Invalid File Format" or "File Processing Failed"

Solution

System and Connectivity Errors

Error: "Connection Timeout" or "Server Unavailable"

Solution

Preventing SASAMS Errors

1. Validate Data Continuously

2. Use ID Validation Tools

3. Run Pre-Submission Checks

4. Use SASAMS-Compatible Software

MyEncore's Built-In Validation

Error Resolution Workflow

Getting Help with SASAMS Errors

Eliminate SASAMS Errors with MyEncore

Tired of SASAMS Errors?

Related Articles