> 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/marketplace-apps/lexware-office/erste-schritte/lexware-office-verbinden.md).

# Lexware Office verbinden

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.

{% hint style="info" %}
Verwende für jeden ONE LOOP Standort die Verbindung des passenden Fachkontos. So bleiben Kundendaten, Dokumente und Ereignisse eindeutig getrennt.
{% endhint %}

## 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               |