# Abonnementverwaltung

Der Abschnitt Abonnementverwaltung ermöglicht es Gebäudeeigentümern und Kontovertretern, den Abonnementplan für ein Gebäude einzusehen, zu verwalten und zu ändern. Er bietet vollständige Transparenz über Abrechnungszyklen, aktuelle Nutzung im Vergleich zu Planlimits, Rechnungshistorie und Planwechseloptionen — einschließlich Add-ons, wenn Nutzungslimits erreicht werden.

***

## Überblick

Jedes Gebäude auf Magma wird durch sein eigenes Abonnement geregelt. Es gibt 3 Abonnementpläne:

| Plan          | Beschreibung                                                                                                                           |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Essential** | Der Einsteiger-Plan mit moderaten Limits für Beteiligte, Speicher, API-Vorgänge und E-Mail-Benachrichtigungen. Kein Prioritätssupport. |
| **Premium**   | Ein höherwertiger Plan mit erweiterten Limits und inklusive Prioritätssupport.                                                         |
| **Infinity**  | Der Top-Plan mit maximalen oder unbegrenzten Limits über alle Dimensionen und Prioritätssupport.                                       |

***

## Zugang zur Abonnementverwaltung

Die Abonnementverwaltung ist zugänglich über:

* Die **Gebäudeeinstellungen** → Registerkarte Abonnement.
* Das Schnellaktionsmenü (⋯) auf der Gebäudekarte im Dashboard → Abonnement anzeigen.

Nur **Eigentümer** und **Kontoverwalter** können auf die Abonnementverwaltung zugreifen.

***

## Abonnementdetails-Modal

Das Abonnementdetails-Modal ist in 3 Registerkarten gegliedert:

***

### Registerkarte 1: Details

Die Details-Registerkarte bietet einen vollständigen Überblick über den aktuellen Abonnementstatus und die Nutzung.

#### Plan & Status

| Feld                   | Beschreibung                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| **Plan**               | Der aktuelle Planname (Essential, Premium oder Infinity).                                  |
| **Status**             | Der aktuelle Zustand des Abonnements (siehe Statuswerte unten).                            |
| **Abrechnungsperiode** | Die Abrechnungshäufigkeit: monatlich oder jährlich.                                        |
| **Plan ändern**        | Eine Schaltfläche zum Einleiten einer Planänderung (öffnet die Registerkarte Plan ändern). |

**Abonnementstatusarten**

| Status       | Beschreibung                                                                                                                         |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Active**   | Das Abonnement ist aktuell und alle Funktionen sind vollständig zugänglich.                                                          |
| **Canceled** | Das Abonnement wurde gekündigt. Es bleibt bis zum Ende der aktuellen Abrechnungsperiode aktiv, danach wird der Zugang eingeschränkt. |
| **Paused**   | Das Abonnement wurde vorübergehend pausiert (z. B. auf Wunsch des Abonnenten).                                                       |
| **Expired**  | Die Abrechnungsperiode des Abonnements ist ohne Verlängerung abgelaufen.                                                             |

#### Aktuelle Periode

Informationen über den aktiven Abrechnungszyklus:

