> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supportwise.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect SupportWise to LISS

> Configure a LISS endpoint, receive timetable data and manage sync runs.

LISS can send timetable structures, bell times, rooms, students, teachers, classes, class memberships and timetable slots to SupportWise.

<Warning>
  LISS configuration contains connection credentials. Copy them only into the authorised timetable product and never place them in email screenshots, shared documents or support messages.
</Warning>

## Create the connection

<Steps>
  <Step title="Open Integrations">
    Go to **Settings → Integrations**. Copy the displayed LISS endpoint URL.
  </Step>

  <Step title="Add a connection">
    Enter a recognisable connection name, the client identifier supplied to the timetable system and the applicable product label.
  </Step>

  <Step title="Configure the sending system">
    Enter the SupportWise endpoint and generated credentials in the LISS-compatible timetable product. Field names differ by product; follow that product's LISS instructions.
  </Step>

  <Step title="Send a complete sync">
    Publish the supported datasets from the timetable product. Keep the Integrations page open to monitor Sync History.
  </Step>

  <Step title="Finalise and process when needed">
    SupportWise can finalise complete runs automatically. The page also provides actions to finalise, process or retry eligible runs.
  </Step>

  <Step title="Review and import">
    A completed sync populates the LISS-backed directory and timetable data. Use the dedicated import actions for learners, support staff or periods where offered.
  </Step>
</Steps>

## Understand sync status

| Status     | Meaning                                 | Coordinator action                                           |
| ---------- | --------------------------------------- | ------------------------------------------------------------ |
| Receiving  | SupportWise is collecting LISS messages | Wait while the sender is active                              |
| Ready      | The run is complete enough to process   | Process it if automatic processing has not begun             |
| Processing | SupportWise is normalising the run      | Wait and refresh                                             |
| Done       | Processing completed                    | Review counts and imported/matched data                      |
| Failed     | Processing stopped with an error        | Read the error, correct the cause and retry when appropriate |

## Validate a completed sync

* Expected methods appear in the run.
* Counts are credible compared with the timetable product.
* Teachers have useful codes and email addresses.
* Students have stable external identifiers.
* Classes and memberships appear before relying on class-linked views.
* Bell times match the current cycle before importing periods.

<Info>
  LISS-supplied data and SupportWise-managed records serve different purposes. A completed sync does not automatically replace every manually managed learner, staff or period field.
</Info>

<Note>
  **Screenshot placeholder SW-014:** Integrations page with endpoint, one enabled connection and successful Sync History; all credentials redacted.
</Note>