# Zahlung & Zugriffsbeschränkungen Wenn eine Abonnementzahlung fehlschlägt, implementiert Magma einen gestaffelten Eskalationsprozess, der den Zugriff auf Gebäudefunktionen progressiv einschränkt, je länger der Rückstand andauert. Dieses Dokument erläutert jede Phase des Zahlungsausfall-Lebenszyklus, was in jeder Phase gesperrt wird und wie der vollständige Zugriff wiederhergestellt werden kann. *** ## Überblick Zahlungsausfälle werden durch 8 Eskalationsstufen behandelt, beginnend mit einer Warnung und gipfelnd in der vollständigen Gebäudearchivierung an Tag 60. In jeder Stufe: * Werden spezifische Funktionen gesperrt. * Werden E-Mail-Benachrichtigungen an den Gebäudeeigentümer, Kontoverwalter und alle Beteiligten gesendet. * Zeigt das Gebäude innerhalb der Anwendung ein Banner an, das die Einschränkung und die erforderliche Maßnahme erklärt. *** ## Eskalationsstufen ### Stufe 1: INVOICE\_FAILED **Auslöser:** Der erste Zahlungsversuch schlägt fehl (Tag 0). **Einschränkungen:** Keine — dies ist nur eine Warnstufe. Alle Funktionen bleiben vollständig zugänglich. **Erforderliche Maßnahme:** Aktualisieren Sie die Zahlungsmethode und wiederholen Sie die Zahlung über den Abonnementverwaltungsbereich. **Benachrichtigungen:** E-Mail an Eigentümer und Kontoverwalter wird gesendet, mit der Warnung, dass die Rechnung fehlgeschlagen ist und eine Zahlung erforderlich ist. *** ### Stufe 2: OVERDUE\_3\_DAYS **Auslöser:** Die Zahlung ist seit 3 Tagen überfällig. **Einschränkungen:** * **DTT-Minting ist gesperrt.** Sie können kein neues Minting einleiten oder einen bestehenden DTT aktualisieren, bis die Zahlung geregelt ist. **Noch zugängliche Funktionen:** Data Room, BIM 3D Viewer, Scan Viewer, Losteilung, Fluid Synoptic, Galerie, Rewards, Aufgaben, Aktivitätsfeed. **Benachrichtigungen:** E-Mail an Eigentümer, Kontoverwalter und alle Beteiligten. *** ### Stufe 3: OVERDUE\_7\_DAYS **Auslöser:** Die Zahlung ist seit 7 Tagen überfällig. **Einschränkungen:** * DTT-Minting bleibt gesperrt. * **Dokument-Uploads sind gesperrt.** Es können keine neuen Dokumente in den Data Room hochgeladen werden. * **Dokumentvalidierung ist gesperrt.** Validatoren können Dokumente nicht genehmigen oder ablehnen. **Noch zugängliche Funktionen:** Nur-Lese-Zugriff auf den Data Room (Anzeigen, Herunterladen), BIM 3D Viewer, Scan Viewer, Losteilung (Nur-Lesen), Fluid Synoptic (Nur-Lesen), Galerie (Anzeigen). **Benachrichtigungen:** E-Mail an Eigentümer, Kontoverwalter und alle Beteiligten. *** ### Stufe 4: OVERDUE\_14\_DAYS **Auslöser:** Die Zahlung ist seit 14 Tagen überfällig. **Einschränkungen:** * Alle Einschränkungen aus Stufe 3 bleiben in Kraft. * **BIM 3D Viewer-Zugang ist gesperrt.** Beteiligte können nicht mehr mit dem 3D-Modell interagieren. * **Scan Viewer-Zugang ist gesperrt.** Das Anzeigen von Punktwolken-Scans ist nicht mehr verfügbar. **Hinweis:** `canScanAccess` ist ein separates Berechtigungs-Flag. Dieses Flag wird in dieser Stufe explizit für alle Beteiligten auf false gesetzt. **Noch zugängliche Funktionen:** Nur-Lese-Zugriff auf den Data Room (begrenzt), Galerie (nur Anzeigen). **Benachrichtigungen:** E-Mail an Eigentümer, Kontoverwalter und alle Beteiligten. *** ### Stufe 5: OVERDUE\_30\_DAYS **Auslöser:** Die Zahlung ist seit 30 Tagen überfällig. **Einschränkungen:** * Alle Einschränkungen aus Stufe 4 bleiben in Kraft. * Weitere Zugriffsbeschränkungen werden für die verbleibenden zugänglichen Funktionen angewendet. **Benachrichtigungen:** E-Mail an Eigentümer, Kontoverwalter und alle Beteiligten. *** ### Stufe 6: PRE\_ARCHIVE\_7\_DAYS **Auslöser:** 7 Tage vor dem Archivierungsstichtag (typischerweise Tag 53 des überfälligen Zeitraums). **Einschränkungen:** * Alle Einschränkungen aus Stufe 5 bleiben in Kraft. * Ein **auffälliges Warnbanner** wird in der gesamten Gebäudeoberfläche angezeigt: > „Dieses Gebäude wird in 7 Tagen aufgrund von Nichtzahlung archiviert. Zahlen Sie jetzt, um den vollständigen Zugriff wiederherzustellen und die Datenarchivierung zu verhindern." Dies ist eine letzte Warnstufe, die Beteiligten 7 Tage Zeit gibt, zu handeln, bevor das Gebäude vollständig archiviert wird. **Benachrichtigungen:** E-Mail mit dringenden Nachrichten an Eigentümer, Kontoverwalter und alle Beteiligten. *** ### Stufe 7: PRE\_ARCHIVE\_3\_DAYS **Auslöser:** 3 Tage vor dem Archivierungsstichtag (typischerweise Tag 57 des überfälligen Zeitraums). **Einschränkungen:** * Alle Einschränkungen aus Stufe 6 bleiben in Kraft. * Warnbanner aktualisiert, um die verbleibenden 3 Tage anzuzeigen. **Benachrichtigungen:** E-Mail mit finalen dringenden Nachrichten an Eigentümer, Kontoverwalter und alle Beteiligten. *** ### Stufe 8: ARCHIVED **Auslöser:** Tag 60 des überfälligen Zeitraums. **Einschränkungen:** * **Alle Funktionen sind deaktiviert.** Das Gebäude ist vollständig archiviert. * Alle Zugriffe auf Data Room, BIM Viewer, Scan Viewer, Losteilung, Fluid Synoptic, Galerie, DTT-Minting, Rewards — alles ist unzugänglich. * Das Gebäude bleibt im Dashboard mit einem ARCHIVED-Status-Badge sichtbar, aber ein Klick darauf zeigt einen gesperrten Bildschirm. * **Inkassoverfahren eingeleitet.** Die ausstehende Rechnung wird einem Inkassoprozess übergeben. **Datenaufbewahrung:** Gebäudedaten werden aufbewahrt, sind aber unzugänglich. Daten werden nicht sofort gelöscht — wenden Sie sich an den Support, um Optionen zur Datenwiederbeschaffung zu besprechen. **Benachrichtigungen:** E-Mail an Eigentümer, Kontoverwalter und alle Beteiligten, die sie über die Archivierung informiert. *** ## Zusammenfassung der Einschränkungen nach Stufe | Stufe | Überfällige Tage | Minting | Upload/Validierung | BIM/Scan | Alle Funktionen | | --------------------- | ---------------- | ------------ | ------------------ | ------------ | -------------------- | | INVOICE\_FAILED | 0 | Verfügbar | Verfügbar | Verfügbar | Verfügbar | | OVERDUE\_3\_DAYS | 3 | **Gesperrt** | Verfügbar | Verfügbar | Verfügbar | | OVERDUE\_7\_DAYS | 7 | **Gesperrt** | **Gesperrt** | Verfügbar | Verfügbar | | OVERDUE\_14\_DAYS | 14 | **Gesperrt** | **Gesperrt** | **Gesperrt** | Verfügbar (begrenzt) | | OVERDUE\_30\_DAYS | 30 | **Gesperrt** | **Gesperrt** | **Gesperrt** | Begrenzt | | PRE\_ARCHIVE\_7\_DAYS | \~53 | **Gesperrt** | **Gesperrt** | **Gesperrt** | Minimal | | PRE\_ARCHIVE\_3\_DAYS | \~57 | **Gesperrt** | **Gesperrt** | **Gesperrt** | Minimal | | ARCHIVED | 60 | **Gesperrt** | **Gesperrt** | **Gesperrt** | **Alles gesperrt** | *** ## Zugriff wiederherstellen Um den vollständigen Zugriff in einer beliebigen Stufe vor ARCHIVED wiederherzustellen: 1. Navigieren Sie zum **Abonnementverwaltungs**-Bereich (auch während eines Zahlungsausfalls zugänglich). 2. Gehen Sie zur Registerkarte **Rechnungen**. 3. Klicken Sie auf die fehlgeschlagene Rechnung und aktualisieren oder bestätigen Sie Ihre Zahlungsmethode. 4. Schließen Sie die Zahlung ab. Sobald die Zahlung bestätigt ist: * Zugriffsbeschränkungen werden sofort entfernt (innerhalb von Minuten). * Das Status-Badge des Gebäudes kehrt zu **Active** zurück. * Alle gesperrten Funktionen werden wieder aktiviert. * Eine Bestätigungs-E-Mail wird an den Eigentümer und Kontoverwalter gesendet. > **Wichtig:** Die Lösung des Zahlungsproblems vor Tag 60 verhindert die Archivierung. Wenn das Gebäude bereits archiviert wurde (Stufe 8), wenden Sie sich an den Magma-Support, um Wiederherstellungsoptionen zu besprechen. *** ## E-Mail-Benachrichtigungen In jeder Eskalationsstufe werden E-Mail-Benachrichtigungen gesendet an: * **Gebäudeeigentümer** — Empfängt alle Benachrichtigungen in jeder Stufe. * **Kontoverwalter (KV)** — Empfängt alle Benachrichtigungen in jeder Stufe. * **Alle Beteiligten** — Empfangen Benachrichtigungen ab Stufe 2. Die eskalierte Dringlichkeit der E-Mails soll sicherstellen, dass mindestens eine verantwortliche Partei Kenntnis erhält und Maßnahmen ergreift, bevor die Archivierung erfolgt. *** ## Das canScanAccess-Flag Die Zugänglichkeit des Scan Viewers wird durch ein dediziertes Berechtigungs-Flag gesteuert: `canScanAccess`. Dieses Flag wird unabhängig von den allgemeinen Gebäudezugriffsberechtigungen verwaltet. * In Stufe 4 (OVERDUE\_14\_DAYS) wird `canScanAccess` für alle Beteiligten auf **false** gesetzt. * Wenn die Zahlung wiederhergestellt ist, wird `canScanAccess` für alle Beteiligten auf **true** zurückgesetzt. Dieses Flag gilt auch in anderen Kontexten — beispielsweise können bestimmte Beteiligtenrollen `canScanAccess` durch Gebäudeadministratoren auf false gesetzt haben, unabhängig vom Zahlungsstatus, wenn die Scandaten für ihre Rolle als sensibel angesehen werden. *** ## Tipps zur Vermeidung von Zahlungsausfällen * **Richten Sie automatische Abrechnung** mit einer gültigen gespeicherten Zahlungsmethode ein — dies ist die zuverlässigste Methode, um Zahlungsausfälle zu verhindern. * **Benennen Sie einen Kontoverwalter** mit Abrechnungsverantwortung, der Rechnungsbenachrichtigungen überwacht. * **Reagieren Sie auf INVOICE\_FAILED sofort** — das Beheben des Problems in Stufe 1 verhindert jegliche Funktionseinschränkungen und die Situation wird gelöst, bevor sie eskaliert. * **Vermeiden Sie die OVERDUE\_7\_DAYS-Stufe** — die Blockierung von Dokument-Upload und -Validierung in dieser Stufe bedeutet, dass Ihre Magma Index-Progression stoppt, Rewards nicht verdient werden können und der Workflow Ihres Teams gestört wird. * **Lassen Sie ein Gebäude niemals den ARCHIVED-Status erreichen** — die Datenwiederbeschaffung aus einem archivierten Gebäude erfordert Support-Intervention und kann zusätzliche Wiederherstellungsverfahren beinhalten. --- # 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/payment-failure.md?ask= ``` 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.