> ## 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.

# Versand in Sandbox und Migration

> E-Mails, Briefe, SMS und Webhooks aus einer Sandbox und einer Migrations-Umgebung: Versand im Vergleich zur Live-Umgebung, Freigabe von Empfänger-Domains für eine Sandbox und die Liste der zurückgehaltenen Nachrichten.

Kommt eine E-Mail aus einer Sandbox oder Migrations-Umgebung nicht an, wurde sie zurückgehalten. Beide verschicken weniger als die Live-Umgebung, damit beim Testen und beim Umzug keine Rechnung, keine Mahnung und kein Webhook bei deinen Kunden ankommt. Jede zurückgehaltene Nachricht findest du unter **Einstellungen > Zurückgehaltene Nachrichten**.

## Versand im Vergleich

| | Live | Sandbox | Migration |
| - | - | - | - |
| E-Mails | ja | nur an Mitglieder deiner Organisation und an freigegebene Domains | nein |
| Einladungen und E-Mails rund um die Anmeldung | ja | ja | ja |
| Briefe | ja | nein, Briefe werden nicht gedruckt | nein |
| SMS | ja | nein | nein |
| Webhooks | ja | ja | nein |
| Zahlungsanbieter und Integrationen verbinden | ja | ja, Zahlungsanbieter nur im Testmodus | nein |
| Kundenportal, Checkout-, Angebots- und Zahlungslinks | erreichbar | erreichbar, als Testseite gekennzeichnet | nicht erreichbar |

## E-Mails aus einer Sandbox

Eine E-Mail aus einer Sandbox erreicht die Mitglieder deiner Organisation und jede Adresse unter einer Domain, die du für diese Sandbox freigegeben hast. Mitglieder sind alle, die einen aktiven Zugang zu mindestens einer Umgebung deiner Organisation haben und ihre E-Mail-Adresse bestätigt haben.

Jede Adresse in An, Cc und Bcc wird einzeln geprüft. Geht eine E-Mail an `buchhaltung@kunde.example` und in Kopie an deine Kollegin `kollegin@musterfirma.example`, erhält nur deine Kollegin sie, und die Adresse des Kunden steht danach in der Liste der zurückgehaltenen Nachrichten.

### Empfänger-Domains freigeben

Um E-Mails aus der Sandbox an weitere Adressen zu schicken, gibst du deren Domain frei. Öffne dafür in der Sandbox **Einstellungen > Umgebung** und trage die Domain im Abschnitt **Erlaubte Empfänger-Domains** ein. Dafür brauchst du eine Rolle, die den Bereich „Empfänger-Domains der Sandbox“ bearbeiten darf, zum Beispiel Administrator.

Die Freigabe gilt für alle Adressen unter der Domain und nur für diese Sandbox. Gibst du `musterfirma-gruppe.example` frei, erreicht eine Sandbox-E-Mail auch `einkauf@musterfirma-gruppe.example`. Eine Subdomain wie `rechnung.musterfirma-gruppe.example` braucht einen eigenen Eintrag. Du gibst bis zu 20 Domains frei, darunter auch solche, die nur zum Testen dienen. Domains von Mail-Anbietern wie `gmail.com`, `web.de` oder `gmx.de` lassen sich nicht freigeben, weil sie für alle Nutzer dieser Anbieter gelten würden.

Gib die Domain frei, bevor du die E-Mail auslöst. Zurückgehaltene E-Mails werden nicht nachträglich verschickt.

### Einladungen

Eine Einladung in dein Team erreicht die eingeladene Person immer, auch wenn ihre Adresse noch zu keinem Mitglied gehört. Aus einer Sandbox und aus einer Migrations-Umgebung verschickst du höchstens 50 Einladungen in 24 Stunden. Die Einladung trägt dort den Standardtext, auch wenn du die Vorlage angepasst hast.

## Zahlungsanbieter und Seiten für Kunden in einer Sandbox

