> For the complete documentation index, see [llms.txt](https://docs.mnspro.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mnspro.cloud/administration-my.mnspro.cloud/mnspro-cloud/klassenbuch-and-stundenplan/einrichtung/untis-synchronisierte-einrichtung.md).

# Untis Synchronisierte Einrichtung

Für die Synchronisation wird folgende Software benötigt:

Untis Provider Installer:[<img src="/files/p6jrQfb9zKjrq1Sqmboq" alt="" data-size="line">](https://mnsprocloud.blob.core.windows.net/download/UntisProvider.msi)[Download](https://mnsprocloud.blob.core.windows.net/download/UntisProvider.msi)&#x20;

**Aktuelle Version:** 1.20.0

**Letztes Update**: 05.03.2026

{% hint style="info" %}
Für die Nutzung des Untis Provider und Installation benötigen Sie mindestens DotNet9 Version und administrative Rechte auf Ihrem Rechner.

Diese finden Sie hier: [<img src="/files/p6jrQfb9zKjrq1Sqmboq" alt="" data-size="line">Download](https://builds.dotnet.microsoft.com/dotnet/Runtime/10.0.8/dotnet-runtime-10.0.8-win-x64.exe)
{% endhint %}

***

{% stepper %}
{% step %}

### Zeitraum definieren

{% endstep %}

{% step %}

### Importvalidierung

### Einstellungen – Stundenplan – Importvalidierung: E-Mails

Um eine E-Mail-Adresse zu hinterlegen, an die Synchronisationsfehler gesendet werden sollen, ist es notwendig, in die Einstellungen vom Stundenplan zu wechseln.&#x20;

Dies sollte vor der ersten Synchronisation durchgeführt werden. Dies geschieht über die Kachel „Stundenplan“, nach Auswahl der Einstellungen in dem linken Navigationsbereich.

<figure><img src="/files/ozXFvx7FQllQTE8fEK7T" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GkQsyyRPDGAhkiPI02Dg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sppyOpDs3FSwanEKCXdq" alt=""><figcaption></figcaption></figure>

Hier ist zunächst der erste Punkt relevant, um E-Mail-Adressen für die Synchronisationsfehler zu definieren. Auf die anderen beiden Punkte in diesen Importvalidierungseinstellungen des Stundenplans („Unterrichtsstunden“ und „Lehrer/in“) kommen wir zu einem späteren Zeitpunkt zurück.
{% endstep %}

{% step %}

### Untis-Datei anpassen

Neben den Vorbereitungen in der MNSpro Cloud Umgebung gibt es auch noch Anpassungen, die im Vorfeld in Untis durchgeführt werden.

### Untis – Lehrer – Stammdaten

<figure><img src="/files/d0pBwrwv2YBPC7ti6rQV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/qECSkyRy9awS0TIxtMDV" alt=""><figcaption></figcaption></figure>

Die Spalte „E-Mail-Adresse“ muss gleich sein, wie die E-Mail-Adresse des entsprechenden MNSpro Cloud-Benutzers!

{% hint style="info" %}
Kursnamen in Untis sollten an die Namen in anderen Schulverwaltungsprogrammen angeglichen werden (sollte das nicht passieren, kann es zu einem Mehraufwand bei den Kurszuordnungen kommen, da dann manuell die Gruppennamen aus Untis mit den Gruppennamen der MNSpro Cloud-Gruppen, die meist aus einem Export aus anderen Schulverwaltungsprogrammen stammen).
{% endhint %}

### Untis – Lehrer – Zeitraster

Beim Zeitraster müssen die Stundenbezeichnungen eingetragen werden.

<figure><img src="/files/hLbx1l3LImEFmHdtH04o" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Generierung eines API-Schlüssels in der MNSpro Cloud Oberfläche

### Einstellungen – Allgemein – API-Schlüssel generieren

Um einen neuen API-Schlüssel für die Stundenplan-Synchronisierung zwischen UNTIS und dem MNSpro Klassenbuch zu generieren, müssen die folgenden Menüpunkte im MNSpro Cloud Dashboard angesteuert werden (die entsprechenden Menüpunkte sind <mark style="color:red;">**rot**</mark> umrandet):

<figure><img src="/files/IP8A0i8av82Eg2lqVfV4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JJVh2ElBMVDvOFDVfV0i" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wEsxZ5KUEJsghyU4NFDW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GoXLcswjye70Puh78tTN" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Die Bezeichnung dieses neuen API-Schlüssels kann frei gewählt werden. Es sollte vom Namen her jedoch am besten ersichtlich sein, welche Funktion er übernimmt -> daher empfehlen wir die Namen ***„Untis Synchronisation***“ oder „***Stundenplan Untis Synchronisation***“.
{% endhint %}

Als Funktion muss die Option ***TimeTable*** ausgewählt werden und als Zeitraum empfiehlt sich das Schuljahresende einzutragen, in dem mithilfe dieses API-Schlüssels eine Synchronisation durchgeführt werden soll.

{% hint style="warning" %}
**WICHTIG**: Aus sicherheitsrelevanten Aspekten empfiehlt es sich, diesen API-Schlüssel regelmäßig durch einen neuen zu ersetzen!
{% endhint %}

In dem darauffolgenden Fenster, nach dem Klick auf den roten „Erstellen“-Button, finden Sie den generierten API-Schlüssel.&#x20;

<figure><img src="/files/Ak014uUNUv34e8POD7jA" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**WICHTIG**: Dieser Schlüssel wird lediglich an dieser Stelle vollständig angezeigt und kann auch nur unmittelbar nach der Generierung vollständig eingesehen und kopiert werden! Wenn der Schlüssel nicht mehr bekannt ist, kann er lediglich gelöscht und ein neuer Key generiert werden.
{% endhint %}

{% hint style="info" %}
Falls Sie die Option *Allgemein* unter Einstellungen nicht sehen, dann fehlt Ihnen noch das benötigte Recht. Als Admin können Sie sich dieses Recht unter **Einstellungen** --> **Berechtigungen** --> **Administrator** --> **Berechtigungen verwalten** und dort unter dem Punkt "Einstellungen" selbst vergeben!
{% endhint %}
{% endstep %}

{% step %}

### Installation der Untis-Synchronisation

Sind die zuvor dokumentierten Voraussetzungen alle erfüllt, kann mit dem Download der UntisProvider.msi fortfahren und das Tool ausgeführt und anschließend den Einrichtungsanweisungen gefolgt werden.

<figure><img src="/files/FVeHjwoBHZ84nM4YYZ7I" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Sollte der Hinweis auftauchen, dass aktuell keine .Net Core Version installiert ist, muss diese vor der Ausführung der Installation noch nachinstalliert werden und anschließend das Tool neu gestartet werden!

![](/files/kY5ngnwTHE4Yh8DTaeq0)<br>

​​Eine Installationsdatei von .Net Core 10.0 können Sie hier downloaden: [<img src="/files/p6jrQfb9zKjrq1Sqmboq" alt="" data-size="line">Download](https://builds.dotnet.microsoft.com/dotnet/Runtime/10.0.8/dotnet-runtime-10.0.8-win-x64.exe)
{% endhint %}

Im ersten Schritt werden grundlegende Parameter abgefragt:

<figure><img src="/files/10OXjb9i3mEmSg2UR90L" alt="" width="464"><figcaption></figcaption></figure>

**API Schlüssel:** Unter ***ApiKey*** ist der im vierten Schritt erstellte Schlüssel einzutragen.

**Minimum Pausenzeit (in Minuten):** Ist ein Schwellwert ab wann Pausen im Stundenplan als solche angezeigt werden, in diesem Beispiel werden Pausen bis zu 5 Minuten zwischen zwei Unterrichtsstunden ignoriert.

**Untis Programm Speicherort:** Verlangt das Installationsverzeichnis von Untis. Dieser ist voraussichtlich nach jedem Jahr, wenn eine neue Version verwendet wird, anzupassen.

**Zeit Raster:** Vergeben Sie einen Namen, sofern es mehrere gibt.

Je nach Verbindungsart werden in folgenden Schritt verschiedene erforderliche Angaben benötigt:

{% tabs %}
{% tab title="Datenbankdatei" %}

<figure><img src="/files/kHz1jtzIAt8WGoXTN4hn" alt=""><figcaption><p>Beispiel: Dialog Datendatei</p></figcaption></figure>

**Untis Datendatei:** Geben Sie hier den Pfad zur Untis Datendatei an.
{% endtab %}

{% tab title="MySQL Verbindung" %}

<figure><img src="/files/WgYBxzCP9cckHyrWKpIm" alt=""><figcaption></figcaption></figure>

**Datenbank Benutzer:** Benutzername, mit welchem die Verbindung zur MySQL Datenbank hergestellt wird

**Datenbank Passwort:** Passwort, mit welchem die Verbindung zur MySQL Datenbank hergestellt wird

**Schulnummer:** Ist der Name, der bei Anlage der Datenbank gewählt wurde.&#x20;

**Schuljahr :** Hier kann ausgewählt werden, welches Schuljahr aus der Datenbank importiert werden soll

**Datenbank Version (MySQL):** Die Datenbank - Sicherungsversion, die importiert werden soll.
{% endtab %}
{% endtabs %}

Durch Klick auf *Weiter* gelangen Sie zu einem Dialog, wo der Speicherort des ***Untis TimeTableProviders*** ausgewählt werden kann.

{% hint style="info" %}
Wählen Sie hier einen Netzwerkpfad aus, falls das Tool von mehreren verwendet werden soll!&#x20;
{% endhint %}

<figure><img src="/files/T2U5YHWVuVeRw0wwpdYp" alt=""><figcaption></figcaption></figure>

Im nächsten und letzten Fenster wird durch Klick auf Installieren die Installation abgeschlossen und das Tool bereitgestellt. Es wird entsprechend eine Verknüpfung auf dem Desktop hinterlegt.&#x20;

<figure><img src="/files/9q4AfO4k5nOKCcSzRKVd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yFrbcbxxtOVfu1Zfudz0" alt=""><figcaption></figcaption></figure>

Was macht eine Synchronisation: Die Synchronisation legt die Stufen aus Untis als Stufen im MNSpro Klassenbuch an.\
-> es werden die Kurse erstellt und die Kurslehrer hinterlegt,\
-> die Klassenstrukturen werden gebildet: innerhalb der Klassen werden die Kurse zugewiesen, \
-> für die Lehrer:innen wird eine Übersicht über Ihre Unterrichtsstunden generiert,\
-> das Stundenplanraster wird angelegt,\
-> in Untis hinterlegte Ferien- und Feiertage werden eingetragen\
Bei Problemen mit der Synchronisation wird eine E-Mail an die zuvor festgelegte E-Mail-Adresse versendet, in der die Fehlerdetails dokumentiert sind!
{% endstep %}

{% step %}

### Kurszuordnung

Da nicht immer die Kurse dieselben Bezeichnungen tragen wie in der Schulverwaltungssoftware, bietet MNSpro Cloud eine Kreuztabelle an, mit der man ein Mapping der Namen aus beiden Systemen herstellen kann.

Mittels einfacher Dropdown-Liste können die Fächer bzw. Kurse zugeordnet werden. Somit kann eine Datenkonsolidierung auch Schritt für Schritt erfolgen und muss nicht zwingend sofort zur Einführung vorhanden sein (Abb. 1).

Ein solches Mapping ist beispielsweise dann relevant, wenn Sie Daten aus Untis mit Ihren Klassenbezeichnungen synchronisieren möchten.

<figure><img src="/files/Bx9MCmuCMzsKft4pVWUu" alt=""><figcaption></figcaption></figure>

## Kurszuordnung mittels CSV-Datei

Wenn Sie auf **Export** klicken, wird eine CSV-Datei erstellt. Diese Datei können Sie mit einem Tabellenbearbeitungsprogramm wie z. B. Excel öffnen, um die Zuordnungen einfacher vorzunehmen.&#x20;

Anschließend speichern Sie die bearbeitete Datei wieder als CSV im UTF-8-Format und **importieren** sie. So können Sie eine große Anzahl an Kurszuordnungen mit relativ geringem Aufwand durchführen.

<figure><img src="/files/uJrviwD5tF16CuX08VwN" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mnspro.cloud/administration-my.mnspro.cloud/mnspro-cloud/klassenbuch-and-stundenplan/einrichtung/untis-synchronisierte-einrichtung.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.