Skip to main content

​
Buchungsebenen

Diese Tools helfen dir, Buchungsebenen (layer_uuid) zu finden, Snapshots anzulegen und Ebenen-Gruppen für Reports zu verwalten.

​
Verfügbare Tools

​
Ebenen & Snapshots

  • list_layers
  • create_snapshot_layers

​
Ebenen-Gruppen

  • list_layer_groups
  • create_layer_group
  • delete_layer_group

​
Scope

Buchungsebenen und Gruppen gehören zu Gesellschaften (companyUuid). Rufe list_companies auf, um die passende companyUuid zu wählen.

​
Ebenen auflisten (list_layers)

  1. list_companies → companyUuid wählen
  2. list_layers mit optionalem companyUuid-Filter
  3. Merke dir layer_uuid, layer_type, is_default, is_forecast und is_locked
Typische Quell-Ebenen für Snapshots sind Ebenen mit is_default: true und layer_type ungleich snapshot (z. B. Import, Manuell).

​
Snapshot erstellen (create_snapshot_layers)

Erstellt pro Gesellschaft mit aggregierten Werten eine neue gesperrte Snapshot-Ebene. Werte aus mehreren Quell-Ebenen werden je Gesellschaft zusammengeführt. Parameter:
  • companyUuids — mindestens eine Gesellschaft
  • sourceLayerUuids — mindestens eine Quell-Ebene (UUIDs aus list_layers)
  • periodRange — optional { from: "YYYY-MM", to: "YYYY-MM" }; weglassen oder null für alle Perioden mit Daten
Beispiel — alle Perioden:
Beispiel — Periodenbereich:
Antwort: created_count und created_layers mit layer_uuid, name und company_uuid pro angelegtem Snapshot. Hinweise:
  • Snapshots werden immer gesperrt erstellt und können nicht per MCP überschrieben werden.
  • Wenn keine Werte für die gewählten Quell-Ebenen und den Periodenbereich existieren, schlägt der Aufruf fehl.

​
Ebenen-Gruppen

Gruppen sind benannte Sets von layer_uuid-Mitgliedern pro Gesellschaft. Nutze sie in resolve_report:
  • Standard: selectedLayerGroupUuids
  • Rolling Forecast: pro Slice in periodSlices[].selectedLayerGroupUuids
  • Vergleich: pro Seite in compareSides.sideA / sideB als selectedLayerGroupUuids
  1. list_layer_groups — vorhandene Gruppen anzeigen
  2. create_layer_group — neue Gruppe mit companyUuid, name und layerUuids
  3. delete_layer_group — Gruppe entfernen (Mitglieder bleiben als einzelne Ebenen erhalten)
Zum Umbenennen oder Ändern der Mitglieder: Gruppe löschen und neu anlegen.

​
Empfohlener Ablauf

  1. list_companies
  2. list_layers (optional gefiltert nach companyUuid)
  3. Default- oder gewünschte Quell-Ebenen als sourceLayerUuids wählen
  4. create_snapshot_layers aufrufen
  5. list_layers erneut — neue Einträge mit layer_type: snapshot und is_locked: true
  6. Optional: Snapshot oder Forecast-Ebene in resolve_report nutzen (Standard, Rolling Forecast oder Vergleich — siehe Berichte)

​
Typische Anwendungsfälle

  • Monatsabschluss einfrieren, bevor neue Importe oder Planwerte kommen
  • Businessplan oder Forecast-Stand als gesperrte Referenzebene sichern
  • Mehrere Quell-Ebenen (Import + Manuell) in einem Snapshot zusammenführen