Einstieg & Orientierung
So funktionieren Marketplace Apps
Marketplace Apps erweitern ONE LOOP um Funktionen, die in spezialisierten Fachsystemen besser aufgehoben sind.
Marketplace Apps erweitern ONE LOOP um Funktionen, die in spezialisierten Fachsystemen besser aufgehoben sind. Sie verbinden einen konkreten ONE LOOP Standort mit dem jeweiligen Dienst und machen dessen Möglichkeiten in Workflows nutzbar.
Wie ONE LOOP externe Systeme über Integrationen, APIs und Webhooks mit dem Kundenprozess verbindet, zeigt die Integrationsseite von ONE LOOP.
Eine App ist nicht einfach nur ein zusätzlicher Menüpunkt. Sie besteht aus einer geschützten Verbindung, aus Actions für ausgehende Schritte, aus Triggern für eingehende Ereignisse und aus einer App-Seite für die Verwaltung.
Die vier Bausteine
1. Verbindung
Nach der Installation verbindest du dein Konto beim jeweiligen Fachsystem. Die Verbindung gilt nur für den aktuellen ONE LOOP Standort. Zugangsdaten werden geschützt gespeichert und erscheinen nicht als Klartext in Workflow-Ausgaben.
Prüfe vor dem ersten produktiven Workflow immer, ob der Verbindungsstatus bestätigt wurde. Eine installierte App allein bedeutet noch nicht, dass sie mit einem Fachkonto arbeiten kann.
2. Actions
Eine Action ist ein Schritt innerhalb eines Workflows. Sie bekommt Daten aus Kontakt, Trigger oder vorherigen Schritten und führt damit eine Aufgabe im Fachsystem aus.
Bei Lexware Office sind das beispielsweise Angebot, Auftragsbestätigung, Rechnung oder Gutschrift. Nach Erfolg liefert die Action neue Werte zurück, etwa Dokumentnummer, Status, Betrag und Datei-Link.
3. Trigger
Ein Trigger startet einen Workflow, wenn im Fachsystem etwas Relevantes passiert. Filter legen fest, welche Ereignisse verarbeitet werden.
Bei Lexware Office kann ein Workflow etwa bei einer Teil- oder Schlusszahlung oder bei einer Annahme eines Angebots starten. Die Triggerdaten stehen anschließend als Variablen für Bedingungen, Nachrichten und weitere Actions bereit.
4. App-Seite
Die App-Seite zeigt den Status der Verbindung. Dort verbindest du das Fachsystem, erneuerst den Zugang, ersetzt einen API-Schlüssel oder entfernst die Verbindung. Eine entfernte Verbindung sperrt neue Aufrufe; bereits erzeugte Dokumente bleiben nachvollziehbar.
Wie Daten durch einen Workflow fließen
Auslöser in ONE LOOP oder im Fachsystem
↓
Kontakt und Vorgang bestimmen den Kontext
↓
Dynamische Werte liefern Daten für die Action
↓
Die App prüft Verbindung und Pflichtdaten
↓
Das Fachsystem verarbeitet den Vorgang
↓
Ergebniswerte und Dokumente stehen im Workflow bereit
Felder mit Variablen-Symbol können Werte aus Formularen, Kontakten, Verkaufschancen, Kalenderbuchungen, Zahlungen oder früheren Actions verwenden. Wähle diese Werte über den Variablen-Picker, damit sie zur richtigen Action-Instanz und zum richtigen Workflow-Zweig gehören.
Was du vor der Aktivierung prüfen solltest
Ist die App im richtigen ONE LOOP Standort installiert?
Ist das richtige Fachkonto verbunden?
Sind die benötigten Kontakt-, Produkt- und Steuerdaten vorhanden?
Passt der Trigger wirklich zum fachlichen Anlass?
Ist klar, welche Ausgabevariablen ein Folgeschritt benötigt?
Wurde der gesamte Ablauf mit einem neuen Testvorgang geprüft?
Beispiel: Rechnung nach erfolgreicher Zahlung
Eine Zahlung löst deinen Workflow aus.
Die Rechnung-Action übernimmt die Transaktions-ID aus diesem Auslöser.
Die App verwendet die bezahlten Beträge und vorhandenen Steuerdaten.
Lexware Office erstellt die finale Rechnung.
Das offizielle PDF wird beim Kontakt abgelegt.
Die Workflow-Ausgabe liefert Rechnungsnummer, Betrag, Datei- und Dokumentlink.
Die ausführliche Anleitung dazu findest du unter Lexware Office für ONE LOOP.