--- title: Mandantenwechsel und gespeicherte Amparex-Setups — isla Studio url: https://isla-stud.io/es/docs/wp2amparex/mandantenwechsel-und-setups/ date: 2026-05-30 --- # Mandantenwechsel und gespeicherte Amparex-Setups Mandantenwechsel und gespeicherte Amparex-Setups ================================================ > Diese Seite erklärt, welche WP2Amparex-Einstellungen an einen verbundenen > Amparex-Mandanten gebunden sind und was beim Wechsel der Zugangsdaten > passiert. --- Status ------ Filial- und Beraterbilder sind seit `2.3.0` mandantenbezogen gespeichert. Seit `2.4.0` gilt das auch fuer Terminkategorien und Terminlogik. Die manuelle Reihenfolge von Filialen und Berater:innen wird ebenfalls mandantenbezogen gespeichert. Wenn Ihre Installation den Abschnitt **Gespeicherte Amparex-Setups** noch nicht zeigt, ist die installierte Version noch zu alt oder der entsprechende Release wurde noch nicht eingespielt. Warum gibt es gespeicherte Setups? ---------------------------------- WP2Amparex kann in einer Installation mit unterschiedlichen Amparex-Zugängen verbunden werden. Das passiert zum Beispiel: - auf einer internen Testinstallation; - bei Kund:innen mit mehreren Websites und unterschiedlichen Amparex-Mandanten; - wenn ein technischer API-Benutzer ausgetauscht wird; - wenn ein Mandant vorübergehend gewechselt und später wieder verbunden wird. Ohne mandantenbezogene Speicherung würden Einstellungen wie Terminkategorien oder Bilder beim Wechsel überschrieben oder müssten neu gepflegt werden. Was wird pro Amparex-Setup gespeichert? --------------------------------------- Mandantenbezogen gespeichert werden: - angezeigte Terminkategorien; - Reihenfolge der Terminkategorien; - interne Kategorie-Texte; - angezeigte Kategorie-Bezeichnungen; - Kategorie-Icons; - Tagesbeginn im Terminkalender; - Tagesende im Terminkalender; - die Option **Beraterschritte deaktivieren**; - Filialbilder; - Beraterbilder; - Reihenfolge der Filialen im Frontend; - Reihenfolge der Berater:innen im Frontend. Global bleiben weiterhin: - Design-Grundwerte; - E-Mail-Texte und Signatur; - Lizenzstatus und Lizenzschlüssel; - allgemeine Plugin-Optionen; - Support- und Debug-Einstellungen. Woran erkennt WP2Amparex ein Setup? ----------------------------------- WP2Amparex bildet interne Mandanten-Namespaces aus der Amparex-API-URL und allen aktuell verfügbaren stabilen Mandantenkennungen aus den Amparex-Filialdaten. Der Namespace basiert bewusst nicht nur auf dem technischen API-Benutzernamen. Wenn ein Mandant also neue technische Zugangsdaten erhält, bleiben mandantenbezogene Einstellungen erhalten, solange weiterhin dasselbe Amparex-System mit derselben Mandantenkennung verbunden ist. Als Mandantenkennungen werden, je nach Verfügbarkeit, unter anderem diese Amparex-Daten berücksichtigt: 1. Umsatzsteuer-ID (`vatNumber`) 2. Handelsregisterdaten 3. Steuernummer 4. Buchungsmandant (`bookMandator`) 5. Firmenname (`name1`) 6. ID der Hauptfiliale Wenn Amparex später eine zusätzliche, höher priorisierte Kennung liefert, bleibt ein bereits befülltes Setup desselben Mandanten aktiv. So erzeugt zum Beispiel eine nachträglich gepflegte Umsatzsteuer-ID keinen leeren Neustart, wenn bereits ein Setup auf Basis der weiterhin gelieferten Steuernummer existiert. Verhalten beim Mandantenwechsel ------------------------------- Wenn ein anderer Amparex-Mandant verbunden wird: - WP2Amparex lädt dessen eigenes Kategorie-, Terminlogik-, Bild- und Reihenfolge-Setup. - Gibt es für diesen Mandanten noch kein Setup, starten die mandantenbezogenen Bereiche leer bzw. mit den normalen Fallbacks. - Die Einstellungen des vorherigen Mandanten bleiben gespeichert. - Beim Zurückwechseln auf den vorherigen Mandanten werden dessen Kategorien, Terminlogik, Bilder und Reihenfolgen wiederhergestellt. - Gibt es mehrere gespeicherte Namespaces, die nachweislich zu den aktuell gelieferten Kennungen desselben Mandanten gehören, kann das gewünschte Setup mit **Setup verwenden** ausgewählt werden. Bestehende globale Kategorie-Einstellungen aus älteren Versionen werden beim ersten erkannten Mandanten einmalig diesem Setup zugeordnet. Dadurch gehen vorhandene Kategorie-Konfigurationen beim Update nicht verloren. Alte Setups löschen ------------------- Im Settings Center gibt es den Abschnitt **Gespeicherte Amparex-Setups**. Dort zeigt WP2Amparex: - den erkannten Setup-Namen; - ob es das aktuell aktive Setup ist; - den internen Namespace; - die Kennungsart, aus der der Namespace berechnet wurde, zum Beispiel **USt-ID** oder **Steuernummer**; - wie viele Kategorien, Filialbilder, Beraterbilder, Filialpositionen und Beraterpositionen gespeichert sind; - welcher Tagesbeginn, welches Tagesende und welcher Beraterschritt-Status zum Setup gehören; - wann das Setup zuletzt erkannt wurde. Bei inaktiven Setups desselben aktuell verbundenen Mandanten erscheint **Setup verwenden**. Setups eines anderen API-Systems oder Mandanten können nicht auf diesem Weg aktiviert werden. Der API-Benutzername und die API-URL stehen im API-Bereich direkt oberhalb der Setup-Verwaltung. Sie werden nicht pro Setup dupliziert: Die Zugangsdaten sind global, nicht Bestandteil des mandantenbezogenen Daten-Setups. Insbesondere die vollständige Amparex-Alias-URL kann sensible Verbindungsinformation enthalten und wird deshalb nicht zusätzlich in der Setup-Historie gespeichert. Mit **Setup löschen** können nicht mehr benötigte Setups entfernt werden. Vor dem Löschen fragt WP2Amparex noch einmal nach. Gelöscht werden nur mandantenbezogene Daten dieses Setups: - Terminkategorien; - Tagesbeginn und Tagesende im Terminkalender; - die Option **Beraterschritte deaktivieren**; - Filialbilder; - Beraterbilder; - Filial- und Beraterreihenfolgen; - der Registry-Eintrag des Setups. Nicht gelöscht werden: - Amparex-Zugangsdaten des aktuell gespeicherten Plugins; - Lizenzdaten; - E-Mail-Texte; - Design; - Buchungsdaten; - andere Mandanten-Setups. Empfehlung für Testinstallationen --------------------------------- Für zentrale Testinstallationen ist der Ablauf: 1. Mandant A verbinden. 2. Kategorien, Terminlogik, Bilder und Reihenfolgen prüfen oder pflegen. 3. Einstellungen speichern. 4. Mandant B verbinden. 5. Kategorien, Terminlogik, Bilder und Reihenfolgen für Mandant B pflegen. 6. Zurück zu Mandant A wechseln. 7. Prüfen, ob Kategorien, Terminlogik, Bilder und Reihenfolgen von Mandant A wieder erscheinen. Wenn viele Testmandanten ausprobiert wurden, können veraltete Setups im Abschnitt **Gespeicherte Amparex-Setups** aufgeräumt werden. Technische Referenz -------------------