Zum Inhalt
ONE LOOP / Dokumentation / Apps & Verbindungen

Apps & Verbindungen

Lexware Office verbinden

Die Verbindung wird über einen API-Schlüssel hergestellt und gilt ausschließlich für den aktuellen ONE LOOP Standort.

Die Verbindung wird über einen API-Schlüssel hergestellt und gilt ausschließlich für den aktuellen ONE LOOP Standort. Sie ist die Grundlage für alle Dokument-Actions und Trigger der App.

Eine installierte App ohne bestätigte Verbindung kann noch keine Rechnung erzeugen und auch keine Zahlung oder Angebotsänderung aus Lexware Office übernehmen.

Bevor du beginnst

Du brauchst:

  • Zugriff auf den richtigen ONE LOOP Standort,

  • Zugriff auf das Lexware-Office-Konto, das mit diesem Standort verbunden werden soll,

  • die Berechtigung, dort einen API-Schlüssel für die Integration zu erzeugen,

  • eine Person, die den Schlüssel bei Bedarf sicher ersetzen kann.

Hinweis:

Verwende für jeden ONE LOOP Standort die Verbindung des passenden Fachkontos. So bleiben Kundendaten, Dokumente und Ereignisse eindeutig getrennt.

API-Schlüssel in Lexware Office erstellen

  1. Melde dich in Lexware Office an.

  2. Öffne dort die Einstellungen für die Public API.

  3. Erzeuge einen neuen API-Schlüssel für die ONE LOOP Integration.

  4. Kopiere den Schlüssel sofort an einen sicheren Ort, um ihn direkt auf der App-Seite einzufügen. Er wird später möglicherweise nicht mehr vollständig angezeigt.

  5. Gib den Schlüssel nicht in E-Mails, Notizen, Workflow-Felder oder Screenshots weiter.

Der Schlüssel ist der Zugang der App zu diesem Fachkonto. Behandle ihn deshalb wie ein Passwort.

Verbindung in ONE LOOP speichern

  1. Öffne den gewünschten ONE LOOP Standort.

  2. Öffne die installierte App Lexware Office.

  3. Wähle Lexware Office verbinden.

  4. Füge den API-Schlüssel ohne zusätzliche Leerzeichen ein.

  5. Speichere die Verbindung.

  6. Warte auf die Bestätigung Lexware Office wurde sicher verbunden.

Erst wenn diese Bestätigung angezeigt wird, ist die Verbindung einsatzbereit. Plane danach einen kleinen Testworkflow ein; der Verbindungsstatus bestätigt den Zugang, ein Test prüft zusätzlich deinen konkreten Ablauf.

Verbindung sinnvoll testen

Erstelle einen einfachen Testworkflow mit klaren, neuen Daten. Prüfe danach:

  1. Wurde die gewünschte Action gestartet?

  2. Wurde das Dokument im verbundenen Lexware-Office-Konto angelegt?

  3. Ist das PDF am richtigen Kontakt gespeichert?

  4. Enthält die Workflow-Ausgabe Dokumentnummer, Betrag und Link?

So erkennst du frühzeitig, ob du versehentlich den falschen Standort, das falsche Fachkonto oder eine falsche Workflow-Variable verwendest.

API-Schlüssel ersetzen

Ersetze den Schlüssel, wenn er abläuft, widerrufen wurde oder eine zuständige Person wechselt.

  1. Erzeuge in Lexware Office einen neuen Schlüssel.

  2. Öffne im betroffenen ONE LOOP Standort die App-Seite.

  3. Wähle API-Schlüssel ersetzen.

  4. Speichere den neuen Schlüssel.

  5. Führe einen kleinen Testworkflow aus.

Der alte Schlüssel wird ersetzt. Bestehende Workflows müssen nicht neu gebaut werden, weil sie weiter dieselbe App-Verbindung verwenden.

Verbindung entfernen

Verbindung entfernen sperrt neue Aufrufe an Lexware Office aus diesem ONE LOOP Standort. Bereits erzeugte Dokumente im Kontakt und in Lexware Office bleiben bestehen; historische Ausführungen bleiben nachvollziehbar.

Entferne eine Verbindung erst, nachdem du geprüft hast, ob noch produktive Workflows diese App verwenden.

Häufige Ursachen bei Problemen

Beobachtung

Zuerst prüfen

Verbindung wird nicht bestätigt

Schlüssel vollständig und ohne Leerzeichen eingefügt, nicht widerrufen, richtiges Fachkonto

App ist verbunden, aber der Workflow scheitert

richtiger ONE LOOP Standort, notwendige Kontakt- und Positionsdaten, verwendete Workflow-Variable

Dokument erscheint im falschen Fachkonto

Verbindung im aktuellen Standort und verwendete Testdaten prüfen

Nach Schlüsselwechsel funktioniert ein Workflow nicht

neuen Schlüssel speichern, App-Seite neu laden und einen neuen Testvorgang auslösen

Nach Deinstallation und Neuinstallation

Die Neuinstallation erstellt eine neue Verbindung. Öffne die App im richtigen Standort, hinterlege den vorhandenen passenden Lexware-API-Schlüssel erneut privat und prüfe „Verbunden“. Lexware verwendet einen API-Schlüssel, keine neu anzulegende OAuth-Verbindung.

Alte Workflow-Trigger werden durch eine Deinstallation entfernt. Wähle beide benötigten Trigger im Workflow neu aus, prüfe ihre Filter und die darauf bezogenen Bedingungen/Variablen, speichere und veröffentliche den Workflow. Bloßes erneutes Speichern alter Triggerknoten hat im geprüften Ablauf keine neue Registrierung erzeugt.

← Zur Artikelübersicht