Skip to main content

Compass Troubleshooting

This page covers common issues with the Compass integration and how to resolve them.

Connection Issues​

"Connection failed" when testing credentials​

Possible causes:

  • The API key or secret is incorrect.
  • The School ID does not match your Compass instance.
  • Compass API access has not been enabled.

Solutions:

  1. Double-check the credentials entered in Junipa against those in your Compass API settings.
  2. Verify that API access is enabled in Compass.
  3. Ensure there are no extra spaces before or after the credentials when copying and pasting.
  4. If credentials were recently regenerated in Compass, update them in Junipa as well.

"Timeout" during connection test​

Possible causes:

  • Network issues between Junipa and your Compass instance.
  • Your Compass instance is temporarily unavailable.

Solutions:

  1. Try the connection test again after a few minutes.
  2. Check that your Compass instance is accessible in a browser.
  3. If your school uses a firewall or proxy, ensure outbound connections to the Compass API are allowed.

Sync Issues​

Students not appearing after sync​

Possible causes:

  • The initial sync has not completed yet.
  • The students are not marked as active in Compass.
  • A filter is applied in Junipa that is hiding the imported students.

Solutions:

  1. Check the sync status in Administration > Integrations > Compass. If a sync is in progress, wait for it to complete.
  2. Verify in Compass that the students are marked as currently enrolled and active.
  3. Clear any filters on the Junipa Students page and check again.

Student data is outdated​

Possible causes:

  • The scheduled sync has not run since the data was updated in Compass.
  • A sync error prevented the latest data from being pulled.

Solutions:

  1. Trigger a manual sync by clicking Sync Now in Administration > Integrations > Compass.
  2. Check the sync log for any errors. If errors are present, review them and address the underlying cause.

Duplicate students​

Possible causes:

  • The same student exists in Compass with different identifiers (e.g., was re-enrolled with a new ID).
  • Students were added manually in Junipa before the Compass sync.

Solutions:

  1. Identify the duplicate records in Junipa.
  2. Merge or remove the duplicate, keeping the record linked to Compass.
  3. Going forward, avoid manually adding students who are already in Compass.

Data Discrepancies​

Year levels do not match​

Possible cause: Year level naming in Compass differs from what Junipa expects (e.g., "Yr 7" vs "Year 7").

Solution: Check your Junipa year level configuration in Administration > School Settings and ensure it aligns with the values in Compass. Contact Junipa support if mapping adjustments are needed.

Class assignments are incorrect​

Possible cause: Timetable data in Compass has not been updated, or the sync does not include the latest timetable changes.

Solution: Verify the timetable in Compass is current, then trigger a manual sync in Junipa.

Getting Further Help​

If the above solutions do not resolve your issue:

  1. Check the sync log in Administration > Integrations > Compass for specific error messages.
  2. Note down any error codes or messages.
  3. Contact Junipa support with the error details and a description of the issue.