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

# ADDITIVE Export Seitenreferenz

> Alle Felder der Komponente ADDITIVE Export: Zeitraum und Download der CSV-Dateien, automatischer monatlicher Versand per E-Mail sowie der Aufbau der Reservierungs- und der Personendatei.

Diese Seite dokumentiert alle Felder und Einstellungen der Komponente ADDITIVE Export. Du erreichst die Einstellungen im Mandant-Dashboard über **Allgemein** > **Komponenten** und einen Klick auf die Komponente ADDITIVE Export.

Die Komponente erstellt zwei CSV-Dateien im Importformat von ADDITIVE: eine Datei mit den Reservierungen eines Zeitraums und eine Datei mit den dazugehörigen Gästen.

## Allgemein

| Feld      | Gültige Werte        | Hinweise                                                                                                                                                    |
| --------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aktiv** | Ja, Nein             | Bei „Ja" ist die Komponente aktiv und der Export möglich. Bei „Nein" steht der Export nicht zur Verfügung. Pro Betrieb darf nur eine Komponente aktiv sein. |
| **Name**  | Freitext, nicht leer | Bezeichnung der Komponente in der Komponentenübersicht. Vorbelegt mit „ADDITIVE Export".                                                                    |

## Datenexport

| Feld                                            | Gültige Werte | Hinweise                                                                                                                     |
| ----------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Von**                                         | Datum         | Beginn des Exportzeitraums. Vorbelegt mit dem ersten Tag des Vormonats.                                                      |
| **Bis**                                         | Datum         | Ende des Exportzeitraums. Vorbelegt mit dem letzten Tag des Vormonats. Der gewählte Tag ist vollständig im Export enthalten. |
| **Personen exportieren** (Funktionsknopf)       | --            | Lädt die Personendatei als `additive-export-persons-JJJJ-MM-TT.csv` herunter.                                                |
| **Reservierungen exportieren** (Funktionsknopf) | --            | Lädt die Reservierungsdatei als `additive-export-reservations-JJJJ-MM-TT.csv` herunter.                                      |

## Automatischer Export

| Feld                      | Gültige Werte                             | Hinweise                                                                                                                                                                           |
| ------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Automatisch versenden** | Ja, Nein                                  | Bei „Ja" versendet ROOMS! am Anfang jedes Monats die Dateien des Vormonats per E-Mail. Standard ist „Nein".                                                                        |
| **E-Mail-Adressen**       | Eine oder mehrere gültige E-Mail-Adressen | Empfänger des automatischen Versands. Über **Eintrag hinzufügen** legst du eine weitere Adresse an, über **X** entfernst du einen Eintrag. Ohne Eintrag findet kein Versand statt. |
| **Zuletzt versendet für** | Anzeige im Format JJJJ-MM                 | Nur-Lese-Anzeige des zuletzt automatisch versendeten Monats. Erscheint erst nach dem ersten Versand.                                                                               |

## Abhängigkeiten

* Die Komponente setzt kein Modul voraus. Sie steht jedem Betrieb zur Verfügung, sobald sie angelegt und aktiv ist.
* **Personen exportieren** und **Reservierungen exportieren** sind deaktiviert, solange die Komponente noch nicht gespeichert wurde oder **Aktiv** auf „Nein" steht.
* **E-Mail-Adressen** wird nur angezeigt, wenn **Automatisch versenden** auf „Ja" steht.
* Pro Betrieb darf nur eine Komponente ADDITIVE Export aktiv sein. Beim Speichern einer zweiten aktiven Komponente erscheint eine Fehlermeldung.

## Funktionshinweise

* Exportiert werden alle aktiven Reservierungen des Betriebs mit zugeordnetem Gast, deren Erstellungs- oder letztes Änderungsdatum im gewählten Zeitraum liegt. Das Anreisedatum spielt für die Auswahl keine Rolle.
* Die Personendatei enthält genau die Gäste der exportierten Reservierungen. Die Spalte `person_id` der Reservierungsdatei verweist auf die Spalte `id` der Personendatei.
* Beide Dateien sind mit Semikolon getrennt. Beträge stehen in Euro mit Komma als Dezimaltrennzeichen (z. B. `1250,10`), Datumswerte im Format JJJJ-MM-TT, Zeitstempel im Format JJJJ-MM-TTTHH:MM:SS in UTC.
* Beim automatischen Versand heißen die Anhänge `<Betrieb>-reservations-JJJJ-MM.csv` und `<Betrieb>-persons-JJJJ-MM.csv`. Die E-Mail trägt den Betreff „ADDITIVE Export", der Name des Betriebs und der Zeitraum stehen im E-Mail-Text. Versendet wird in der Systembenachrichtigungssprache des Betriebs (Deutsch, Englisch oder Italienisch).
* Ein bereits versendeter Monat wird kein zweites Mal versendet. Maßgeblich ist der Wert unter **Zuletzt versendet für**.

