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

# Umgebungen deiner Organisation

> Live, Sandbox und Migration im Vergleich. Sandbox oder Migrations-Umgebung anlegen, Abrechnung starten und Live-Umgebung anfragen.

Eine Sandbox nimmst du, wenn du etwas ausprobieren willst, zum Beispiel einen neuen Preisplan oder eine Anbindung über die API. Abrechnung und Webhooks laufen dort wie in der Live-Umgebung. E-Mails gehen aber nur an Mitglieder deiner Organisation und an Domains, die du freigibst.

Eine Migrations-Umgebung nimmst du für den Umzug aus einem anderen System. Sie verschickt keine E-Mails an deine Kunden und keine Webhooks, und sie rechnet erst ab, wenn du die Abrechnung selbst startest. So kannst du importierte Verträge und Rechnungen prüfen, ohne dass ein Kunde etwas davon mitbekommt.

Jede Umgebung hat eigene Daten, Einstellungen, Benutzer und API-Schlüssel. Nur der Plan und die freigeschalteten Funktionen gelten für die ganze Organisation.

## Die drei Arten von Umgebungen

| | Live | Sandbox | Migration |
| - | - | - | - |
| Zweck | Abrechnung deiner Kunden | Ausprobieren und Testen | Übernahme aus deinem bisherigen System |
| Anlegen | auf deine Anfrage über den [Go-Live](#go-live-aus-einer-sandbox-oder-migration) | du selbst, mit dem Recht „Umgebungen anlegen und löschen“ | du selbst, mit demselben Recht |
| Höchstzahl je Organisation | entfällt | zu Beginn 10 | zu Beginn 3 |
| E-Mails | an alle Empfänger | an Mitglieder deiner Organisation und an freigegebene Domains | nur Einladungen und E-Mails rund um die Anmeldung |
| Briefe und SMS | ja | nein | nein |
| Webhooks | ja | ja | nein |
| Seiten für deine Kunden | erreichbar | erreichbar, als Testseite gekennzeichnet | nicht erreichbar |
| Automatische Abrechnung | ja | ja | nein |
| Löschen | nicht möglich | einzelne Datenbereiche oder die ganze Umgebung | einzelne Datenbereiche oder die ganze Umgebung |

Ist in der Sandbox oder Migrations-Umgebung alles eingerichtet, [fragst du eine Live-Umgebung an](#go-live-aus-einer-sandbox-oder-migration) und [überträgst](https://docs.fynn.eu/guide/organisation/daten-uebertragen.md) Einstellungen, Katalog und weitere Daten dorthin. Die Sandbox bleibt daneben bestehen, sodass du dort weiter testen kannst.

Mehr dazu:

* [Versand in Sandbox und Migration](https://docs.fynn.eu/guide/notifications/environments-sending.md), mit der Freigabe von Empfänger-Domains für eine Sandbox
* [Daten zwischen Umgebungen übertragen](https://docs.fynn.eu/guide/organisation/daten-uebertragen.md), zum Beispiel den fertigen Katalog aus der Sandbox in die Live-Umgebung
* [Daten in Sandbox und Migration löschen](https://docs.fynn.eu/guide/tenant/delete-data.md) und [Sandbox oder Migrations-Umgebung löschen](https://docs.fynn.eu/guide/tenant/delete-environment.md)

## Zwischen Umgebungen wechseln

Du wechselst über den Namen der Umgebung oben links in der Seitenleiste. In der Liste stehen nur Umgebungen, in denen du ein Konto hast. Fehlt dir eine, lässt du dich dort [einladen](https://docs.fynn.eu/guide/tenant/users.md).

Nach dem Wechsel lädt die App neu und öffnet die Startseite der gewählten Umgebung. Deine anderen Tabs laden ebenfalls neu und zeigen kurz „Umgebung gewechselt“. Speichere offene Eingaben vor dem Wechsel, denn in einem Tab, der nicht neu geladen hat, lässt sich danach nichts mehr speichern.

## Sandbox oder Migrations-Umgebung anlegen

Klicke oben links auf den Namen der Umgebung. Unter deiner Organisation stehen **Sandbox anlegen** und **Migration anlegen**, jeweils mit der Zahl, die du noch anlegen kannst.

Wenn das nicht geht, hat es einen von zwei Gründen:

* **Der Eintrag fehlt.** Dir fehlt das Recht „Umgebungen anlegen und löschen“, oder das Anlegen dieser Art ist für deine Organisation noch nicht freigeschaltet. Die Rolle Administrator hat das Recht. Es reicht, wenn du es in irgendeiner Umgebung deiner Organisation hast.
* **Der Eintrag lässt sich nicht anklicken.** Die Höchstzahl ist erreicht. [Lösche](https://docs.fynn.eu/guide/tenant/delete-environment.md) eine Umgebung dieser Art, dann ist der Platz wieder frei.

In der neuen Umgebung hast zunächst nur du ein Konto, mit der Rolle Administrator. Kolleginnen und Kollegen [lädst du ein](https://docs.fynn.eu/guide/tenant/users.md) oder übernimmst sie mit dem Team aus einer anderen Umgebung. In einer neuen Sandbox ist das Test-Gateway schon eingeschaltet, in einer Migrations-Umgebung nicht.

### Regeln für die Kennung

Überlege dir die Kennung gut, denn nach dem Anlegen lässt sie sich nicht mehr ändern. Sie ist Teil der Adressen deiner API und deines Kundenportals.

Erlaubt sind 2 bis 63 Zeichen aus Kleinbuchstaben, Ziffern und Bindestrichen, am Anfang und am Ende ein Buchstabe oder eine Ziffer. Jede Kennung gibt es nur einmal, über alle Organisationen hinweg. Der Dialog kann deine Kennung also ablehnen, obwohl du sie selbst nie benutzt hast, und auch die Kennung einer gelöschten Umgebung bleibt vergeben. Reserviert sind außerdem einige Namen, etwa `app`, `login` oder alles, was `fynn` enthält.

### Daten beim Anlegen übernehmen

Du musst nicht mit einer leeren Umgebung anfangen. Schalte im Dialog **Daten übernehmen** ein, wähle eine andere Umgebung deiner Organisation als Quelle und die Datenbereiche, die du brauchst. Die Übertragung startet gleich nach dem Anlegen, ohne Vorschau.

Kunden kommen in eine Sandbox nur aus einer anderen Sandbox, damit keine echten Kundendaten in einer Testumgebung landen. Diese und alle weiteren Regeln stehen unter [Daten zwischen Umgebungen übertragen](https://docs.fynn.eu/guide/organisation/daten-uebertragen.md).

## Abrechnung ausführen

Eine Migrations-Umgebung rechnet nie von selbst ab. Willst du dort Rechnungen sehen, startest du die Abrechnung unter **Einstellungen > Umgebung** im Abschnitt **Abrechnung ausführen**. In einer Sandbox geht das genauso, wenn du nicht auf den nächsten automatischen Termin warten willst. Du brauchst die Rolle Administrator in dieser Umgebung.

Abgerechnet wird wie bei der automatischen Abrechnung: Fällige Verträge werden abgerechnet und die Rechnungen dazu erstellt.

Lässt du das Feld **Stichtag** leer, wird abgerechnet, was zum Zeitpunkt des Starts fällig ist. Mit einem Stichtag wird abgerechnet, was bis zum Ende dieses Tages fällig ist, gerechnet in der Zeitzone der Umgebung. Manche Umgebungen nehmen keinen Stichtag an und werden immer bis heute abgerechnet.

Je Umgebung läuft nur eine Abrechnung zur gleichen Zeit. Die nächste startest du, wenn die laufende beendet ist, und eine fehlgeschlagene startest du neu.

Aus einer Migrations-Umgebung erhalten deine Kunden auch dann keine Rechnungs-E-Mail. Für eine Sandbox gelten die [Versandregeln der Umgebung](https://docs.fynn.eu/guide/notifications/environments-sending.md).

In der Live-Umgebung gibt es den Abschnitt nicht.

## Go-Live aus einer Sandbox oder Migration

Bist du mit der Einrichtung fertig, fragst du auf der Seite **Go-Live** unter **Einrichtung** eine Live-Umgebung an. Das geht, sobald alle Punkte unter „Vor dem Go-Live“ erledigt sind und deine Rolle die Einstellungen der Umgebung ändern darf.

> [!WARNING]
>
> Fragst du die Live-Umgebung als Administrator aus einer Sandbox an, werden dabei Kunden, Rechnungen, Abos, Zahlungen, Webhooks, Bankverbindungen, Importe und Aktivitäten der Sandbox gelöscht. Produkte und Preispläne bleiben. Das lässt sich nicht rückgängig machen. In einer Migrations-Umgebung bleiben alle Daten erhalten.

Die Live-Umgebung ist nicht sofort da. Sie wird nach deiner Anfrage als neue Umgebung deiner Organisation angelegt, und ein Mitglied deiner Organisation erhält dort ein Konto mit der Rolle Administrator. Du siehst sie in der Liste deiner Umgebungen, sobald du dort ein Konto hast. Deine Sandbox oder Migrations-Umgebung bleibt bestehen.

Einstellungen, Katalog und weitere Daten aus der Sandbox [überträgst du](https://docs.fynn.eu/guide/organisation/daten-uebertragen.md) anschließend in der Live-Umgebung unter **Einstellungen > Übertragungen**.
