# App-Konzept

In VARIO Cloud bilden Apps das zentrale **Fundament für individuelle Erweiterungen, branchenspezifische Anpassungen und Anbindungen zu Drittsystemen**. Sie laufen unabhängig vom ERP-Kern und können separat entwickelt, installiert und betrieben werden – bei voller Kontrolle über Releasezyklen und Updateverhalten.

Die besondere Stärke: Du kannst die Funktionalität Deines Systems flexibel erweitern, **ohne Sonderprogrammierungen** vorzunehmen. Stattdessen nutzt Du die Möglichkeiten von Workflows, Importskripting, konfigurierbaren Exporten und App-spezifischen Erweiterungen, um Prozesse ganz nach Deinen Anforderungen abzubilden.

## Vorteile des App-Systems

### Technische Vorteile

| Vorteil                   | Bedeutung                                                                |
| ------------------------- | ------------------------------------------------------------------------ |
| **Eigene Datenmodelle**   | Apps bringen eigene Tabellen, Felder und Strukturen mit                  |
| **Technologiefreiheit**   | Entwicklung in beliebiger Sprache                                        |
| **Performance-Isolation** | Kein Einfluss auf das ERP-System durch separate Infrastruktur            |
| **Unabhängige Upgrades**  | Apps können jederzeit aktualisiert werden, auch während des ERP-Betriebs |
| **Eigene Releasezyklen**  | Neue Funktionen losgelöst vom ERP-Releaseplan möglich                    |

### Strategische Vorteile

| Vorteil                     | Bedeutung                                                         |
| --------------------------- | ----------------------------------------------------------------- |
| **Time-to-Market**          | Schnelle Umsetzung individueller Anforderungen ohne ERP-Anpassung |
| **Kompetenzpool erweitern** | Kunden, Partner, Agenturen können eigene Lösungen beisteuern      |
| **Flexible Bepreisung**     | Apps können separat angeboten oder bepreist werden                |

## Wie funktionieren Apps?

Apps sind eigenständige Anwendungen und werden auf einer separaten Infrastruktur betrieben und integrieren sich über standardisierte Schnittstellen ins ERP-System. Jede App ist in einem sogenannten **App-Manifest** definiert, das alle relevanten Metadaten und Rechte enthält.

### Das App-Manifest

Das **App-Manifest** ist eine statische Datei, die jede App eindeutig beschreibt:

| Enthaltene Informationen                          |
| ------------------------------------------------- |
| Name, Version, Herausgeber                        |
| Beschreibung, UI-Integrationen                    |
| Berechtigungen (z. B. Datenzugriffe)              |
| Integrationspunkte (Dialoge, Verkaufskanäle etc.) |
| Technische Anforderungen                          |

#### Wo sehe ich das App-Manifest?

* Im **ERP** unter:

  **System → Apps → \<App-Name** >
* Alternativ über Entwickler-Tools beim Öffnen des **App-Stores im Admin-Center:**
  * **F12 öffnen → Netzwerk → appsAvailable → Preview**

### Auf welche Daten darf die App zugreifen?

* Der Entwickler definiert den Zugriff im Manifest
* Jede App bringt eine eigene Benutzerrolle mit
* Zugriffe erfolgen ausschließlich auf genehmigte Endpunkte

## Rollen & Zuständigkeiten

| Frage                                    | Antwort                                                                     |
| ---------------------------------------- | --------------------------------------------------------------------------- |
| **Wer ist Besitzer einer App?**          | Der Entwickler, der sie erstellt                                            |
| **Wer ist verantwortlich für Funktion?** | <p>Technisch: Entwickler<br>Qualität: VARIO (Zertifizierung, Framework)</p> |
| **Wer darf Apps veröffentlichen?**       | Nur ernannte Entwickler, nach einem Review-Prozess                          |
| **Wer darf private Apps nutzen?**        | Alle Nutzer mit entsprechender Lizenz, ohne öffentliche Zertifizierung      |

## Installation & Verwaltung

### Wo installiere ich eine App?

