Learn how to resolve common sync errors.
What's included in this article?
Imports
If you see an error that says "Organization does not accept Imports at this time" this is most likely due to your imports being disabled for the school year. If this setting is not enabled, you will see the following error:
To resolve, confirm in the following location of Enroll:
Settings > General
You have enabled the "Enable Sync Import for Year X" setting.
Exports
Boolean
If you encounter an error message that includes the word "boolean", it means your SIS is expecting a specific type of value for that field—typically one of the following:
-
1or0 -
TrueorFalse -
TRUEorFALSE -
trueorfalse
To resolve, check with your SIS provider to confirm the exact format required for the field triggering the error, then update your mapping to send the correct boolean value.
Regex Pattern
If you see an error that contains "regex" in the message, this means that your SIS is expecting the number format of your value to be different than how it is currently being sent.
In the example above, the error message is indicating that the phone number we are sending for the field contact.doctor_phone is not in the correct format:
-
Expected format:
9999999999→\d{10} -
Currently sending:
999-999-9999→\d{3}-\d{3}-\d{4}
To resolve this, update your mapping to match the expected format (in this case, a 10-digit number with no dashes).
Please note: the error message may not always display the expected regex pattern. If it's unclear, contact your SIS provider to confirm the correct format for the field causing the error, and then adjust your mapping accordingly.
PowerSchool Specific
School Terms
To export data from Enroll and send it to PowerSchool via API, each school receiving data must have the Years & Terms set in PowerSchool (e.g. semester, quarter, etc.) for the sync to complete. If you see an error that says "Request failed with a status code 404 - Missing configuration in powerschool for X year" this is due to your terms not being set in PowerSchool.
To resolve, you will set this up by going to the following page in your PowerSchool instance:
Start Page > School Setup > Years and Terms > Term Setup
Under Portions, set “1/2” for semester, “1/3" for trimesters, and “1/4” for quarters.
Doctor Name & Doctor Phone
PowerSchool requires that both Doctor Name and Doctor Phone be provided—if you send one, you must send the other. To resolve this, either make both fields required on your form, or update your mapping to send a default value when one is missing.
Additionally, Doctor Name must be no longer than 60 characters.
To avoid errors, ensure your Enroll form enforces this character limit.
District of Residence & Entry Code
PowerSchool requires that both District of Residence and Entry Code be sent together—if one is provided, the other must be as well.
To resolve, ensure that both fields are mapped and that no student records are missing one of the two values.
Additionally, the Entry Code is sent to PowerSchool under:
Student > School Enrollment > Enrollment History
Important: Once this information is synced, Entry Code cannot be changed due to a PowerSchool limitation—it can only be inserted, not updated. Please double-check the values before syncing to avoid needing manual corrections later.
Partial Sync
A Partial Sync export status indicates that the student record was successfully exported to PowerSchool, but at least one associated contact failed to sync.
PowerSchool requires the following fields in order to successfully sync a contact:
- Contact First Name
- Contact Last Name
- Relationship to Student
- Contact Email or Phone Number
If any of these fields are missing for a contact, that contact will fail to sync—resulting in a Partial Sync.
To resolve, update the student's registration form to include the missing information. You may also want to configure your form to require all of the above fields for each contact to prevent future sync issues.
Comments
0 comments
Article is closed for comments.