### Reservierungsdatei

| Spalte             | Inhalt                                                                  |
| ------------------ | ----------------------------------------------------------------------- |
| `id`               | Buchungscode der Reservierung.                                          |
| `person_id`        | Gästenummer, verweist auf die Spalte `id` der Personendatei.            |
| `created_at`       | Zeitpunkt der Erstellung.                                               |
| `updated_at`       | Zeitpunkt der letzten Änderung. Ohne Änderung der Erstellungszeitpunkt. |
| `arrival`          | Frühestes Anreisedatum aller Zimmer der Reservierung.                   |
| `departure`        | Spätestes Abreisedatum aller Zimmer der Reservierung.                   |
| `status`           | `reservation`, `option`, `request` oder `cancelled`.                    |
| `adult_count`      | Anzahl der Erwachsenen über alle Zimmer.                                |
| `child_count`      | Anzahl der Kinder über alle Zimmer.                                     |
| `booking_channel`  | Buchungskanal beziehungsweise Vermittler der Reservierung.              |
| `revenue_services` | Summe der Zimmerumsätze in Euro.                                        |
| `revenue_extras`   | Summe der gebuchten Extras in Euro.                                     |

Die Werte der Spalte `status` bedeuten:

* `cancelled` -- die Reservierung oder der Aufenthalt wurde storniert.
* `request` -- die Reservierung ist eine Anfrage über REQUEST! (das Online-Anfrageformular).
* `option` -- ein Angebot wurde versendet oder der Aufenthalt ist noch nicht bestätigt.
* `reservation` -- alle übrigen, bestätigten Reservierungen.

Bei stornierten Reservierungen fließen alle Zimmer in Anreise, Abreise, Personenzahl und Umsatz ein. Bei allen anderen Reservierungen werden stornierte Zimmerzeilen nicht mitgerechnet.

### Personendatei

| Spalte             | Inhalt                                                                    |
| ------------------ | ------------------------------------------------------------------------- |
| `id`               | Gästenummer.                                                              |
| `updated_at`       | Zeitpunkt der letzten Änderung. Ohne Änderung der Erstellungszeitpunkt.   |
| `email`            | E-Mail-Adresse.                                                           |
| `given_name`       | Vorname.                                                                  |
| `family_name`      | Nachname.                                                                 |
| `gender`           | `m` für männlich, `f` für weiblich, sonst leer.                           |
| `salutation`       | Anrede.                                                                   |
| `birth_date`       | Geburtsdatum.                                                             |
| `language`         | Sprache des Gastes als ISO-Code. Leer, wenn keine Sprache hinterlegt ist. |
| `telephone`        | Telefonnummer. Ist keine hinterlegt, wird die Mobilnummer verwendet.      |
| `street_address`   | Straße und Hausnummer.                                                    |
| `postal_code`      | Postleitzahl.                                                             |
| `address_locality` | Ort.                                                                      |
| `address_province` | Provinz.                                                                  |
| `address_region`   | Bleibt immer leer. ROOMS! erfasst keine Region zum Gast.                  |
| `address_country`  | Ländercode des Wohnsitzes (ISO alpha-2).                                  |
| `nationality`      | Ländercode der Staatsbürgerschaft (ISO alpha-2).                          |
| `newsletter`       | `1` bei Zustimmung zum Newsletter, sonst `0`.                             |

## Aktionen

| Aktion                         | Beschreibung                                                                                        |
| ------------------------------ | --------------------------------------------------------------------------------------------------- |
| **Speichern**                  | Speichert die aktuellen Einstellungen. Die Komponente bleibt geöffnet.                              |
| **Speichern und schließen**    | Speichert die Einstellungen und schließt die Komponente. Du kehrst zur Komponentenübersicht zurück. |
| **Personen exportieren**       | Lädt die Personendatei für den eingestellten Zeitraum herunter.                                     |
| **Reservierungen exportieren** | Lädt die Reservierungsdatei für den eingestellten Zeitraum herunter.                                |

## Verwandte Artikel

* [ADDITIVE Export einrichten](./setup-additive-export) -- Voraussetzungen und Einrichtungsschritte
* [Komponentenübersicht Seitenreferenz](/de/mandants/components) -- Übersicht aller verfügbaren Komponenten
