> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md).

# Apps

Erweitere VARIO Cloud mit Apps und verwalte Webhooks, Migrationen, Skripte, Datenabfragen, Protokolle und Berechtigungen zentral im System.

In der VARIO Cloud ermöglichen Apps eine **nahtlose Erweiterung Deiner ERP-Umgebung** – flexibel, konfigurierbar und ohne tiefgreifende Sonderprogrammierung. Mit wenigen Klicks installierst Du neue Funktionen, bindest Drittsysteme an oder schaffst branchenspezifische Erweiterungen.

Du findest sowohl von uns entwickelte Apps als auch Apps von zertifizierten Entwicklern in unserem [VARIO App-Store](https://app-store.vario-software.de/).

Die Verwaltung (Installation und Deinstallation) erfolgt direkt im Admin-Center auf Ebene Deiner ERP-Installation. Hier findest du auch Deine von Dir entwickelten [Private Apps](https://developer.vario-software.de/documentation/apps/introduction).

{% hint style="info" %}
**Eigene Apps entwickeln – App-Schulung**

Du möchtest eigene Apps entwickeln, zum Beispiel eine Private App für Dein Unternehmen? Unsere **kostenpflichtige VARIO Cloud App-Schulung** bietet Dir einen Einstieg in die App-Entwicklung, die API und die Integration in VARIO Cloud. [Informationen und Anmeldung](https://vario.webinargeek.com/vario-cloud-app-schulung?cst=handbuch).
{% endhint %}

## Detailansicht von Apps unter „System“

Nach der Installation im Admin-Center erscheint die App zusätzlich in Deiner VARIO Cloud unter dem Menüpunkt **System → Apps**:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FlRa5IgWDjCP4gxKGFx1z%2Fimage.png?alt=media&amp;token=ceb83a77-52a8-4e35-b6db-1ea4869ed270" alt=""><figcaption></figcaption></figure>

Per Klick auf den Eintrag öffnet sich die **Detailansicht der App**, welche Informationen zur App, **Webhooks** und **Migrationen** liefert, sowie, je nach App, weitere Möglichkeiten bietet, wie beispielsweise individuelle **Datenabfragen** oder **Skripte** zu bearbeiten und **Protokolle** einzusehen.

### Stammdaten

Hier siehst Du neben der **Bezeichnung** und **Beschreibung** der App die aktuelle **Version** und je nach App ggf. weitere Informationen, die die App mitbringt. Im unteren Bereich werden die **Zusatzfelder** angezeigt die in **Einstellungen → Allgemein →** [**Zusatzfelder**](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-allgemein/zusatzfelder.md) zu Apps zugeordnet wurden.

**Versionsangaben für Supportfälle:** Öffne die betroffene App unter **System → Apps →** {App} **→ Stammdaten**. Halte neben der **Version** auch die angezeigten Zusatzangaben **„Build-Version“**, **„Build-Zeitpunkt“** und **„Letzter Commit“** bereit. Diese Felder sind schreibgeschützt und erscheinen, wenn beim Öffnen Build-Informationen geladen werden konnten. Damit lässt sich der angezeigte App-Stand genauer zuordnen.

### Webhooks (ERP und App)

**ERP-Webhooks** sind Benachrichtigungen, die automatisch ausgelöst werden, wenn im ERP **bestimmte Ereignisse eintreten** (z. B. neue Bestellung, Statuswechsel).

Apps können sich auf diese Events **„abonnieren“** und bei Eintreten eine Benachrichtigung erhalten. Anschließend kann die App eine beliebige Aktion durchführen z. B. Daten an ein Drittsystem senden. Im Bereich **Webhook Queue** findest Du Details zu Status, Versanddatum, Anzahl der Versuche und erhaltenen Antworten.

{% hint style="info" %}
Beispiel: Eine App löst beim Abschluss eines Auftrags automatisch einen Export an ein Logistiksystem aus.
{% endhint %}

#### Webhooks manuell registrieren und deregistrieren

In **System → Apps →** {App} **→ ERP-Webhooks** öffnest Du per Rechtsklick auf einen Eintrag der Tabelle **„Webhooks“** das Kontextmenü:

* **Aktive Webhooks:** Mit **»Webhook deregistrieren«** meldest Du den Webhook ab. Vorher bestätigst Du den Dialog „Möchtest Du den Webhook … wirklich deregistrieren? Er erhält danach keine Nachrichten mehr.“ mit **»Deregistrieren«**. Danach erscheint die Meldung „Der Webhook wurde deregistriert.“
* **Alle anderen Webhooks** (Entfernt, Deaktiviert, Widerrufen): Mit **»Webhook registrieren«** registrierst Du den Webhook erneut. Danach erscheint die Meldung „Der Webhook wurde registriert.“

Nach der Aktion laden die Tabellen neu.

Der Reiter **»App-Webhooks«** ist nur bei Apps der VARIO Software AG sichtbar.

### Migrationen (ERP und App)

**Migrationen** sind strukturierte Änderungen an Datenmodellen oder Systemkonfigurationen, die bei der App-Installation oder bei Updates automatisch durchgeführt werden.

* **ERP-Migrationen:** z. B. Anpassung von Freifeldern, Workflows oder Importvorlagen im Backend.
* **App-Migrationen:** Interne Strukturen innerhalb der App selbst. Diese sind nur bei Apps der VARIO Software AG sichtbar.

Im [**Support-Modus**](https://help.vario-software.de/support/melden-von-problemen-in-vario-cloud) können ERP-Migrationen erneut ausgeführt werden, z. B. bei Einspielen eines Backups, in welchem die App noch nicht installiert war oder bei unerwarteten Vorfällen bei der Erstinstallation einer App:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FA4ZdezjE4rTlUZnhDLrP%2Fimage.png?alt=media&amp;token=b13a3ca7-aa8a-4cd8-bcdb-b6127988d3ae" alt=""><figcaption></figcaption></figure>

### Skripte

Apps können **Skripte** nutzen, um Daten vor der Übertragung individuell anzupassen. Du kannst diese Skripte hier einsehen und bearbeiten, sofern Du in Deiner Installation über eine **Skripting-Lizenz** verfügst.

{% hint style="info" %}
Um die Skriptausführung beispielsweise in unserer Shopware 6-App zu aktivieren, musst Du den gleichnamigen Toggle im Bereich **Einstellungen → Verkaufskanäle** im Reiter »Stammdaten« aktivieren.
{% endhint %}

### Datenabfragen

Apps (z. B. bei unserer Shopware 6 App) können **VQL-Abfragen (VARIO Query Language)** nutzen, um gezielt Daten aus dem ERP zu selektieren und weiterzuverarbeiten. Du kannst ausgewählte **Abfragen** hier einsehen, kopieren und auch individuell anpassen.

Per Klick auf einen Eintrag siehst Du die entsprechende **Selektion** und kannst Dir diese beispielsweise im Menüpunkt [**Freie VQL**](https://help.vario-software.de/vario-cloud-handbuch/auswertungen/freie-vql.md) anschauen und nachprüfen, welche Daten durch die App selektiert werden.

Du kannst diese Selektionen jederzeit auf den von uns ausgelieferten **Standard zurücksetzen** oder **Individualisierungen** in der Datenabfrage vornehmen und diese hier **speichern**.

### Protokolle und Logging

Im Reiter **»Protokolle«** findest Du die von der App protokollierten Meldungen, zum Beispiel zu API-Anfragen. Welche Meldungen entstehen, hängt von der App und dem aktiven Log-Level ab.

### Benutzerrechte erforderlich

{% hint style="info" %}
Die Protokollrechte vergibst Du für die jeweilige App in den [Benutzerrollen](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-allgemein/benutzer-gruppen-and-rollen.md#bereich-benutzerrollen). Die Rechte haben unterschiedliche Aufgaben:

| Recht                | Was Du damit tun kannst                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| **Logs einsehen**    | Protokolle anzeigen und filtern, Einträge öffnen und die Einträge eines Requests herunterladen.    |
| **Logging anpassen** | Das aktive Log-Level ändern, Protokolleinträge löschen und das automatische Löschen konfigurieren. |

Vergib zum Ändern der Einstellungen zusätzlich **»Logs einsehen«**, damit der Benutzer die Protokollansicht und die aktuellen Einstellungen aufrufen kann. **»Logging anpassen«** erlaubt keine Änderung des Inhalts bereits gespeicherter Protokolleinträge.
{% endhint %}

Hier kannst Du auch das **Log-Level** konfigurieren und danach filtern:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FoHZ6YWLXgGycauhvJok5%2Fimage.png?alt=media&amp;token=811f515e-7d6e-4250-90de-ee184e3badce" alt=""><figcaption></figcaption></figure>

* **ERROR**: Fehler (Standardeinstellung)
* **WARNING**: Zusätzlich Warnungen
* **INFO**: Zusätzlich Informationsmeldungen
* **DEBUG**: Zusätzlich detaillierte Debug-Meldungen

Über **„Aktives Log-Level“** legst Du fest, bis zu welcher Stufe die App Meldungen protokolliert. Für jede andere Stufe als ERROR setzt VARIO Cloud einen Rücksetzzeitpunkt am folgenden Tag. Beim nächsten Appzugriff nach diesem Zeitpunkt wechselt die Einstellung automatisch auf ERROR. Das Info-Symbol neben dem Feld zeigt Dir den vorgesehenen Zeitpunkt.

### Protokolle filtern <a href="#protokolle-filtern" id="protokolle-filtern"></a>

Über der Liste der Protokolle grenzt Du die Einträge mit diesen Filtern ein:

| Filter                                | Wirkung                                                                                                                                                                                                                     |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **RequestId**                         | Zeigt nur Einträge eines Requests.                                                                                                                                                                                          |
| **Modul**                             | Mehrfachauswahl aus **Middleware**, **ERP**, **Extern** und **Intern**. Extern steht für protokollierte Zugriffe der App auf Drittsysteme. Intern umfasst Einträge, die keiner der anderen drei Kategorien zugeordnet sind. |
| **Zeitpunkt von** / **Zeitpunkt bis** | Begrenzt die Einträge auf einen Zeitraum.                                                                                                                                                                                   |
| **Level**                             | Mehrfachauswahl aus **DEBUG**, **INFO**, **WARNING** und **ERROR**.                                                                                                                                                         |

Du kannst die Filter kombinieren. Ab drei Zeichen durchsucht das Suchfeld den Inhalt der Einträge.

### Protokolleinträge löschen <a href="#protokolleintrage-loschen" id="protokolleintrage-loschen"></a>

Hast Du das Recht, die Protokolle zu bearbeiten, findest Du in der Seitenleiste des Reiters **»Protokolle«** zwei Buttons:

* **»Einträge löschen«:** Öffnet den Dialog „Log-Einträge löschen“. Gib bei **„Zeitpunkt bis“** an, bis wann die Einträge gelöscht werden sollen, und wähle bei **„Level“** eine oder mehrere Stufen. Nach der Bestätigung erscheint eine Meldung mit der Anzahl der gelöschten Datensätze.
* **»Automatisches Löschen«:** Öffnet die Einstellungen für die regelmäßige Bereinigung. Aktiviere die Funktion und lege den Zeitplan sowie die Aufbewahrungsdauer je Level fest. Speichere Deine Angaben mit **»Speichern«**.

{% hint style="warning" %}
Die Filter der Protokollliste gelten beim Löschen nicht. Maßgeblich sind nur „Zeitpunkt bis“ und „Level“ im Löschdialog. Lässt Du beide Angaben leer, werden alle Protokolleinträge gelöscht. Gelöschte Einträge lassen sich in der Protokollansicht nicht wiederherstellen.
{% endhint %}

### Einsatz des Log-Levels „DEBUG“ im Supportfall

Das Log-Level **DEBUG** kannst Du zu Support- oder Analysezwecken aktivieren. Die App protokolliert dann zusätzlich detaillierte Meldungen, soweit diese in der App vorgesehen sind.

Das hilft Dir und dem VARIO Support, technische Probleme anhand der gespeicherten Meldungen zu untersuchen – etwa Schnittstellenabbrüche oder fehlerhafte Datenübertragungen.

Im Normalbetrieb empfehlen wir das Log-Level **ERROR**, damit nicht dauerhaft unnötig viele Einträge entstehen.

Klicke auf das Symbol in der Spalte **„RequestId“**, um die zugehörige Request-ID in den Filter zu übernehmen. So siehst Du die gespeicherten Einträge dieses Requests gemeinsam. Dafür ist **DEBUG** nicht erforderlich; die Anzeige richtet sich nach den bereits protokollierten Meldungen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FJvbNNBXET7Y4FoFOXB32%2Fimage.png?alt=media&amp;token=84959dd0-447b-40e4-8a31-7b6943eb8d58" alt=""><figcaption></figcaption></figure>

Wenn Du einen einzelnen Eintrag auswählst, öffnet sich die **Detailansicht**. Dort findest Du sämtliche Protokolldaten zum Log-Eintrag. Auf dieser Basis kannst Du Prozesse analysieren, Ursachen für unerwartetes Verhalten nachvollziehen und gezielt gegensteuern.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fh1t9yPMlFcx3rMTSqI6F%2Fimage.png?alt=media&amp;token=4bda1154-9f40-4f71-a1be-63f7ae7d9554" alt=""><figcaption></figcaption></figure>

In der Detailansicht stehen Dir weitere Funktionen zur Verfügung:

* **Zu anderen Einträgen des Requests springen:** Gehören mehrere Einträge zum selben Request, siehst Du sie links als Liste. Ein Klick auf einen Eintrag zeigt ihn direkt an, ohne die Detailansicht zu schließen. Die Liste lädt beim Scrollen weitere Einträge nach.
* **Als JSON anzeigen:** Enthält ein Eintrag ein JSON-Objekt oder ein JSON-Array, zeigt der Schalter **»Als JSON anzeigen«** den Inhalt im JSON-Editor strukturiert an. Schaltest Du ihn aus, erscheint der Inhalt als Text.
* **Herunterladen:** Der Button **»Herunterladen«** speichert die Protokolleinträge des Requests als HTML-Datei. Der Export umfasst höchstens 2.000 Einträge. Die Einträge sind chronologisch sortiert und lassen sich einzeln aufklappen.

{% hint style="info" %}
**Beispiel**

Du erhältst eine Fehlermeldung beim Export von Aufträgen an ein Drittsystem. Trage die zugehörige Request-ID im Filter ein, um die gespeicherten Meldungen dieses Requests im zeitlichen Zusammenhang zu prüfen. Sie können Dir Hinweise geben, ob die Ursache in der App, der ERP-Konfiguration oder dem Empfängersystem liegt.
{% endhint %}

## Benutzerberechtigungen der App

Nach der Installation einer App wird automatisch in Deiner VARIO Cloud ein App-Benutzer und eine Benutzerrolle für diese App unter **Einstellungen → Allgemein →** [**Benutzer, Gruppen & Rollen**](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-allgemein/benutzer-gruppen-and-rollen.md) angelegt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F928aBpyOAh8GYIQ38wnu%2Fimage.png?alt=media&amp;token=e3e5cdb8-c662-4be3-a62e-15e5fc00c37e" alt=""><figcaption></figcaption></figure>

Dieser Rolle sind, wie zuvor beschrieben, bei unseren selbst entwickelten Apps die Rechte zugewiesen, die notwendig sind, damit die von uns vorgesehenen Funktionen der App gewährleistet sind.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FHtSJLLW23FJ573cc5PPY%2Fimage.png?alt=media&amp;token=752fab0b-9618-40d6-9692-c1f344820903" alt=""><figcaption></figcaption></figure>

## Tipps zur Anwendung und Analyse

* Nutze die [**Webhook-Queue**](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md), um Fehler bei Integrationen schnell zu identifizieren.
* Überprüfe [**Migrationen**](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md), wenn nach Updates Datenfelder fehlen oder Masken nicht korrekt laden.
* Setze das [**Log-Level**](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md#protokolle-und-logging) temporär auf DEBUG, wenn Du komplexe Fehler nachvollziehen musst.
* Passe [**Datenabfragen**](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md#datenabfragen) individuell an ohne Sonderprogrammierung.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.vario-software.de/vario-cloud-handbuch/system/apps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
