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.

An import applied the wrong data​

Possible causes:

  • The source system sent a partial or out of date extract.
  • An import was applied before the review step had been checked properly.

Solutions:

  1. Open the Timetables page and find the import you want to undo.
  2. Choose the rollback action. Junipa restores the records that import changed to the state captured in its backup, taken before the import wrote anything.
  3. Correct the data at the source, then run the import again and read the review step before applying.

See Compass integration overview for what the backup covers.

Records listed as detached after an import​

Possible causes:

  • A class or student no longer appears in the extract from the source system.
  • An identifier changed at the source, so the record in Junipa no longer matches anything.

Solutions:

  1. Open the remediation view under Integration to see the detached records.
  2. For each record, choose Restore to put it back as it was, Relink to point it at the correct record in the source system, or Dismiss when the detachment is expected.
  3. Clear the list rather than leaving it. A detached record stays in Junipa but stops receiving updates from the source system.

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.