Integration · Administrator

Abacus-Integration konfigurieren

Anbindung des Abacus-Mandanten und der persönlichen Benutzerkonten

Produkt: echo for TeamsStand: Oktober 2026Version: 1.0

💡 Diese Anleitung ist für den PDF-Export optimiert. Drucken → „Als PDF speichern“, Hintergrundgrafiken aktivieren.

Übersicht

Diese Anleitung beschreibt die Konfiguration der Abacus-Integration in echo. Sie ist relevant, sobald Abacus während des Onboardings (Schritt 2 der Installationsanleitung) als Integration ausgewählt wurde. Die Einstellungen sind jederzeit unter Einstellungen → Abacus erreichbar.

Für die Anbindung sind zwei Verbindungen erforderlich:

Mandantenverbindung – organisationsweit, einmalig durch den Administrator.
Userverbindung – persönlich, durch jeden Benutzer mit seinem Abacus-Konto.

**Abb. 1:** Seite „Abacus“ mit Userverbindung (oben) und Mandantenverbindung (unten).

Mandantenverbindung (organisationsweit)

Diese Einstellungen werden für die Verbindung zu Ihrem Abacus-Mandanten verwendet und gelten für alle Benutzer in Ihrer Organisation. Tragen Sie die folgenden Verbindungsdetails ein:

Feld	Beschreibung
Abacus Mobile-ID (AmID)	Mobile-ID Ihres Abacus-Mandanten. Über Verbinden bestätigen oder per „Manuell eingeben“ erfassen.
Mandantennummer	Nummer des Abacus-Mandanten (z. B. `1234`).
API URL	Endpunkt der Abacus-API, z. B. `https://1234.demo.snapbean.ch`.
Client ID	ID der für echo hinterlegten Abacus-Anwendung (GUID).
Client Secret	Zugehöriger geheimer Schlüssel der Anwendung. Vertraulich behandeln.
Group-ID	Wird für die Anzeige von Serviceaufträgen/Tickets benötigt. Ist die Group-ID nicht bekannt, den Wert auf `0` belassen.

Speichern Sie die Eingaben anschliessend über Speichern.

**Abb. 2:** Felder der Mandantenverbindung. Über „Wo finde ich diese Informationen?“ erhalten Sie Hilfe zu den einzelnen Werten.

HinweisSind Sie unsicher, woher die Werte stammen, hilft der eingeblendete Link „Wo finde ich diese Informationen?“ direkt in echo weiter.

Userverbindung (pro Benutzer)

Zusätzlich zur Mandantenverbindung verbindet sich jeder Benutzer mit seinem persönlichen Abacus-Konto. Klicken Sie dazu auf „Verbindung hinzufügen“ und melden Sie sich mit dem Abacus-Benutzer an.

Stellen Sie sicher, dass der Abacus-Benutzer die erforderlichen API-Berechtigungen besitzt, um auf die Daten zuzugreifen. Diese Berechtigungen (API-Scopes) werden in der Abacus-Benutzerverwaltung (Programm O981) erteilt. Benötigt werden:

Subjekte lesen/schreiben
Verbindungen lesen/schreiben
Projekte lesen (optional)
Serviceaufträge lesen/schreiben (optional)
Kunden lesen (optional)
Immobilien lesen (optional)

Gut zu wissenDie als optional markierten Scopes werden nur für die jeweilige Funktion benötigt (z. B. Serviceaufträge lesen/schreiben für die Ticket-Anzeige). Fehlt ein optionaler Scope, bleibt lediglich die entsprechende Funktion eingeschränkt; die Grundverbindung funktioniert weiterhin.

Individuelle Reports mit AbaReport

Um individuelle Abacus-Reports im Caller-Cockpit anzuzeigen, konfigurieren Sie diese in Q948 AbaReport und fügen sie in den optionalen AbaReport-Einstellungen von echo hinzu. Zugangsdaten, Eingabeparameter und Darstellungsoptionen sind unter AbaReport konfigurieren beschrieben.