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

# Werte in Buchungsebenen hochladen

> Plan-, Forecast- und Modellwerte aus Excel oder Google Sheets in eine Buchungsebene schreiben

Mit dem Excel Add-in und dem Google Sheets Add-in kannst du Werte aus einer Tabelle in eine Buchungsebene in Fyvel schreiben. Das ist der Weg für Plan, Forecast oder andere modellierte Werte, die du im Spreadsheet pflegst und danach in Berichten nutzen willst.

Die Einrichtung der Add-ins steht auf [Excel & Google Addin](/documentation/working-with-fyvel/add-ins). Was Buchungsebenen sind und wie du sie in Berichten kombinierst, steht unter [Buchungsebenen & Snapshots](/documentation/working-with-fyvel/booking-layers-snapshots).

### Wann dieser Upload passt

* **Plan oder Forecast** — Monatsbeträge aus einem Modell in eine eigene Ebene schreiben und im Bericht neben den Ist-Daten auswählen.
* **Modellierte Ergänzungen** — Werte, die nicht aus der Buchhaltung stammen, getrennt von Import und eigenen Buchungen halten.
* **Erneutes Überschreiben** — Dieselbe Ebene später mit dem aktuellen Stand aus der Tabelle ersetzen.

Für einzelne Korrekturbuchungen mit Soll und Haben ist [Eigene Buchungen](/documentation/working-with-fyvel/manual-transactions) der passendere Weg. Die Vorlage **Manual Transactions** im Add-in gehört zu diesem anderen Upload und nicht zu den Werten einer Buchungsebene.

### Voraussetzungen

1. Das Add-in ist eingerichtet (E-Mail, Organisations-UUID, Add-in API Key).
2. In Fyvel gibt es eine **nicht gesperrte** Buchungsebene, in die geschrieben werden soll. Lege dafür unter Buchungsebenen eine Ebene vom Typ **Benutzerdefiniert** an. Snapshots sind gesperrt und nehmen keinen Upload an. Ebenen vom Typ **Statistik** lassen sich mit dieser Vorlage nicht befüllen.
3. Du hast die **Layer UUID** der Zielebene. Auf der Seite Buchungsebenen steht sie unter dem Namen; das Kopier-Symbol übernimmt sie in die Zwischenablage.
4. Die **Organisations-UUID** steht unter `Unternehmenseinstellungen > Allgemein`.

### Vorlage einfügen

In beiden Add-ins ist der Ablauf gleich. Öffne die Seitenleiste und den Bereich **Daten hochladen**.

1. Klicke auf **Template einfügen**.
2. Wähle **Layer Values**.
3. Das Add-in legt ein neues Blatt an, standardmäßig `fyvel-upload`. Gibt es den Namen schon, heißt das Blatt `fyvel-upload (2)` und so weiter.

Die Zelle A1 muss `FYVEL UPLOAD` bleiben. Daran erkennt das Add-in das Blatt.

### Blatt ausfüllen

| Zelle                      | Inhalt                                                    |
| -------------------------- | --------------------------------------------------------- |
| **Layer Name** (B3)        | Nur zur Orientierung in der Tabelle. Wird nicht gesendet. |
| **Organisation UUID** (B4) | Organisations-UUID aus den Unternehmenseinstellungen      |
| **Layer UUID** (B5)        | UUID der Ziel-Buchungsebene                               |

Zeile 7 beschreibt die Spalten. Ab Zeile 12 stehen die Datenzeilen. In Spalte A wählst du den Zeilentyp aus der Liste:

| Zeilentyp             | Was in **UUID / Number** (Spalte B) steht                        |
| --------------------- | ---------------------------------------------------------------- |
| **Category**          | UUID der Kategorie (auf der Kategorien-Seite kopierbar)          |
| **Reporting Section** | UUID des Reportingbereichs (auf der Reportingstruktur kopierbar) |
| **Account**           | UUID des Kontos                                                  |
| **Account Number**    | Kontonummer aus dem Kontenstamm, als ganze Zahl                  |

Pro Zeile gilt genau ein Zeilentyp. Die UUID oder Nummer muss in Fyvel zur Gesellschaft der Buchungsebene gehören.

**Cost Center** (Spalte C) ist optional. Wenn du sie füllst, trage die Kostenstellennummer als ganze Zahl ein. Eine leere Zelle bedeutet: ohne Kostenstelle.

**Period** (Zeile 9, ab Spalte E) ist der Monat der Wertespalte. Die erste Periode ist ein Datum, die folgenden Spalten rechnen jeweils einen Monat weiter. Du kannst das Startdatum ändern; die Folgemonate ziehen nach. Eine Wertespalte ohne Datum wird ignoriert, solange darunter keine Beträge stehen. Stehen Beträge in der Spalte, muss das Perioden-Datum gesetzt sein.

Beträge stehen ab Zeile 12 in den Spalten mit der Überschrift **Value** (standardmäßig E bis P, zwölf Monate). Leere Betragszellen werden übersprungen. Weitere Monate legst du rechts daneben an: Überschrift `Value` und ein Datum in der Periodenzeile.

Trage Beträge so ein, wie sie in einer GuV mit der üblichen Vorzeichen-Einstellung erscheinen sollen. In Bilanzzeilen gilt die umgekehrte Richtung.

### Daten senden

Klicke in der Seitenleiste auf **Daten senden**. Das Add-in liest jedes Blatt in der Arbeitsmappe, dessen A1 `FYVEL UPLOAD` oder `FYVEL MANUAL TRANSACTIONS UPLOAD` ist, und sendet sie nacheinander. Ein Blatt vom Typ Layer Values schreibt in die Buchungsebene aus Zelle B5.

<Warning>
  Der Upload **ersetzt** den kompletten Inhalt der Ziel-Buchungsebene. Alles, was nicht im Blatt steht, wird aus der Ebene entfernt. Schicke deshalb immer den vollständigen Stand, den die Ebene danach haben soll.
</Warning>

Nach dem Senden steht in der Seitenleiste, wie viele Zeilen aus wie vielen Blättern angekommen sind. Die Ebene kannst du danach in Berichten und in den Add-ins auswählen, auch als Forecast-Ebene im Rolling Forecast.

### Häufige Fehler

* **Kein Upload-Sheet gefunden** — A1 ist nicht exakt `FYVEL UPLOAD`.
* **Organisation UUID oder Layer UUID fehlt** — B4 oder B5 ist leer.
* **Layer is locked** — Die Ebene ist ein Snapshot oder anderweitig gesperrt.
* **UUID oder Kontonummer ungültig** — Der Eintrag existiert nicht in dieser Organisation bzw. nicht bei der Gesellschaft der Ebene.
* **Unbekannter Zeilentyp** — Spalte A enthält etwas anderes als Category, Reporting Section, Account oder Account Number.

***