Zahlungsanbieter verbindest du in einer Sandbox im Testmodus. Für Stripe hinterlegst du Testschlüssel oder verbindest ein Stripe-Konto im Testmodus, für PayPal schaltest du beim Speichern der Zugangsdaten den Sandbox-Modus von PayPal ein. Bei der Verbindung über die Anmeldung bei PayPal oder GoCardless meldest du dich in der Testumgebung des Anbieters an. Live-Schlüssel und Anmeldungen im Live-Betrieb eines Anbieters lehnt die Sandbox ab.

Kundenportal, Checkout-, Angebots- und Zahlungslinks einer Sandbox sind erreichbar. Sie tragen oben den Hinweis „Sandbox-Testseite. Zahlungen auf dieser Seite sind Testzahlungen.“

## Migrations-Umgebung

Aus einer Migrations-Umgebung geht nichts an deine Kunden: keine E-Mail, kein Brief, keine SMS und kein Webhook. Du arbeitest trotzdem wie gewohnt. Versendest du eine Rechnung, wird die Aktion ausgeführt, und die E-Mail steht danach in der Liste der zurückgehaltenen Nachrichten. Nur Aktionen, die ausschließlich nach außen wirken, lehnt die Umgebung ab, etwa die Testmail einer E-Mail-Vorlage.

Bei dir und deinem Team kommen Einladungen und die E-Mails rund um die Anmeldung an, also zum Zurücksetzen des Passworts, zum Bestätigen der E-Mail-Adresse und der Hinweis auf eine Anmeldung von einem neuen Gerät. Benachrichtigungen über fertige Berichte und Importe werden zurückgehalten. Den Stand siehst du in den Listen der Importe und Exporte.

Zahlungsanbieter, Integrationen wie CRM- und Warenwirtschaftssysteme, DATEV, Bankkonten, eine eigene E-Mail-Domain, Webhook-Endpunkte, einen eigenen Mailserver und einen eigenen Dateispeicher richtest du in der Live-Umgebung ein. In einer Migrations-Umgebung lassen sie sich nicht verbinden. Überweisung, SEPA-Lastschrift und Guthaben richtest du auch dort ein, weil dafür kein Anbieter verbunden wird.

Kundenportal, Checkout-, Angebots-, Zahlungs- und Bestelllinks einer Migrations-Umgebung zeigen deinen Kunden nur „Seite nicht erreichbar“ mit dem Logo und den rechtlichen Links deiner Organisation. PDFs deiner Angebote erzeugst du trotzdem.

> [!NOTE]
>
> Bindest du Kundenseiten über die Kunden-API oder das SDK ein, antworten diese Aufrufe in einer Migrations-Umgebung mit dem Status `403` und dem Typ `TENANT__CUSTOMER_PAGES_CLOSED`. `GET /public/portal/config` bleibt erreichbar und nennt im Feld `environment` den Wert `migration`, in einer Sandbox `sandbox` und in der Live-Umgebung `production`.

## Zurückgehaltene Nachrichten

Unter **Einstellungen > Zurückgehaltene Nachrichten** steht für jede nicht verschickte E-Mail, jeden Brief, jede SMS und jeden Webhook ein Eintrag je Empfänger, mit Kanal, Art der Nachricht, Betreff oder Dateiname, Zeitpunkt und Grund. Die Liste sehen alle, deren Rolle den Bereich „Unternehmen“ mindestens lesen darf.

| Grund | Bedeutung |
| - | - |
| Migrations-Umgebung | Eine Migrations-Umgebung verschickt nichts. |
| Empfänger nicht freigegeben | Die E-Mail aus einer Sandbox ging an eine Adresse, die keinem Mitglied gehört und unter keiner freigegebenen Domain liegt. |
| Kanal in der Sandbox geschlossen | Eine Sandbox nutzt diesen Kanal nicht, etwa SMS. |

Die Liste dient zum Nachsehen. Ein Eintrag wird nie nachträglich verschickt und nach 180 Tagen gelöscht.

## Testsysteme

Auf Testsystemen wie preview\.fynn.eu verschickt auch eine Live-Umgebung nach den Regeln einer Sandbox: E-Mails erreichen nur die Mitglieder deiner Organisation, Briefe werden nicht gedruckt und SMS nicht verschickt. Empfänger-Domains lassen sich für eine Live-Umgebung nicht freigeben.
