Apps & connections
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
Melde dich in Lexware Office an.
Öffne dort die Einstellungen für die Public API.
Erzeuge einen neuen API-Schlüssel für die ONE LOOP Integration.
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.
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
Öffne den gewünschten ONE LOOP Standort.
Öffne die installierte App Lexware Office.
Wähle Lexware Office verbinden.
Füge den API-Schlüssel ohne zusätzliche Leerzeichen ein.
Speichere die Verbindung.
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:
Wurde die gewünschte Action gestartet?
Wurde das Dokument im verbundenen Lexware-Office-Konto angelegt?
Ist das PDF am richtigen Kontakt gespeichert?
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.
Erzeuge in Lexware Office einen neuen Schlüssel.
Öffne im betroffenen ONE LOOP Standort die App-Seite.
Wähle API-Schlüssel ersetzen.
Speichere den neuen Schlüssel.
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.