| Feld                  | Beschreibung                                                            |
| --------------------- | ----------------------------------------------------------------------- |
| **Zyklus-Nummer**     | Die laufende Nummer des aktuellen Abrechnungszyklus (z. B. „Zyklus 7"). |
| **Periodenbeginn**    | Das Startdatum der aktuellen Abrechnungsperiode.                        |
| **Periodenende**      | Das Enddatum der aktuellen Abrechnungsperiode.                          |
| **Verbleibende Tage** | Die Anzahl der in der aktuellen Abrechnungsperiode verbleibenden Tage.  |

#### Lizenzperiode

Die Gesamtlizenzperiode für das Abonnement (Start- und Enddaten), die sich vom einzelnen Abrechnungszyklus unterscheiden kann, wenn eine Mehrjahreslizenz erworben wurde.

#### Limits

Eine Aufschlüsselung der Nutzungslimits des aktuellen Plans im Vergleich zur tatsächlichen aktuellen Nutzung:

| Limit                         | Beschreibung                                                    |
| ----------------------------- | --------------------------------------------------------------- |
| **Beteiligte**                | Aktuelle Anzahl der Beteiligten vs. Plan-Maximum.               |
| **API-Vorgänge**              | Aktuelle Anzahl der API-Vorgänge vs. Plan-Kontingent.           |
| **E-Mail-Benachrichtigungen** | Aktuelle Anzahl vs. Plan-Kontingent.                            |
| **Speicher (GB)**             | Aktuelle Speichernutzung vs. Plan-Speicherlimit.                |
| **Prioritätssupport**         | Ob Prioritätssupport im aktuellen Plan enthalten ist (Ja/Nein). |

Fortschrittsbalken oder Prozentanzeigen zeigen, wie nah jede Dimension an ihrem Limit ist.

#### Zusätzliche Informationen

| Element                                   | Beschreibung                                                                                    |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **Warnung bei Kündigung am Periodenende** | Wenn das Abonnement auf Kündigung am Periodenende gesetzt wurde, wird ein Warnbanner angezeigt. |
| **Datum der Kündigung**                   | Wenn das Abonnement gekündigt wurde, wird das Datum der Kündigung angezeigt.                    |

***

### Registerkarte 2: Rechnungen

Eine vollständige Liste aller bisherigen Rechnungen für das Abonnement dieses Gebäudes.

Jede Rechnungszeile enthält:

| Spalte              | Beschreibung                                                             |
| ------------------- | ------------------------------------------------------------------------ |
| **Rechnungsnummer** | Die eindeutige Rechnungsreferenznummer.                                  |
| **Datum**           | Das Datum, an dem die Rechnung erstellt wurde.                           |
| **Bezahlt-Tag**     | Ein grünes „Bezahlt"-Badge, wenn die Rechnung erfolgreich bezahlt wurde. |
| **Betrag**          | Der berechnete Gesamtbetrag.                                             |
| **Download**        | Eine Schaltfläche zum Herunterladen der Rechnung als PDF.                |

Rechnungen sind in umgekehrter chronologischer Reihenfolge aufgeführt (neueste zuerst).

***

### Registerkarte 3: Plan ändern

Die Registerkarte Plan ändern ermöglicht es Ihnen, den Abonnementplan zu upgraden oder zu downgraden.

#### Planauswahltabelle

Eine Vergleichstabelle mit allen verfügbaren Plänen (Essential, Premium, Infinity) mit ihren Funktionen und Preisen. Der aktuelle Plan ist hervorgehoben.

#### Anteilige Vorschau

Wenn Sie einen neuen Plan auswählen, wird vor der Bestätigung eine **anteilige Vorschau** angezeigt. Diese zeigt genau, was berechnet wird:

| Zeile                           | Beschreibung                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Gutschrift für alten Plan**   | Das anteilige Guthaben für die verbleibenden ungenutzten Tage des aktuellen Plans.               |
| **Neue Plangebühr**             | Die anteilige Gebühr für den neuen Plan von heute bis zum Ende des aktuellen Abrechnungszyklus.  |
| **Heute fälliger Nettobetrag**  | Die Differenz zwischen der neuen Gebühr und dem alten Guthaben (kann positiv oder negativ sein). |
| **Neuer wiederkehrender Preis** | Der volle Preis, der ab dem nächsten Abrechnungszyklus berechnet wird.                           |

#### Verstöße-Warnung

Wenn die Limits des neuen Plans in einer Dimension unter Ihrer aktuellen Nutzung liegen, wird vor der Bestätigung eine **Verstöße-Warnung** angezeigt. Zum Beispiel:

> „Ihre aktuelle Anzahl an Beteiligten (12) überschreitet das Essential-Plan-Limit (8). Eine Änderung auf diesen Plan schränkt die Möglichkeit ein, neue Beteiligte hinzuzufügen, bis die Anzahl unter 8 fällt."

Diese Warnung verhindert versehentliche Downgrades, die den Gebäudebetrieb sofort einschränken würden.

#### Bestätigungs-Checkbox

Eine Pflicht-Bestätigungs-Checkbox muss vor der Einreichung der Planänderung aktiviert werden. Der Checkbox-Text fasst die vorgenommene Änderung und den fälligen Nettobetrag zusammen.

***

## Modal für erreichte Limits

Wenn ein Planlimit erreicht wird (Beteiligte, Speicher, API-Vorgänge oder E-Mail-Benachrichtigungen), führt ein **Modal für erreichte Limits** Sie durch das Hinzufügen von Kapazität, ohne ein vollständiges Plan-Upgrade zu erfordern. Das Modal folgt einem 4-Schritte-Ablauf:

### Schritt 1: Erreichte Limits anzeigen

Eine klare Zusammenfassung, welche Limits erreicht wurden und um wie viel. Zum Beispiel:

> „Sie haben Ihr Beteiligten-Limit erreicht (8/8 verwendet)."

### Schritt 2: Add-on-Typ auswählen

Wählen Sie, welche Art von Kapazität hinzugefügt werden soll:

| Add-on-Typ                    | Beschreibung                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------- |
| **Beteiligte**                | Kapazität für weitere Beteiligte-Konten hinzufügen.                                                 |
| **Speicher GB**               | Zusätzliche Dokumentenspeicherkapazität hinzufügen.                                                 |
| **E-Mail-Benachrichtigungen** | Zusätzliches E-Mail-Benachrichtigungskontingent hinzufügen.                                         |
| **API-Vorgänge**              | Zusätzliches API-Vorgangskontingent hinzufügen.                                                     |
| **Pay-as-you-go**             | Für verbrauchsbasierte Abrechnung — zahlen Sie nur für das, was Sie über dem Planlimit verbrauchen. |

### Schritt 3: Bundle auswählen

Wählen Sie aus verfügbaren Bundle-Größen für den ausgewählten Add-on-Typ. Bundles werden in vordefinierten Mengen angeboten (z. B. +10 Beteiligte, +50 GB Speicher). Die Preise werden pro Bundle angezeigt.

### Schritt 4: Vorschau vor Bestätigung

Ein abschließender Übersichtsbildschirm, der Folgendes zeigt:

| Element             | Beschreibung                                                               |
| ------------------- | -------------------------------------------------------------------------- |
| **Vorher**          | Aktuelle Limits und Nutzung.                                               |
| **Nachher**         | Neue Limits nach Anwendung des Add-ons.                                    |
| **Preisgestaltung** | Die zusätzlichen Kosten pro Abrechnungsperiode für das ausgewählte Bundle. |

Eine **Bestätigen**-Schaltfläche schließt den Add-on-Kauf ab. Die Zahlung wird sofort mit der hinterlegten Karte verarbeitet.

***

## Tipps zur Abonnementverwaltung

* **Überwachen Sie Ihre Limits** in der Details-Registerkarte regelmäßig — das Annähern an ein Limit bei Speicher oder Beteiligten ist ein Signal, entweder ein Upgrade durchzuführen oder ein Bundle hinzuzufügen, bevor der Betrieb beeinträchtigt wird.
* **Laden Sie Rechnungen** umgehend für Buchhaltungs- und Steuerzwecke herunter — PDFs sind in der Rechnungsregisterkarte unabhängig vom Erstellungszeitpunkt immer verfügbar.
* **Überprüfen Sie die anteilige Vorschau** sorgfältig vor dem Planwechsel — wenn Sie sich in der Mitte eines Zyklus befinden, kann der fällige Nettobetrag je nach Zeitpunkt höher oder niedriger als erwartet sein.
* **Verwenden Sie Add-ons** für gezielte Kapazitätserweiterung — wenn Sie nur etwas mehr Speicher benötigen, kann ein Speicher-Add-on kostengünstiger sein als ein Upgrade des gesamten Plans.
* **Jährliche Abrechnung** bietet typischerweise einen erheblichen Rabatt gegenüber der monatlichen Abrechnung — wenn das Gebäude eine langfristige Verpflichtung ist, kann ein Wechsel zur jährlichen Abrechnung in der Registerkarte Plan ändern die Kosten senken.


---

# Agent Instructions: 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:

```
GET https://docs.mymagma.com/magma-documentation/de/funktionen/subscription-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
