> 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/sevdesk/testinstallation-und-verbindung.md).

# Testinstallation und Verbindung

Teste die private sevdesk-App in einem abgegrenzten ONE LOOP Standort und prüfe die Kontoverbindung.

{% hint style="warning" %}
Diese Anleitung gilt für einen **privaten Test**. Die Verbindung zum sevdesk-Konto ist der erste Prüfschritt. Dokument-Actions, sevdesk-Trigger und Verbrauchsabrechnung sind noch nicht für den produktiven Einsatz freigegeben. Der Status **Verbunden** bestätigt den Kontozugang, nicht die Freigabe dieser Funktionen.
{% endhint %}

## Das brauchst du

* Einen abgegrenzten HighLevel-Teststandort, in dem du Apps installieren und als Standort-Administrator die App-Einstellungen öffnen darfst.
* Zugang zum passenden sevdesk-Testkonto mit aktivierter API und einen gültigen API-Token. Der Token besteht aus 32 Zeichen (Ziffern und Buchstaben a–f, Groß- und Kleinschreibung ist möglich).
* Testdaten, die eindeutig von echten Kunden- und Buchhaltungsdaten getrennt sind.

Verwende für jeden Standort das dazugehörige sevdesk-Konto. So bleiben Kontakte, Belege und spätere Ereignisse eindeutig zugeordnet.

## App im Teststandort installieren

1. Öffne im HighLevel Developer Marketplace bei der gewünschten privaten App-Version **Manage → Versions → Test Link**.
2. Trage die **Sub-Account ID des Teststandorts** ein. Die Agency-ID reicht dafür nicht aus.
3. Öffne den erzeugten Installationslink, während du im zugehörigen HighLevel-Testkonto angemeldet bist.
4. Prüfe die angezeigten App-Berechtigungen und Preisangaben. Schließe die Installation nur für den vorgesehenen Teststandort ab.
5. Öffne die installierte App im Standort unter den App-Einstellungen. Die Einstellungsseite heißt **Connect sevdesk**.

Wenn die App im Standort nicht erscheint, prüfe zuerst die Standort-ID im Testlink und ob du im richtigen HighLevel-Konto angemeldet bist.

## sevdesk-Testkonto verbinden

1. Erzeuge oder öffne den API-Token im **richtigen sevdesk-Testkonto**. Bewahre ihn wie ein Passwort auf und füge ihn weder in Workflows noch in E-Mails oder Screenshots ein.
2. Öffne in der installierten App **sevdesk verbinden**.
3. Füge den Token in das Feld **sevdesk API-Token** ein. Wähle **Steuerstatus deines Unternehmens** entsprechend dem Testkonto: Regelbesteuerung oder Kleinunternehmer nach § 19 UStG.
4. Wähle **Sicher verbinden**. Die App prüft den Zugang und die eindeutige Kontozuordnung, bevor sie die Verbindung verschlüsselt speichert.
5. Prüfe, ob die Seite **Verbunden** anzeigt. Kontrolliere zusätzlich im sevdesk-Testkonto, dass du den Token für genau dieses Konto erzeugt hast.

Die Auswahl zum Steuerstatus ist eine vorläufige Einrichtungsinformation. Die tatsächliche Steuerkonfiguration muss vor jedem späteren Dokumenttest separat in sevdesk geprüft werden. Die Kontoverbindung schaltet keine Dokument-Action frei. Nach dem Speichern wird der API-Token nicht wieder vollständig angezeigt.

## Ergebnis prüfen

Eine erfolgreiche Verbindung bedeutet: Die private App ist im richtigen Teststandort installiert, der Zugang zum vorgesehenen sevdesk-Konto wurde bestätigt und die Einstellungsseite zeigt **Verbunden**. Erst ein späterer gesonderter Funktionstest kann nachweisen, ob eine Rechnung, ein Angebot, eine Gutschrift oder ein Trigger fachlich korrekt arbeitet.

## Häufige Probleme

| Anzeige                                               | Prüfe zuerst                                                                             |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Nur Administratoren können Änderungen vornehmen**   | Mit einem Standort-Administrator im richtigen Teststandort öffnen.                       |
| **Der API-Token ist ungültig oder wurde deaktiviert** | Token im sevdesk-Testkonto erneuern und auf vollständige 32 Zeichen prüfen.              |
| **Sicherer Zugriff nicht möglich**                    | Die Seite aus der installierten App heraus neu öffnen; nicht als direkte URL im Browser. |
| **Die sichere Sitzung ist abgelaufen**                | App-Seite neu laden und Verbindung erneut starten.                                       |
| Verbindung bleibt unbestätigt                         | API-Zugang und die eindeutige Kontozuordnung des sevdesk-Testkontos prüfen.              |

Ein anderes sevdesk-Konto verbindest du erst, nachdem die bisherige Verbindung über **Verbindung trennen** vollständig entfernt wurde. Bereits erzeugte Belege im Fachsystem werden durch das Trennen nicht gelöscht.