Common PowerSchool Writeback Errors
Learn about the most common errors from PowerSchool for attempted Writebacks and what they mean.
- Emergency Management Suite
- Preparation & Response Training
- PBIS Rewards
-
Compass
Getting Started Webinar Links Data & User Management Compass Curriculum for Students, Staff, & Families Compass Behavior Intervention Compass Mental Health + Prevention Compass for Florida - Character Ed, Resiliency, & Prevention Compass for Texas - Character Ed Analytics & Reporting Release Notes & Updates Additional Resources
- Behavioral Case Manager
- Visitor Management
- School Check In
- ALICE Training Institute
- Detect
- Anonymous Tip Reporting
- Resources
Note: PowerSchool Writeback functionality and the Navigate360 Attendance Access Plugin requires a paid subscription. To learn more about this functionality and/or receive your Attendance Access Plugin download, please reach out to your Navigate360 Account Manager.
Visitor Management's PowerSchool Setup page allows Admin users to quickly monitor the status of individual writeback events via the Writeback Logs tab, and view related error messages for any failed writeback attempts. For assistance troubleshooting these errors, please see below for a list of common error messages, what they mean, and how to resolve them.
Plain-text Error Messages:
Certain error messages returned by PowerSchool are delivered in a plain-text format, making them easier to read. However, they can still be difficult to troubleshoot without context. See below for examples of the common plain-text errors received from PowerSchool.
Could not find student's period.
Meaning:
Visitor Management is trying to write back an attendance record for a time that PowerSchool doesn't recognize as a scheduled period for the student.
When the PowerSchool Writeback functionality is enabled, Visitor Management will immediately attempt to post an Attendance Record to the connected PowerSchool instance for the exact time that the student was checked in late or out early.
Possible Causes:
- The student was checked in or out at a time that they do not have an active class or period in PowerSchool.
- The SIS sync may be sending incorrect student IDs to Visitor Management, causing the system to attempt a writeback for the wrong student.
How to Resolve:
- Confirm that the student had an active class/period during the time of the check-in/out.
- Verify that the correct student IDs are being shared between your SIS and Visitor Management. Click here for more information.
Could not find student's PowerSchool id.
Meaning:
PowerSchool could not locate a valid ID when attempting to convert the student's DCID.
By default, the PowerSchool Writeback functionality expects that student DCIDs are being shared with Visitor Management. When attempting to perform a Writeback, the DCID is sent to PowerSchool to be converted into the student's unique ID. Which is then used to create the new Attendance Record.
Possible Cause:
- The SIS sync may be sending incorrect student IDs to Visitor Management, causing the system to attempt a writeback for the wrong student.
How to Resolve:
- Verify that the correct student IDs are being shared between your SIS and Visitor Management. Click here for more information.
Technical Error Messages:
Certain error messages returned by PowerSchool are delivered in a more technical, raw format. The most important information for troubleshooting these errors are the Error Code, Error Message, and Error Details (if included). See below for an example of this error format and some of the common technical errors received from PowerSchool.
- Client error: `POST https://example.powerschool.com/exampleURL` resulted in a `example error code` response: {"message":"example error message","errors":[{example error details (truncated...)
Message: "Record Not Saved. : [Number] doesn't match the term's year value: [Number]."
Meaning:
Visitor Management is attempting to post an Attendance Record to PowerSchool using an outdated Attendance Code.
In PowerSchool, every Attendance Code is assigned a “year ID” that links it to a specific school year/term. This ID ensures that attendance records are properly categorized and reported within the relevant academic year.
Cause:
- Visitor Management has not been updated with the latest Attendance Codes for the current school year.
How to Resolve:
- Go to Admin → Student Tracking in Visitor Management and import the latest Attendance Codes from PowerSchool. Click here for more information.
Message: "Record Not Saved. : The student [Student Name] isn't enrolled on [Date]."
Meaning:
Visitor Management is attempting to post an Attendance Record for a student who is not enrolled in PowerSchool on the date of check-in or check-out.
Possible Causes:
- The SIS sync may be sending incorrect student IDs to Visitor Management, causing the system to attempt a writeback for the wrong student.
- The student’s enrollment dates may not cover the check-in/out date.
How to Resolve:
- Verify that the correct student IDs are being shared between your SIS and Visitor Management. Click here for more information.
- Confirm the student’s enrollment status in PowerSchool for the relevant date.
Error: "You have ATT_Mode[Meeting/Daily/Time] set as the method to use..."
Meaning:
The Attendance Mode setting in Visitor Management does not match the Attendance Mode configured in PowerSchool for this school.
Cause:
- A mismatch between the Attendance Mode in the two systems.
How to Resolve:
- Go to Admin → PowerSchool Setup in Visitor Management and update the Attendance Mode setting for the building to match the attendance settings configured in PowerSchool. Click here for more information.
Error Code: `401 Unauthorized` response
Meaning:
Visitor Management’s connection to PowerSchool has been denied.
Possible Causes:
- The Navigate360 Attendance Access Plugin may not be enabled/configured properly in PowerSchool.
- The PowerSchool URL, Client ID, or Client Secret may be saved incorrectly in Visitor Management.
How to Resolve:
- Ensure the Navigate360 Attendance Access Plugin is installed and enabled in PowerSchool.
- If using PowerSchool SIS version 25.2.0.0 or later, ensure that Full Access is selected under the Data Provider Configuration settings of the plugin.
- Go to Admin → PowerSchool Setup in Visitor Management and verify that the correct PowerSchool URL, Client ID, and Client Secret are saved. Click here for more information.
If you continue to receive errors after making any corrections or need help troubleshooting an error that isn't listed above, please contact Navigate360 Support for further assistance.