Im App-Store im **Admin-Center**, auf der Ebene einer **Installation** im **Reiter Apps**.

Eine **Anleitung** zur **Installation** und **Deinstallation** von Apps, sowie Informationen zu **Integrationen** und **Berechtigungen** erhältst Du auf unserer [**Handbuchseite zum Bereich System/Apps**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/system/apps/)**.**

### Was passiert bei der Installation?

| Aktion                                  | Bedeutung                                                  |
| --------------------------------------- | ---------------------------------------------------------- |
| Lizenz wird erteilt                     | Gültige Nutzung für die Installation                       |
| App-User und Rolle werden angelegt      | Definierte Rechte für API-Zugriff                          |
| Zugriffsschlüssel (Token) wird erstellt | Authentifizierung über Offline-Token                       |
| Migrationen im ERP                      | Anpassung von Strukturen und Daten im ERP-System           |
| Migrationen in der App                  | Initiale Datenstruktur und Konfiguration in der App selbst |

Jede App erhält ihre eigenen Berechtigungen und Rollen.

Über diese kannst Du steuern, welche Benutzer mit der App arbeiten dürfen.

[Hier findest du die Einstellungen zu Benutzerrechten.](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/einstellungen/allgemein/#Gruppen-und-Rollen)

## Besondere Funktionen & Hinweise

| Symbol / Begriff      | Bedeutung                                                     |
| --------------------- | ------------------------------------------------------------- |
| **App-Badge**         | Sichtbarkeit der App in Dialogen, URLs und Meldungen          |
| **App-Benutzer**      | Wird automatisch erstellt, dient der Kommunikation ERP → App  |
| **Benutzerrollen**    | Steuern Sichtbarkeit und Nutzbarkeit                          |
| **Offline-Token**     | Authentifizierung der App gegen die API                       |
| **VQL-Abfragen**      | Zugriff auf ERP-Daten per App-spezifischem Query-Format       |
| **Logs / Protokolle** | Transparente Analyse aller App-Aktivitäten direkt im Frontend |
| **Skripte**           | App-seitige Datenmanipulation via VQL und JSON                |

## Analyse & Individualisierung

Apps liefern im Bereich [**System/Apps**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/system/apps/#Protokolle-und-Logging) umfangreiche Diagnose- und Individualisierungsmöglichkeiten:

* **Reiter Datenabfragen:** VQL-Abfragen einsehen und bearbeiten
* **Reiter Protokolle:** Logs nach Request-ID, Status oder Log-Level filtern
* **Reiter Skripte:** Anpassung der übermittelten Daten an externe Systeme über eigene Skripte

### Hilfreiche Detailinformationen

Über die Logs kannst Du bei Problemen schnell nachvollziehen, ob z. B. ein Fehler in der App, im ERP oder in einem externen System aufgetreten ist.

## Erweiterungsmöglichkeiten durch Apps

* **API-Zugriff auf die gesamte Anwendung**

  Apps können über standardisierte Schnittstellen auf nahezu alle ERP-Daten und Funktionen zugreifen – authentifiziert, gesichert und rollenbasiert.

  #### Anwendungsbeispiel

  Eine App erstellt tagesaktuelle Verkaufsberichte, greift auf Auftragsdaten, Kundengruppen und Lagerbestände zu und übermittelt die Auswertung automatisch an ein BI-Tool wie Power BI oder Excel.
* **Webhook-Abonnements für Event-getriebene Automatisierung**

  Apps können sich auf bestimmte **Ereignisse (Events)** im ERP „abonnieren“ – z. B. Auftragsfreigabe, Zahlungseingang oder neue Artikel. Über **Webhooks** werden diese Ereignisse in Echtzeit an die App gemeldet, die dann definierte Aktionen ausführt.

  #### Anwendungsbeispiel

  Nach dem Versand eines Pakets wird ein Webhook ausgelöst, der automatisch die Sendungsnummer an den Kunden per E-Mail verschickt und den Status im ERP aktualisiert.
* **Individuelle Erweiterung der Oberfläche**

  Apps können das **Frontend (UI)** des ERP gezielt erweitern: durch eigene Menüpunkte, Dialog-Erweiterungen oder neue Tabs innerhalb bestehender Masken.

  #### Anwendungsbeispiel

  Ein Großhändler erweitert die Kundenakte um ein Tab „Umsatzentwicklung“, das direkt Charts zur Kaufhistorie anzeigt – bereitgestellt von einer App, die diese Daten regelmäßig aufbereitet.
* **Eigene Datenmodelle und Strukturen**

  Apps bringen bei Bedarf eigene Tabellen, Felder oder ganze Datenmodelle mit – vollständig integriert, aber getrennt vom ERP-Kern.

  #### Anwendungsbeispiel

  Eine App für Leasinggeschäfte speichert Vertragslaufzeiten, Raten und Gerätetypen in eigenen Datenfeldern und verknüpft diese mit den regulären Kunden- und Artikelstammdaten im ERP.
* **Dynamische Benutzerrechte und Rollenkonzepte**

  Apps definieren eigene **Benutzerrollen**, über die sich gezielt steuern lässt, welche Funktionen sichtbar und nutzbar sind.

  #### Anwendungsbeispiel

  Ein externer Logistikdienstleister bekommt über eine App Zugriff auf bestimmte Lieferdaten – aber keinen Zugang zu Preisen oder Kundendaten im ERP.
* **Analyse, Monitoring und Protokollierung**

  Jede App kann ihre Aktivitäten detailliert protokollieren – inklusive Request-IDs, Fehleranalyse und Statusübersichten.

  #### Anwendungsbeispiel

  Eine App zur Exportkontrolle dokumentiert jeden API-Aufruf, kennzeichnet potenziell kritische Waren automatisch und archiviert alle Prüfungen revisionssicher.
* **Migrationen zur strukturierten Erweiterung des Datenmodells**

  Bei der Installation können Apps **Migrationen** durchführen – also gezielte Erweiterungen am ERP-Datenmodell, z. B. durch neue Felder, Tabellen oder Einstellungen.

  #### Anwendungsbeispiel

  Eine App für das Vertragsmanagement ergänzt die Kundenmaske automatisch um Felder für Laufzeit, Status und Kündigungsfristen – alles ohne manuelle Einrichtung.

## FAQ – Häufig gestellte Fragen

<details>

<summary>Wer darf Apps installieren?</summary>

Nur berechtigte Benutzer im Admin-Center. Es wird unterschieden zwischen:

* **Öffentlichen Apps:** über den VARIO App Store erhältlich, mit Zertifizierung
* **Privaten (Inhouse-)Apps:** individuell entwickelbar, keine Zertifizierung notwendig

</details>

<details>

<summary>Wer ist für eine App verantwortlich?</summary>

* **Der Entwickler**, der die App erstellt hat, ist für deren Funktion verantwortlich.
* **VARIO** prüft öffentliche Apps vor Freigabe (Zertifizierung) und stellt das Framework bereit.
* Der App-Kern bleibt in der Verantwortung des Entwicklers.

</details>

<details>

<summary>Können eigene Apps entwickelt werden?</summary>

Ja! Auch Kunden oder Agenturen können eigene Apps schreiben, ohne dass diese veröffentlicht werden. Dafür gelten bestimmte technische Einschränkungen.

</details>

<details>

<summary>Welche Daten kann eine App lesen oder schreiben?</summary>

Das bestimmt das **App-Manifest**. Nur die dort beantragten Berechtigungen werden bei der Installation vergeben.

</details>

<details>

<summary>Können User berechtigt werden, eine App zu nutzen?</summary>

Ja. Über die Benutzerrollen, die die App bei der Installation mitbringt.

</details>

<details>

<summary>Wo laufen die Apps?</summary>

Apps laufen isoliert vom ERP, auch auf separater Hardware, sodass die Performance des ERP-Kerns nicht durch die App beeinträchtigt wird.

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.vario-software.de/vario-cloud-handbuch/grundlagen-and-konzepte/app-konzept.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
