> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/so-funktionieren-marketplace-apps.md). # So funktionieren Marketplace Apps 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](https://one-loop.de/de/platform/integrations). 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 1. Ist die App im richtigen ONE LOOP Standort installiert? 2. Ist das richtige Fachkonto verbunden? 3. Sind die benötigten Kontakt-, Produkt- und Steuerdaten vorhanden? 4. Passt der Trigger wirklich zum fachlichen Anlass? 5. Ist klar, welche Ausgabevariablen ein Folgeschritt benötigt? 6. Wurde der gesamte Ablauf mit einem neuen Testvorgang geprüft? ## Beispiel: Rechnung nach erfolgreicher Zahlung 1. Eine Zahlung löst deinen Workflow aus. 2. Die Rechnung-Action übernimmt die Transaktions-ID aus diesem Auslöser. 3. Die App verwendet die bezahlten Beträge und vorhandenen Steuerdaten. 4. Lexware Office erstellt die finale Rechnung. 5. Das offizielle PDF wird beim Kontakt abgelegt. 6. Die Workflow-Ausgabe liefert Rechnungsnummer, Betrag, Datei- und Dokumentlink. Die ausführliche Anleitung dazu findest du unter [Lexware Office für ONE LOOP](https://one-loop.gitbook.io/help/documentation/lexware-office-fur-one-loop). --- # 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://one-loop.gitbook.io/help/so-funktionieren-marketplace-apps.md?ask=&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.